Toggle navigation

spwd --- The shadow password database

spwd --- The shadow password database[UNKNOWN NODE transition]

This module provides access to the Unix shadow password database. It is available on various Unix versions.

You must have enough privileges to access the shadow password database (this usually means you have to be root).

Shadow password database entries are reported as a tuple-like object, whose attributes correspond to the members of the spwd structure (Attribute field below, see <shadow.h>):

IndexAttributeMeaning
0sp_nampLogin name
1sp_pwdpEncrypted password
2sp_lstchgDate of last change
3sp_minMinimal number of days between changes
4sp_maxMaximum number of days between changes
5sp_warnNumber of days before password expires to warn user about it
6sp_inactNumber of days after password expires until account is disabled
7sp_expireNumber of days since 1970-01-01 when account expires
8sp_flagReserved

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 PermissionError instead of KeyError if the user doesn't have privileges.

spwd.getspall()

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