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