mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
73 lines
1.9 KiB
Text
73 lines
1.9 KiB
Text
|
.\" etc.doc - -*- 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.
|