~ubuntu-branches/ubuntu/raring/shadow/raring-proposed

« back to all changes in this revision

Viewing changes to man/pwck.8

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2009-05-05 09:45:21 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20090505094521-wpk2wn3q7957tlah
Tags: 1:4.1.3.1-1ubuntu1
* Merge from debian unstable, remaining changes:
  - Ubuntu specific:
    + debian/login.defs: use SHA512 by default for password crypt routine.
  - debian/patches/stdout-encrypted-password.patch: chpasswd can report
    password hashes on stdout (debian bug 505640).
  - debian/login.pam: Enable SELinux support (debian bug 527106).
  - debian/securetty.linux: support Freescale MX-series (debian bug 527095).
* Add debian/patches/300_lastlog_failure: fixed upstream (debian bug 524873).
* Drop debian/patches/593_omit_lastchange_field_if_clock_is_misset: fixed
  upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\"     Title: pwck
2
2
.\"    Author: 
3
3
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4
 
.\"      Date: 04/03/2008
 
4
.\"      Date: 04/15/2009
5
5
.\"    Manual: System Management Commands
6
6
.\"    Source: System Management Commands
7
7
.\"
8
 
.TH "PWCK" "8" "04/03/2008" "System Management Commands" "System Management Commands"
 
8
.TH "PWCK" "8" "04/15/2009" "System Management Commands" "System Management Commands"
9
9
.\" disable hyphenation
10
10
.nh
11
11
.\" disable justification (adjust text to left margin only)
21
21
.PP
22
22
The
23
23
\fBpwck\fR
24
 
command verifies the integrity of the system authentication information\. All entries in the
 
24
command verifies the integrity of the system authentication information\&. All entries in the
25
25
\fI/etc/passwd\fR
26
26
and
27
27
\fI/etc/shadow\fR
28
 
are checked to see that the entry has the proper format and valid data in each field\. The user is prompted to delete entries that are improperly formatted or which have other uncorrectable errors\.
 
28
are checked to see that the entry has the proper format and valid data in each field\&. The user is prompted to delete entries that are improperly formatted or which have other uncorrectable errors\&.
29
29
.PP
30
30
Checks are made to verify that each entry has:
31
31
.sp
53
53
\h'-04'\(bu\h'+03'a valid login shell
54
54
.RE
55
55
.PP
56
 
The checks for correct number of fields and unique user name are fatal\. If the entry has the wrong number of fields, the user will be prompted to delete the entire line\. If the user does not answer affirmatively, all further checks are bypassed\. An entry with a duplicated user name is prompted for deletion, but the remaining checks will still be made\. All other errors are warning and the user is encouraged to run the
 
56
The checks for correct number of fields and unique user name are fatal\&. If the entry has the wrong number of fields, the user will be prompted to delete the entire line\&. If the user does not answer affirmatively, all further checks are bypassed\&. An entry with a duplicated user name is prompted for deletion, but the remaining checks will still be made\&. All other errors are warning and the user is encouraged to run the
57
57
\fBusermod\fR
58
 
command to correct the error\.
 
58
command to correct the error\&.
59
59
.PP
60
60
The commands which operate on the
61
61
\fI/etc/passwd\fR
62
 
file are not able to alter corrupted or duplicated entries\.
 
62
file are not able to alter corrupted or duplicated entries\&.
63
63
\fBpwck\fR
64
 
should be used in those circumstances to remove the offending entry\.
 
64
should be used in those circumstances to remove the offending entry\&.
65
65
.SH "OPTIONS"
66
66
.PP
67
67
The options which apply to the
70
70
.PP
71
71
\fB\-q\fR
72
72
.RS 4
73
 
Report errors only\. The warnings which do not require any action from the user won\'t be displayed\.
 
73
Report errors only\&. The warnings which do not require any action from the user won\'t be displayed\&.
74
74
.RE
75
75
.PP
76
76
\fB\-r\fR
77
77
.RS 4
78
78
Execute the
79
79
\fBpwck\fR
80
 
command in read\-only mode\.
 
80
command in read\-only mode\&.
81
81
.RE
82
82
.PP
83
83
\fB\-s\fR
86
86
\fI/etc/passwd\fR
87
87
and
88
88
\fI/etc/shadow\fR
89
 
by UID\.
 
89
by UID\&.
90
90
.RE
91
91
.PP
92
92
By default,
94
94
operates on the files
95
95
\fI/etc/passwd\fR
96
96
and
97
 
\fI/etc/shadow\fR\. The user may select alternate files with the
 
97
\fI/etc/shadow\fR\&. The user may select alternate files with the
98
98
\fIpasswd\fR
99
99
and
100
100
\fIshadow\fR
101
 
parameters\.
 
101
parameters\&.
102
102
.SH "CONFIGURATION"
103
103
.PP
104
104
The following configuration variables in
105
 
\fI/etc/login\.defs\fR
 
105
\fI/etc/login\&.defs\fR
106
106
change the behavior of this tool:
107
107
.PP
108
108
\fBPASS_MAX_DAYS\fR (number)
109
109
.RS 4
110
 
The maximum number of days a password may be used\. If the password is older than this, a password change will be forced\. If not specified, \-1 will be assumed (which disables the restriction)\.
 
110
The maximum number of days a password may be used\&. If the password is older than this, a password change will be forced\&. If not specified, \-1 will be assumed (which disables the restriction)\&.
111
111
.RE
112
112
.PP
113
113
\fBPASS_MIN_DAYS\fR (number)
114
114
.RS 4
115
 
The minimum number of days allowed between password changes\. Any password changes attempted sooner than this will be rejected\. If not specified, \-1 will be assumed (which disables the restriction)\.
 
115
The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, \-1 will be assumed (which disables the restriction)\&.
116
116
.RE
117
117
.PP
118
118
\fBPASS_WARN_AGE\fR (number)
119
119
.RS 4
120
 
The number of days warning given before a password expires\. A zero means warning is given only upon the day of expiration, a negative value means no warning is given\. If not specified, no warning will be provided\.
 
120
The number of days warning given before a password expires\&. A zero means warning is given only upon the day of expiration, a negative value means no warning is given\&. If not specified, no warning will be provided\&.
121
121
.RE
122
122
.SH "FILES"
123
123
.PP
124
124
\fI/etc/group\fR
125
125
.RS 4
126
 
Group account information\.
 
126
Group account information\&.
127
127
.RE
128
128
.PP
129
129
\fI/etc/passwd\fR
130
130
.RS 4
131
 
User account information\.
 
131
User account information\&.
132
132
.RE
133
133
.PP
134
134
\fI/etc/shadow\fR
135
135
.RS 4
136
 
Secure user account information\.
 
136
Secure user account information\&.
137
137
.RE
138
138
.SH "SEE ALSO"
139
139
.PP
 
140
 
140
141
\fBgroup\fR(5),
 
142
\fBgrpck\fR(8),
141
143
\fBpasswd\fR(5),
142
144
\fBshadow\fR(5),
143
 
\fBusermod\fR(8)\.
 
145
\fBusermod\fR(8)\&.
144
146
.SH "EXIT VALUES"
145
147
.PP
146
148
The
176
178
.RS 4
177
179
can\'t update password files
178
180
.RE
 
181
.PP
 
182
\fI6\fR
 
183
.RS 4
 
184
can\'t sort password files
 
185
.RE