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 [reset?]

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 [obj]

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 [reset?]

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 [obj]

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.

Go to the first, previous, next, last section, table of contents.