New upstream version 4.8upstream/4.8

11 files changed, 63 insertions, 49 deletions

diff --git a/man/man5/faillog.5 b/man/man5/faillog.5
index 69532a2b..a2019f7d 100644
--- a/man/man5/faillog.5
+++ b/man/man5/faillog.5
@@ -2,12 +2,12 @@
 .\"     Title: faillog
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual:  File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "FAILLOG" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "FAILLOG" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/gshadow.5 b/man/man5/gshadow.5
index 5a8f6eb8..03fbb0f2 100644
--- a/man/man5/gshadow.5
+++ b/man/man5/gshadow.5
@@ -2,12 +2,12 @@
 .\"     Title: gshadow
 .\"    Author: Nicolas François <nicolas.francois@centraliens.net>
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "GSHADOW" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "GSHADOW" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/limits.5 b/man/man5/limits.5
index e479c0b5..1c767b4f 100644
--- a/man/man5/limits.5
+++ b/man/man5/limits.5
@@ -2,12 +2,12 @@
 .\"     Title: limits
 .\"    Author: Luca Berra
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "LIMITS" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "LIMITS" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/login.access.5 b/man/man5/login.access.5
index 75c50e62..56694011 100644
--- a/man/man5/login.access.5
+++ b/man/man5/login.access.5
@@ -2,12 +2,12 @@
 .\"     Title: login.access
 .\"    Author: Marek Michałkiewicz
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "LOGIN\&.ACCESS" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "LOGIN\&.ACCESS" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/login.defs.5 b/man/man5/login.defs.5
index 2b045473..8903e6c7 100644
--- a/man/man5/login.defs.5
+++ b/man/man5/login.defs.5
@@ -2,12 +2,12 @@
 .\"     Title: login.defs
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "LOGIN\&.DEFS" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "LOGIN\&.DEFS" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/passwd.5 b/man/man5/passwd.5
index 17a4d067..724dd6f7 100644
--- a/man/man5/passwd.5
+++ b/man/man5/passwd.5
@@ -2,12 +2,12 @@
 .\"     Title: passwd
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "PASSWD" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "PASSWD" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -111,13 +111,7 @@ user home directory
 optional user command interpreter
 .RE
 .PP
-The encrypted password field may be blank, in which case no password is required to authenticate as the specified login name\&. However, some applications which read the
-/etc/passwd
-file may decide not to permit
-\fIany\fR
-access at all if the
-\fIpassword\fR
-field is blank\&. If the
+If the
 \fIpassword\fR
 field is a lower\-case
 \(lqx\(rq, then the encrypted password is actually stored in the
@@ -126,10 +120,30 @@ file instead; there
 \fImust\fR
 be a corresponding line in the
 /etc/shadow
-file, or else the user account is invalid\&. If the
+file, or else the user account is invalid\&.
+.PP
+The encrypted
+\fIpassword\fR
+field may be empty, in which case no password is required to authenticate as the specified login name\&. However, some applications which read the
+/etc/passwd
+file may decide not to permit
+\fIany\fR
+access at all if the
+\fIpassword\fR
+field is blank\&.
+.PP
+A
+\fIpassword\fR
+field which starts with an exclamation mark means that the password is locked\&. The remaining characters on the line represent the
 \fIpassword\fR
-field is any other string, then it will be treated as an encrypted password, as specified by
-\fBcrypt\fR(3)\&.
+field before the password was locked\&.
+.PP
+Refer to
+\fBcrypt\fR(3)
+for details on how this string is interpreted\&.
+.PP
+If the password field contains some string that is not a valid result of
+\fBcrypt\fR(3), for instance ! or *, the user will not be able to use a unix password to log in (but the user may log in the system by other means)\&.
 .PP
 The comment field is used by various system utilities, such as
 \fBfinger\fR(1)\&.
diff --git a/man/man5/porttime.5 b/man/man5/porttime.5
index f2290b0c..21af03fc 100644
--- a/man/man5/porttime.5
+++ b/man/man5/porttime.5
@@ -2,12 +2,12 @@
 .\"     Title: porttime
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "PORTTIME" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "PORTTIME" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/shadow.5 b/man/man5/shadow.5
index c136469a..9544ce6e 100644
--- a/man/man5/shadow.5
+++ b/man/man5/shadow.5
@@ -2,12 +2,12 @@
 .\"     Title: shadow
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "SHADOW" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "SHADOW" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -45,18 +45,18 @@ It must be a valid account name, which exist on the system\&.
 .PP
 \fBencrypted password\fR
 .RS 4
+This field may be empty, in which case no passwords are required to authenticate as the specified login name\&. However, some applications which read the
+/etc/shadow
+file may decide not to permit any access at all if the password field is empty\&.
+.sp
+A password field which starts with an exclamation mark means that the password is locked\&. The remaining characters on the line represent the password field before the password was locked\&.
+.sp
 Refer to
 \fBcrypt\fR(3)
 for details on how this string is interpreted\&.
 .sp
 If the password field contains some string that is not a valid result of
 \fBcrypt\fR(3), for instance ! or *, the user will not be able to use a unix password to log in (but the user may log in the system by other means)\&.
-.sp
-This field may be empty, in which case no passwords are required to authenticate as the specified login name\&. However, some applications which read the
-/etc/shadow
-file may decide not to permit any access at all if the password field is empty\&.
-.sp
-A password field which starts with an exclamation mark means that the password is locked\&. The remaining characters on the line represent the password field before the password was locked\&.
 .RE
 .PP
 \fBdate of last password change\fR
diff --git a/man/man5/suauth.5 b/man/man5/suauth.5
index cc57db9e..9baffdd0 100644
--- a/man/man5/suauth.5
+++ b/man/man5/suauth.5
@@ -2,12 +2,12 @@
 .\"     Title: suauth
 .\"    Author: Marek Michałkiewicz
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "SUAUTH" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "SUAUTH" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/subgid.5 b/man/man5/subgid.5
index b0ce8b28..ebb51a48 100644
--- a/man/man5/subgid.5
+++ b/man/man5/subgid.5
@@ -2,12 +2,12 @@
 .\"     Title: subgid
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "SUBGID" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "SUBGID" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man5/subuid.5 b/man/man5/subuid.5
index 70d25ecb..7ff59ec9 100644
--- a/man/man5/subuid.5
+++ b/man/man5/subuid.5
@@ -2,12 +2,12 @@
 .\"     Title: subuid
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 06/13/2019
+.\"      Date: 12/01/2019
 .\"    Manual: File Formats and Conversions
-.\"    Source: shadow-utils 4.7
+.\"    Source: shadow-utils 4.8
 .\"  Language: English
 .\"
-.TH "SUBUID" "5" "06/13/2019" "shadow\-utils 4\&.7" "File Formats and Conversions"
+.TH "SUBUID" "5" "12/01/2019" "shadow\-utils 4\&.8" "File Formats and Conversions"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------