Next: System Information, Previous: Password Database Functions, Up: System Utilities [Contents][Index]

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