Warning: This is the manual of the legacy Guile 2.2 series. You may want to read the manual of the current stable series instead.
Next: Time, Previous: File System, Up: POSIX [Contents][Index]
The facilities in this section provide an interface to the user and group database. They should be used with care since they are not reentrant.
The following functions accept an object representing user information and return a selected component:
The name of the userid.
The encrypted passwd.
The user id number.
The group id number.
The full name.
The home directory.
The login shell.
Look up an integer userid in the user database.
Look up a user name string in the user database.
Initializes a stream used by getpwent
to read from the user database.
The next use of getpwent
will return the first entry. The
return value is unspecified.
Read the next entry in the user database stream. The return is a
passwd user object as above, or #f
when no more entries.
Closes the stream used by getpwent
. The return value is unspecified.
If called with a true argument, initialize or reset the password data
stream. Otherwise, close the stream. The setpwent
and
endpwent
procedures are implemented on top of this.
Look up an entry in the user database. user can be an integer, a string, or omitted, giving the behaviour of getpwuid, getpwnam or getpwent respectively.
The following functions accept an object representing group information and return a selected component:
The group name.
The encrypted group password.
The group id number.
A list of userids which have this group as a supplementary group.
Look up an integer group id in the group database.
Look up a group name in the group database.
Initializes a stream used by getgrent
to read from the group database.
The next use of getgrent
will return the first entry.
The return value is unspecified.
Return the next entry in the group database, using the stream set by
setgrent
.
Closes the stream used by getgrent
.
The return value is unspecified.
If called with a true argument, initialize or reset the group data
stream. Otherwise, close the stream. The setgrent
and
endgrent
procedures are implemented on top of this.
Look up an entry in the group database. group can be an integer, a string, or omitted, giving the behaviour of getgrgid, getgrnam or getgrent respectively.
In addition to the accessor procedures for the user database, the following shortcut procedure is also available.
Return a string containing the name of the user logged in on
the controlling terminal of the process, or #f
if this
information cannot be obtained.
Next: Time, Previous: File System, Up: POSIX [Contents][Index]