Next: posix Prev: dbm Up: UNIX ONLY Top: Top

5.2. Built-in Module grp

This module provides access to the UNIX group database. It is available on all UNIX versions.

Group database entries are reported as 4-tuples containing the following items from the group database (see <grp.h>), in order: gr_name, gr_passwd, gr_gid, gr_mem. The gid is an integer, name and password are strings, and the member list is a list of strings. (Note that most users are not explicitly listed as members of the group(s) they are in.) An exception is raised if the entry asked for cannot be found.

It defines the following items:

getgrgid (gid) -- function of module grp
Return the group database entry for the given numeric group ID.
getgrnam (name) -- function of module grp
Return the group database entry for the given group name.
getgrall () -- function of module grp
Return a list of all available group entries entries, in arbitrary order.