mirror of https://github.com/python/cpython
69 lines
2.4 KiB
ReStructuredText
69 lines
2.4 KiB
ReStructuredText
:mod:`grp` --- The group database
|
|
=================================
|
|
|
|
.. module:: grp
|
|
:platform: Unix
|
|
:synopsis: The group database (getgrnam() and friends).
|
|
|
|
--------------
|
|
|
|
This module provides access to the Unix group database. It is available on all
|
|
Unix versions.
|
|
|
|
Group database entries are reported as a tuple-like object, whose attributes
|
|
correspond to the members of the ``group`` structure (Attribute field below, see
|
|
``<grp.h>``):
|
|
|
|
+-------+-----------+---------------------------------+
|
|
| Index | Attribute | Meaning |
|
|
+=======+===========+=================================+
|
|
| 0 | gr_name | the name of the group |
|
|
+-------+-----------+---------------------------------+
|
|
| 1 | gr_passwd | the (encrypted) group password; |
|
|
| | | often empty |
|
|
+-------+-----------+---------------------------------+
|
|
| 2 | gr_gid | the numerical group ID |
|
|
+-------+-----------+---------------------------------+
|
|
| 3 | gr_mem | all the group member's user |
|
|
| | | names |
|
|
+-------+-----------+---------------------------------+
|
|
|
|
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. Check both databases
|
|
to get complete membership information. Also note that a ``gr_name`` that
|
|
starts with a ``+`` or ``-`` is likely to be a YP/NIS reference and may not be
|
|
accessible via :func:`getgrnam` or :func:`getgrgid`.)
|
|
|
|
It defines the following items:
|
|
|
|
|
|
.. function:: getgrgid(gid)
|
|
|
|
Return the group database entry for the given numeric group ID. :exc:`KeyError`
|
|
is raised if the entry asked for cannot be found.
|
|
|
|
.. deprecated:: 3.6
|
|
Since Python 3.6 the support of non-integer arguments like floats or
|
|
strings in :func:`getgrgid` is deprecated.
|
|
|
|
.. function:: getgrnam(name)
|
|
|
|
Return the group database entry for the given group name. :exc:`KeyError` is
|
|
raised if the entry asked for cannot be found.
|
|
|
|
|
|
.. function:: getgrall()
|
|
|
|
Return a list of all available group entries, in arbitrary order.
|
|
|
|
|
|
.. seealso::
|
|
|
|
Module :mod:`pwd`
|
|
An interface to the user database, similar to this.
|
|
|
|
Module :mod:`spwd`
|
|
An interface to the shadow password database, similar to this.
|
|
|