spwd — The shadow password database¶
Deprecated since version 3.11, will be removed in version 3.13:Thespwd module is deprecated(seePEP 594 for details and alternatives).
This module provides access to the Unix shadow password database. It isavailable on various Unix versions.
Availability: not Emscripten, not WASI.
This module does not work or is not available on WebAssembly platformswasm32-emscripten andwasm32-wasi. SeeWebAssembly platforms for more information.
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.