Next: , Previous: Password Database Functions, Up: System Utilities


36.10 Group Database Functions

Octave's group database functions return information in a structure with the following fields.

name
The user name.
passwd
The encrypted password, if available.
gid
The numeric group id.
mem
The members of the group.

In the descriptions of the following functions, this data structure is referred to as a grp_struct.

— Built-in Function: grp_struct = getgrent ()

Return an entry from the group database, opening it if necessary. Once the end of data has been reached, getgrent returns 0.

— Built-in Function: grp_struct = getgrgid (gid).

Return the first entry from the group database with the group ID gid. If the group ID does not exist in the database, getgrgid returns 0.

— Built-in Function: grp_struct = getgrnam (name)

Return the first entry from the group database with the group name name. If the group name does not exist in the database, getgrnam returns 0.

— Built-in Function: setgrent ()

Return the internal pointer to the beginning of the group database.

— Built-in Function: endgrent ()

Close the group database.