GNU Info

(guile.info)User Information

---

Next: Time Prev: File System Up: POSIX

---

Enter node , (file) or (file)node

User Information
================

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:

`passwd:name'
     The name of the userid.

`passwd:passwd'
     The encrypted passwd.

`passwd:uid'
     The user id number.

`passwd:gid'
     The group id number.

`passwd:gecos'
     The full name.

`passwd:dir'
     The home directory.

`passwd:shell'
     The login shell.

 - procedure: getpwuid uid
     Look up an integer userid in the user database.

 - procedure: getpwnam name
     Look up a user name string in the user database.

 - procedure: setpwent
     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.

 - procedure: getpwent
     Return the next entry in the user database, using the stream set by
     `setpwent'.

 - procedure: endpwent
     Closes the stream used by `getpwent'.  The return value is
     unspecified.

 - primitive: setpw [arg]
     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.

 - primitive: getpw [user]
     Look up an entry in the user database.  OBJ 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:

`group:name'
     The group name.

`group:passwd'
     The encrypted group password.

`group:gid'
     The group id number.

`group:mem'
     A list of userids which have this group as a supplimentary group.

 - procedure: getgrgid gid
     Look up an integer groupid in the group database.

 - procedure: getgrnam name
     Look up a group name in the group database.

 - procedure: setgrent
     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.

 - procedure: getgrent
     Return the next entry in the group database, using the stream set
     by `setgrent'.

 - procedure: endgrent
     Closes the stream used by `getgrent'.  The return value is
     unspecified.

 - primitive: setgr [arg]
     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.

 - primitive: getgr [name]
     Look up an entry in the group database.  OBJ can be an integer, a
     string, or omitted, giving the behaviour of getgrgid, getgrnam or
     getgrent respectively.