8.4 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 they are in according to the password database.) A KeyError exception is raised if the entry asked for cannot be found.

It defines the following items:

getgrgid (gid)

Return the group database entry for the given numeric group ID.

getgrnam (name)

Return the group database entry for the given group name.

getgrall ()

Return a list of all available group entries, in arbitrary order.