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.

grp_struct = getgrent ()

Loadable Function

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

grp_struct = getgrgid (gid).

Loadable Function

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.

grp_struct = getgrnam (name)

Loadable Function

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

setgrent ()

Loadable Function

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

endgrent ()

Loadable Function

Close the group database.