|
 |
146491 |
From 02d4478318297d24799b03fa53312da5e3f14a40 Mon Sep 17 00:00:00 2001
|
|
|
146491 |
From: Jiri Kucera <jkucera@redhat.com>
|
|
|
146491 |
Date: Mar 28 2018 14:26:48 +0000
|
|
|
146491 |
Subject: Updated man page
|
|
|
146491 |
|
|
|
146491 |
|
|
|
146491 |
Added more info about -S option:
|
|
|
146491 |
* described status information fields
|
|
|
146491 |
* added note about displaying the last password change date value
|
|
|
146491 |
Added exit codes description.
|
|
|
146491 |
|
|
|
146491 |
---
|
|
|
146491 |
|
|
|
146491 |
diff --git a/man/passwd.1 b/man/passwd.1
|
|
|
146491 |
index b72ffb9..a962c77 100644
|
|
|
146491 |
--- a/man/passwd.1
|
|
|
146491 |
+++ b/man/passwd.1
|
|
|
146491 |
@@ -153,7 +153,23 @@ root only.
|
|
|
146491 |
.TP
|
|
|
146491 |
\fB\-S\fR, \fB\-\-status\fR
|
|
|
146491 |
This will output a short information about the status of the password
|
|
|
146491 |
-for a given account. Available to root user only.
|
|
|
146491 |
+for a given account. The status information consists of 7 fields. The
|
|
|
146491 |
+first field is the user's login name. The second field indicates if the
|
|
|
146491 |
+user account has a locked password (LK), has no password (NP), or has a
|
|
|
146491 |
+usable password (PS). The third field gives the date of the last password
|
|
|
146491 |
+change. The next four fields are the minimum age, maximum age, warning
|
|
|
146491 |
+period, and inactivity period for the password. These ages are expressed
|
|
|
146491 |
+in days.
|
|
|
146491 |
+.sp
|
|
|
146491 |
+\fBNotes:\fR
|
|
|
146491 |
+The date of the last password change is stored as a number of days
|
|
|
146491 |
+since epoch. Depending on the current time zone, the
|
|
|
146491 |
+\fBpasswd \-S\fR
|
|
|
146491 |
+\fIusername\fR
|
|
|
146491 |
+may show the date of the last password change that is different
|
|
|
146491 |
+from the real date of the last password change by ±1 day.
|
|
|
146491 |
+.sp
|
|
|
146491 |
+This option is available to root only.
|
|
|
146491 |
|
|
|
146491 |
.SH "Remember the following two principles"
|
|
|
146491 |
|
|
|
146491 |
@@ -195,10 +211,46 @@ Vigilance on your part will make the system much more secure.
|
|
|
146491 |
|
|
|
146491 |
.SH "EXIT CODE"
|
|
|
146491 |
|
|
|
146491 |
-On successful completion of its task,
|
|
|
146491 |
+The
|
|
|
146491 |
.B passwd
|
|
|
146491 |
-will complete with exit code 0. An exit code of 1 indicates an error
|
|
|
146491 |
-occurred. Textual errors are written to the standard error stream.
|
|
|
146491 |
+command exits with the following codes:
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI0\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+success
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI1\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+passwd/libuser operation failed
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI2\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+unknown user
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI252\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+unknown user name
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI253\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+bad arguments or passwordless account
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI254\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+invalid application of arguments
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+\fI255\fR
|
|
|
146491 |
+.RS 4
|
|
|
146491 |
+libuser operation failed
|
|
|
146491 |
+.RE
|
|
|
146491 |
+.PP
|
|
|
146491 |
+Error messages are written to the standard error stream.
|
|
|
146491 |
|
|
|
146491 |
.SH "CONFORMING TO"
|
|
|
146491 |
.br
|
|
|
146491 |
|