1994-01-01 21:22:07 -04:00
|
|
|
\section{Built-in Module \sectcode{pwd}}
|
1997-07-17 13:34:52 -03:00
|
|
|
\label{module-pwd}
|
1994-01-01 21:22:07 -04:00
|
|
|
|
|
|
|
\bimodindex{pwd}
|
|
|
|
This module provides access to the \UNIX{} password database.
|
|
|
|
It is available on all \UNIX{} versions.
|
|
|
|
|
|
|
|
Password database entries are reported as 7-tuples containing the
|
|
|
|
following items from the password database (see \file{<pwd.h>}), in order:
|
|
|
|
\code{pw_name},
|
|
|
|
\code{pw_passwd},
|
|
|
|
\code{pw_uid},
|
|
|
|
\code{pw_gid},
|
|
|
|
\code{pw_gecos},
|
|
|
|
\code{pw_dir},
|
|
|
|
\code{pw_shell}.
|
|
|
|
The uid and gid items are integers, all others are strings.
|
1997-12-30 16:38:16 -04:00
|
|
|
A \code{KeyError} exception is raised if the entry asked for cannot be found.
|
1994-01-01 21:22:07 -04:00
|
|
|
|
|
|
|
It defines the following items:
|
|
|
|
|
1998-02-13 02:58:54 -04:00
|
|
|
\setindexsubitem{(in module pwd)}
|
1994-01-01 21:22:07 -04:00
|
|
|
\begin{funcdesc}{getpwuid}{uid}
|
|
|
|
Return the password database entry for the given numeric user ID.
|
|
|
|
\end{funcdesc}
|
|
|
|
|
|
|
|
\begin{funcdesc}{getpwnam}{name}
|
|
|
|
Return the password database entry for the given user name.
|
|
|
|
\end{funcdesc}
|
|
|
|
|
|
|
|
\begin{funcdesc}{getpwall}{}
|
|
|
|
Return a list of all available password database entries, in arbitrary order.
|
|
|
|
\end{funcdesc}
|