cpython/Doc/lib/libgrp.tex

37 lines
1.1 KiB
TeX
Raw Normal View History

\section{\module{grp} ---
1999-03-02 12:37:17 -04:00
The group database}
1999-03-02 12:37:17 -04:00
\declaremodule{builtin}{grp}
\platform{Unix}
\modulesynopsis{The group database (\function{getgrnam()} and friends).}
1994-01-01 21:22:07 -04:00
1999-03-02 12:37:17 -04:00
1994-01-01 21:22:07 -04:00
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 \code{<grp.h>}), in order:
1994-01-01 21:22:07 -04:00
\code{gr_name},
\code{gr_passwd},
\code{gr_gid},
\code{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.)
1999-03-02 12:37:17 -04:00
\exception{KeyError} is raised if the entry asked for cannot be found.
1994-01-01 21:22:07 -04:00
It defines the following items:
\begin{funcdesc}{getgrgid}{gid}
Return the group database entry for the given numeric group ID.
\end{funcdesc}
\begin{funcdesc}{getgrnam}{name}
Return the group database entry for the given group name.
\end{funcdesc}
\begin{funcdesc}{getgrall}{}
1995-03-13 06:03:32 -04:00
Return a list of all available group entries, in arbitrary order.
1994-01-01 21:22:07 -04:00
\end{funcdesc}