1PWHISTORY.CONF(5)              Linux-PAM Manual              PWHISTORY.CONF(5)
2
3
4

NAME

6       pwhistory.conf - pam_pwhistory configuration file
7

DESCRIPTION

9       pwhistory.conf provides a way to configure the default settings for
10       saving the last passwords for each user. This file is read by the
11       pam_pwhistory module and is the preferred method over configuring
12       pam_pwhistory directly.
13
14       The file has a very simple name = value format with possible comments
15       starting with # character. The whitespace at the beginning of line, end
16       of line, and around the = sign is ignored.
17

OPTIONS

19       debug
20           Turns on debugging via syslog(3).
21
22       enforce_for_root
23           If this option is set, the check is enforced for root, too.
24
25       remember=N
26           The last N passwords for each user are saved. The default is 10.
27           Value of 0 makes the module to keep the existing contents of the
28           opasswd file unchanged.
29
30       retry=N
31           Prompt user at most N times before returning with error. The
32           default is 1.
33
34       file=/path/filename
35           Store password history in file /path/filename rather than the
36           default location. The default location is /etc/security/opasswd.
37

EXAMPLES

39       /etc/security/pwhistory.conf file example:
40
41           debug
42           remember=5
43           file=/tmp/opasswd
44
45

FILES

47       /etc/security/pwhistory.conf
48           the config file for custom options
49

SEE ALSO

51       pwhistory(8), pam_pwhistory(8), pam.conf(5), pam.d(5), pam(8)
52

AUTHOR

54       pam_pwhistory was written by Thorsten Kukuk. The support for
55       pwhistory.conf was written by Iker Pedrosa.
56
57
58
59Linux-PAM Manual                  07/22/2022                 PWHISTORY.CONF(5)
Impressum