:mod:`!pwd` --- The password database

فهرست فصل‌ها دانلود آرشیوناشر

Python 3.14 Docs · نسخهٔ 3.14.10 · PSF License

:mod:!pwd --- The password database

:synopsis: The password database (getpwnam() and friends).

--------------

This module provides access to the Unix user account and password database. It is available on all Unix versions.

Password database entries are reported as a tuple-like object, whose attributes correspond to the members of the `passwd structure (Attribute field below, see <pwd.h>`):

+-------+---------------+-----------------------------+

IndexAttributeMeaning

+=======+===============+=============================+

0`pw_name`Login name

+-------+---------------+-----------------------------+

1`pw_passwd`Optional encrypted password

+-------+---------------+-----------------------------+

2`pw_uid`Numerical user ID

+-------+---------------+-----------------------------+

3`pw_gid`Numerical group ID

+-------+---------------+-----------------------------+

4`pw_gecos`User name or comment field

+-------+---------------+-----------------------------+

5`pw_dir`User home directory

+-------+---------------+-----------------------------+

6`pw_shell`User command interpreter

+-------+---------------+-----------------------------+

The uid and gid items are integers, all others are strings. KeyError is raised if the entry asked for cannot be found.

In traditional Unix the field `pw_passwd usually contains a password encrypted with a DES derived algorithm. However most modern unices use a so-called *shadow password* system. On those unices the *pw_passwd* field only contains an asterisk ('*') or the letter 'x' where the encrypted password is stored in a file /etc/shadow` which is not world readable. Whether the *pw_passwd* field contains anything useful is system-dependent.

It defines the following items:

Return the password database entry for the given numeric user ID.

Return the password database entry for the given user name.

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

Module grp An interface to the group database, similar to this.