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

### 34.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.

— Loadable 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.

— Loadable 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.

— Loadable 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.

— Loadable Function: setgrent ()

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

— Loadable Function: endgrent ()

> Close the group database.