spwd — The shadow password database¶
This module provides access to the Unix shadow password database. It isavailable on various Unix versions.
You must have enough privileges to access the shadow password database (thisusually means you have to be root).
Shadow password database entries are reported as a tuple-like object, whoseattributes correspond to the members of thespwd structure (Attribute fieldbelow, see<shadow.h>):
Index | Attribute | Meaning |
|---|---|---|
0 |
| Login name |
1 |
| Encrypted password |
2 |
| Date of last change |
3 |
| Minimal number of days betweenchanges |
4 |
| Maximum number of days betweenchanges |
5 |
| Number of days before passwordexpires to warn user about it |
6 |
| Number of days after passwordexpires until account isdisabled |
7 |
| Number of days since 1970-01-01when account expires |
8 |
| Reserved |
The sp_namp and sp_pwdp items are strings, all others are integers.KeyError is raised if the entry asked for cannot be found.
The following functions are defined:
spwd.getspnam(name)¶Return the shadow password database entry for the given user name.
Changed in version 3.6:Raises a
PermissionErrorinstead ofKeyErrorif the userdoesn’t have privileges.
spwd.getspall()¶Return a list of all available shadow password database entries, in arbitraryorder.