ruby/ext/etc/etc.txt

73 строки
1.9 KiB
Plaintext

.\" etc.txt - -*- Indented-Text -*- created at: Fri Jul 14 00:47:15 JST 1995
** Etc(Module)
The module to retrieve information under /etc directory. Available
only on UNIX platforms. All operations defined in this module are
module functions, so that you can include Etc module into your class.
Module Function:
getlogin
returns login name of the user. It this fails, try getpwuid().
getpwnam(name)
searches in /etc/passwd file (or equivalent database), and
returns password entry for the user. The return value is an
passwd structure, which has members described below.
struct passwd
name # user name(string)
passwd # encrypted password(string)
uid # user ID(integer)
gid # group ID(integer)
gecos # gecos field(string)
dir # home directory(string)
shell # login shell(string)
# members below are optional
change # password change time(integer)
quota # quota value(integer)
age # password age(integer)
class # user access class(string)
comment # comment(string)
expire # account expiration time(integer)
end
See getpwnam(3) for detail.
getpwuid([uid])
returns passwd entry for the specified user id. If uid is
ommitted, use the value from getuid(). See getpwuid(3) for
detail.
getgrgid(gid)
searches in /etc/group file (or equivalent database), and
returns group entry for the group id. The return value is an
group structure, which has members described below.
struct group
name # group name(string)
passwd # group password(string)
gid # group ID(integer)
mem # array of the group member names
end
See getgrgid(3) for detail.
getgrnam(name)
returns the group entry for the specified name. The return
value is the group structure. See getgrnam(3) for detail.
group
iterates over all group entries.
passwd
iterates over all passwd entries.