SHADOW(5) | File Formats and Configuration | SHADOW(5) |
NAME¶
shadow - shadowed password file
DESCRIPTION¶
shadow is a file which contains the password information for the system's accounts and optional aging information.
This file must not be readable by regular users if password security is to be maintained.
Each line of this file contains 9 fields, separated by colons (“:”), in the following order:
login name
encrypted password
If the password field begins with an exclamation mark !, the password is locked. The remaining characters on the line represent the password field before the password was locked.
Refer to crypt(3) for details on how this string is interpreted.
If the password field contains a string that is not a valid result of crypt(3), for instance ! or *, the user cannot use a UNIX password to log in. However, the user may log in the system by other means.
date of last password change
The value 0 indicates that the user must change their password the next time they log in to the system.
An empty field means that password aging features are disabled.
minimum password age
An empty field and value 0 mean that there is no minimum password age.
maximum password age
After this number of days has elapsed, the password may still be valid. The user is prompted to change their password at the next login.
An empty field means that there are no maximum password age, no password warning period, and no password inactivity period (see below).
If the maximum password age is lower than the minimum password age, the user cannot change her password.
password warning period
An empty field and value 0 mean that there is no password warning period.
password inactivity period
After the password expires and the password inactivity period elapses, the user cannot log in and must contact their administrator.
An empty string means that no inactivity period is enforced.
account expiration date
Note that account expiration differs from password expiration. Account expiration prevents the user from logging in, whereas password expiration only prevents users from logging in with their password.
An empty field means that the account never expires.
The value 0 should not be used, as it is interpreted either as an account with no expiration or as an expiration date of 1970-01-01.
reserved field
FILES¶
/etc/passwd
/etc/shadow
/etc/shadow-
Note that this file is used by the tools of the shadow toolsuite, but not by all user and password management tools.
SEE ALSO¶
chage(1), login(1), passwd(1), passwd(5), pwck(8), pwconv(8), pwunconv(8), su(1), sulogin(8).
06/24/2025 | shadow-utils 4.18.0 |