Debian Codegraph @

upstream/debian-unstable/man5/pwhistory.conf.5

raw
1 '\" t
2 .\" Title: pwhistory.conf
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
5 .\" Date: 06/29/2025
6 .\" Manual: Linux-PAM Manual
7 .\" Source: Linux-PAM
8 .\" Language: English
9 .\"
10 .TH "PWHISTORY\&.CONF" "5" "06/29/2025" "Linux\-PAM" "Linux\-PAM Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 pwhistory.conf \- pam_pwhistory configuration file
32 .SH "DESCRIPTION"
33 .PP
34 \fBpwhistory\&.conf\fR
35 provides a way to configure the default settings for saving the last passwords for each user\&. This file is read by the
36 \fIpam_pwhistory\fR
37 module and is the preferred method over configuring
38 \fIpam_pwhistory\fR
39 directly\&.
40 .PP
41 The file has a very simple
42 \fIname = value\fR
43 format with possible comments starting with
44 \fI#\fR
45 character\&. The whitespace at the beginning of line, end of line, and around the
46 \fI=\fR
47 sign is ignored\&.
48 .SH "OPTIONS"
49 .PP
50 debug
51 .RS 4
52 Turns on debugging via
53 \fBsyslog\fR(3)\&.
54 .RE
55 .PP
56 enforce_for_root
57 .RS 4
58 If this option is set, the check is enforced for root, too\&.
59 .RE
60 .PP
61 remember=N
62 .RS 4
63 The last
64 \fIN\fR
65 passwords for each user are saved\&. The default is
66 \fI10\fR\&. Value of
67 \fI0\fR
68 makes the module to keep the existing contents of the
69 opasswd
70 file unchanged\&.
71 .RE
72 .PP
73 retry=N
74 .RS 4
75 Prompt user at most
76 \fIN\fR
77 times before returning with error\&. The default is 1\&.
78 .RE
79 .PP
80 file=/path/filename
81 .RS 4
82 Store password history in file
83 \fI/path/filename\fR
84 rather than the default location\&. The default location is
85 /etc/security/opasswd\&.
86 .RE
87 .SH "EXAMPLES"
88 .PP
89 /etc/security/pwhistory\&.conf file example:
90 .sp
91 .if n \{\
92 .RS 4
93 .\}
94 .nf
95 debug
96 remember=5
97 file=/tmp/opasswd
98
99 .fi
100 .if n \{\
101 .RE
102 .\}
103 .SH "FILES"
104 .PP
105 /etc/security/pwhistory\&.conf
106 .RS 4
107 the config file for custom options
108 .RE
109 .SH "SEE ALSO"
110 .PP
111 \fBpwhistory\fR(8),
112 \fBpam_pwhistory\fR(8),
113 \fBpam.conf\fR(5),
114 \fBpam.d\fR(5),
115 \fBpam\fR(8)
116 .SH "AUTHOR"
117 .PP
118 pam_pwhistory was written by Thorsten Kukuk\&. The support for pwhistory\&.conf was written by Iker Pedrosa\&.