New upstream version 4.9upstream/4.9

19 files changed, 179 insertions, 78 deletions

diff --git a/man/man8/chgpasswd.8 b/man/man8/chgpasswd.8
index 1bc9dffa..8faf90cd 100644
--- a/man/man8/chgpasswd.8
+++ b/man/man8/chgpasswd.8
@@ -2,12 +2,12 @@
 .\"     Title: chgpasswd
 .\"    Author: Thomas Kłoczko <kloczek@pld.org.pl>
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "CHGPASSWD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "CHGPASSWD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -121,7 +121,9 @@ This defines the system default encryption algorithm for encrypting passwords (i
 It can take one of these values:
 \fIDES\fR
 (default),
-\fIMD5\fR, \fISHA256\fR, \fISHA512\fR\&.
+\fIMD5\fR, \fISHA256\fR, \fISHA512\fR\&. MD5 and DES should not be used for new hashes, see
+crypt(5)
+for recommendations\&.
 .sp
 Note: this parameter overrides the
 \fBMD5_CRYPT_ENAB\fR
@@ -170,7 +172,7 @@ or
 .sp
 With a lot of rounds, it is more difficult to brute forcing the password\&. But note also that more CPU resources will be needed to authenticate users\&.
 .sp
-If not specified, the libc will choose the default number of rounds (5000)\&.
+If not specified, the libc will choose the default number of rounds (5000), which is orders of magnitude too low for modern hardware\&.
 .sp
 The values must be inside the 1000\-999,999,999 range\&.
 .sp
diff --git a/man/man8/chpasswd.8 b/man/man8/chpasswd.8
index c15630a4..376e7057 100644
--- a/man/man8/chpasswd.8
+++ b/man/man8/chpasswd.8
@@ -2,12 +2,12 @@
 .\"     Title: chpasswd
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "CHPASSWD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "CHPASSWD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -139,7 +139,9 @@ This defines the system default encryption algorithm for encrypting passwords (i
 It can take one of these values:
 \fIDES\fR
 (default),
-\fIMD5\fR, \fISHA256\fR, \fISHA512\fR\&.
+\fIMD5\fR, \fISHA256\fR, \fISHA512\fR\&. MD5 and DES should not be used for new hashes, see
+crypt(5)
+for recommendations\&.
 .sp
 Note: this parameter overrides the
 \fBMD5_CRYPT_ENAB\fR
@@ -173,7 +175,7 @@ or
 .sp
 With a lot of rounds, it is more difficult to brute forcing the password\&. But note also that more CPU resources will be needed to authenticate users\&.
 .sp
-If not specified, the libc will choose the default number of rounds (5000)\&.
+If not specified, the libc will choose the default number of rounds (5000), which is orders of magnitude too low for modern hardware\&.
 .sp
 The values must be inside the 1000\-999,999,999 range\&.
 .sp
diff --git a/man/man8/faillog.8 b/man/man8/faillog.8
index b220088b..d335a4d8 100644
--- a/man/man8/faillog.8
+++ b/man/man8/faillog.8
@@ -2,12 +2,12 @@
 .\"     Title: faillog
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "FAILLOG" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "FAILLOG" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man8/groupadd.8 b/man/man8/groupadd.8
index af5778f3..19b4edae 100644
--- a/man/man8/groupadd.8
+++ b/man/man8/groupadd.8
@@ -2,12 +2,12 @@
 .\"     Title: groupadd
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "GROUPADD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "GROUPADD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -132,6 +132,20 @@ directory and use the configuration files from the
 \fIPREFIX_DIR\fR
 directory\&. This option does not chroot and is intended for preparing a cross\-compilation target\&. Some limitations: NIS and LDAP users/groups are not verified\&. PAM authentication is using the host files\&. No SELINUX support\&.
 .RE
+.PP
+\fB\-U\fR, \fB\-\-users\fR
+.RS 4
+A list of usernames to add as members of the group\&.
+.sp
+The default behavior (if the
+\fB\-g\fR,
+\fB\-N\fR, and
+\fB\-U\fR
+options are not specified) is defined by the
+\fBUSERGROUPS_ENAB\fR
+variable in
+/etc/login\&.defs\&.
+.RE
 .SH "CONFIGURATION"
 .PP
 The following configuration variables in
@@ -229,14 +243,13 @@ invalid argument to option
 .PP
 \fI4\fR
 .RS 4
-GID not unique (when
-\fB\-o\fR
-not used)
+GID is already used (when called without
+\fB\-o\fR)
 .RE
 .PP
 \fI9\fR
 .RS 4
-group name not unique
+group name is already used
 .RE
 .PP
 \fI10\fR
diff --git a/man/man8/groupdel.8 b/man/man8/groupdel.8
index 50addaed..70cc7bdc 100644
--- a/man/man8/groupdel.8
+++ b/man/man8/groupdel.8
@@ -2,12 +2,12 @@
 .\"     Title: groupdel
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "GROUPDEL" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "GROUPDEL" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -44,6 +44,11 @@ The options which apply to the
 \fBgroupdel\fR
 command are:
 .PP
+\fB\-f\fR, \fB\-\-force\fR
+.RS 4
+This option forces the removal of the group, even if there\*(Aqs some user having the group as the primary one\&.
+.RE
+.PP
 \fB\-h\fR, \fB\-\-help\fR
 .RS 4
 Display help message and exit\&.
diff --git a/man/man8/groupmems.8 b/man/man8/groupmems.8
index 1d01d316..5b5a2d4c 100644
--- a/man/man8/groupmems.8
+++ b/man/man8/groupmems.8
@@ -2,12 +2,12 @@
 .\"     Title: groupmems
 .\"    Author: George Kraft, IV
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "GROUPMEMS" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "GROUPMEMS" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man8/groupmod.8 b/man/man8/groupmod.8
index b76f6a95..25fb44ca 100644
--- a/man/man8/groupmod.8
+++ b/man/man8/groupmod.8
@@ -2,12 +2,12 @@
 .\"     Title: groupmod
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "GROUPMOD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "GROUPMOD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -45,6 +45,11 @@ The options which apply to the
 \fBgroupmod\fR
 command are:
 .PP
+\fB\-a\fR, \fB\-\-append\fR\ \&\fIGID\fR
+.RS 4
+If group members are specified with \-U, append them to the existing member list, rather than replacing it\&.
+.RE
+.PP
 \fB\-g\fR, \fB\-\-gid\fR\ \&\fIGID\fR
 .RS 4
 The group ID of the given
@@ -123,6 +128,20 @@ directory and use the configuration files from the
 \fIPREFIX_DIR\fR
 directory\&. This option does not chroot and is intended for preparing a cross\-compilation target\&. Some limitations: NIS and LDAP users/groups are not verified\&. PAM authentication is using the host files\&. No SELINUX support\&.
 .RE
+.PP
+\fB\-U\fR, \fB\-\-users\fR
+.RS 4
+A list of usernames to add as members of the group\&.
+.sp
+The default behavior (if the
+\fB\-g\fR,
+\fB\-N\fR, and
+\fB\-U\fR
+options are not specified) is defined by the
+\fBUSERGROUPS_ENAB\fR
+variable in
+/etc/login\&.defs\&.
+.RE
 .SH "CONFIGURATION"
 .PP
 The following configuration variables in
@@ -187,7 +206,7 @@ E_BAD_ARG: invalid argument to option
 .PP
 \fI4\fR
 .RS 4
-E_GID_IN_USE: specified group doesn\*(Aqt exist
+E_GID_IN_USE: group id already in use
 .RE
 .PP
 \fI6\fR
diff --git a/man/man8/grpck.8 b/man/man8/grpck.8
index a9094e4d..8fadfd17 100644
--- a/man/man8/grpck.8
+++ b/man/man8/grpck.8
@@ -2,12 +2,12 @@
 .\"     Title: grpck
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "GRPCK" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "GRPCK" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -159,6 +159,14 @@ and /etc/gshadow
 by GID\&.
 .RE
 .PP
+\fB\-S\fR, \fB\-\-silence\-warnings\fR
+.RS 4
+Suppress more controversial warnings, in particular warnings about inconsistency between group members listed in
+/etc/group
+and
+/etc/ghadow\&.
+.RE
+.PP
 By default,
 \fBgrpck\fR
 operates on
diff --git a/man/man8/lastlog.8 b/man/man8/lastlog.8
index 3ca86500..dff42bc6 100644
--- a/man/man8/lastlog.8
+++ b/man/man8/lastlog.8
@@ -2,12 +2,12 @@
 .\"     Title: lastlog
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "LASTLOG" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "LASTLOG" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -135,3 +135,7 @@ Database times of previous user logins\&.
 .SH "CAVEATS"
 .PP
 Large gaps in UID numbers will cause the lastlog program to run longer with no output to the screen (i\&.e\&. if in lastlog database there is no entries for users with UID between 170 and 800 lastlog will appear to hang as it processes entries with UIDs 171\-799)\&.
+.PP
+Having high UIDs can create problems when handling the
+<term> /var/log/lastlog</term>
+with external tools\&. Although the actual file is sparse and does not use too much space, certain applications are not designed to identify sparse files by default and may require a specific option to handle them\&.
diff --git a/man/man8/logoutd.8 b/man/man8/logoutd.8
index 88fbc040..3f7b1296 100644
--- a/man/man8/logoutd.8
+++ b/man/man8/logoutd.8
@@ -2,12 +2,12 @@
 .\"     Title: logoutd
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "LOGOUTD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "LOGOUTD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man8/newusers.8 b/man/man8/newusers.8
index df37f7ba..908f98e0 100644
--- a/man/man8/newusers.8
+++ b/man/man8/newusers.8
@@ -2,12 +2,12 @@
 .\"     Title: newusers
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "NEWUSERS" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "NEWUSERS" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -99,7 +99,9 @@ This field is copied in the GECOS field of the user\&.
 .RS 4
 This field is used to define the home directory of the user\&.
 .sp
-If this field does not specify an existing directory, the specified directory is created, with ownership set to the user being created or updated and its primary group\&.
+If this field does not specify an existing directory, the specified directory is created, with ownership set to the user being created or updated and its primary group\&. Note that
+\fInewusers does not create parent directories \fR
+of the new user\*(Aqs home directory\&. The newusers command will fail to create the home directory if the parent directories do not exist, and will send a message to stderr informing the user of the failure\&. The newusers command will not halt or return a failure to the calling shell if it fails to create the home directory, it will continue to process the batch of new users specified\&.
 .sp
 If the home directory of an existing user is changed,
 \fBnewusers\fR
@@ -193,7 +195,9 @@ This defines the system default encryption algorithm for encrypting passwords (i
 It can take one of these values:
 \fIDES\fR
 (default),
-\fIMD5\fR, \fISHA256\fR, \fISHA512\fR\&.
+\fIMD5\fR, \fISHA256\fR, \fISHA512\fR\&. MD5 and DES should not be used for new hashes, see
+crypt(5)
+for recommendations\&.
 .sp
 Note: this parameter overrides the
 \fBMD5_CRYPT_ENAB\fR
@@ -263,7 +267,7 @@ The maximum number of days a password may be used\&. If the password is older th
 .PP
 \fBPASS_MIN_DAYS\fR (number)
 .RS 4
-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)\&.
+The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, 0 will be assumed (which disables the restriction)\&.
 .RE
 .PP
 \fBPASS_WARN_AGE\fR (number)
@@ -282,7 +286,7 @@ or
 .sp
 With a lot of rounds, it is more difficult to brute forcing the password\&. But note also that more CPU resources will be needed to authenticate users\&.
 .sp
-If not specified, the libc will choose the default number of rounds (5000)\&.
+If not specified, the libc will choose the default number of rounds (5000), which is orders of magnitude too low for modern hardware\&.
 .sp
 The values must be inside the 1000\-999,999,999 range\&.
 .sp
diff --git a/man/man8/nologin.8 b/man/man8/nologin.8
index e02954a4..7293116d 100644
--- a/man/man8/nologin.8
+++ b/man/man8/nologin.8
@@ -2,12 +2,12 @@
 .\"     Title: nologin
 .\"    Author: Nicolas François <nicolas.francois@centraliens.net>
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "NOLOGIN" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "NOLOGIN" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man8/pwck.8 b/man/man8/pwck.8
index aacc2e47..9c31ea0f 100644
--- a/man/man8/pwck.8
+++ b/man/man8/pwck.8
@@ -2,12 +2,12 @@
 .\"     Title: pwck
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "PWCK" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "PWCK" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -249,6 +249,11 @@ The following configuration variables in
 /etc/login\&.defs
 change the behavior of this tool:
 .PP
+\fBNONEXISTENT\fR (string)
+.RS 4
+If a system account intentionally does not have a home directory that exists, this string can be provided in the /etc/passwd entry for the account to indicate this\&. The result is that pwck will not emit a spurious warning for this account\&.
+.RE
+.PP
 \fBPASS_MAX_DAYS\fR (number)
 .RS 4
 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)\&.
@@ -256,7 +261,7 @@ The maximum number of days a password may be used\&. If the password is older th
 .PP
 \fBPASS_MIN_DAYS\fR (number)
 .RS 4
-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)\&.
+The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, 0 will be assumed (which disables the restriction)\&.
 .RE
 .PP
 \fBPASS_WARN_AGE\fR (number)
diff --git a/man/man8/pwconv.8 b/man/man8/pwconv.8
index a63a95dd..e485a067 100644
--- a/man/man8/pwconv.8
+++ b/man/man8/pwconv.8
@@ -2,12 +2,12 @@
 .\"     Title: pwconv
 .\"    Author: Marek Michałkiewicz
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "PWCONV" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "PWCONV" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -173,7 +173,7 @@ The maximum number of days a password may be used\&. If the password is older th
 .PP
 \fBPASS_MIN_DAYS\fR (number)
 .RS 4
-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)\&.
+The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, 0 will be assumed (which disables the restriction)\&.
 .RE
 .PP
 \fBPASS_WARN_AGE\fR (number)
diff --git a/man/man8/sulogin.8 b/man/man8/sulogin.8
index 37f25bcf..c1486612 100644
--- a/man/man8/sulogin.8
+++ b/man/man8/sulogin.8
@@ -2,12 +2,12 @@
 .\"     Title: sulogin
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "SULOGIN" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "SULOGIN" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/man/man8/useradd.8 b/man/man8/useradd.8
index 21426cba..572ff7e2 100644
--- a/man/man8/useradd.8
+++ b/man/man8/useradd.8
@@ -2,12 +2,12 @@
 .\"     Title: useradd
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "USERADD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "USERADD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -97,9 +97,11 @@ as the value for the user\*(Aqs login directory\&. The default is to append the
 \fILOGIN\fR
 name to
 \fIBASE_DIR\fR
-and use that as the login directory name\&. The directory
+and use that as the login directory name\&. If the directory
 \fIHOME_DIR\fR
-does not have to exist but will not be created if it is missing\&.
+does not exist, then it will be created unless the
+\fB\-M\fR
+option is specified\&.
 .RE
 .PP
 \fB\-D\fR, \fB\-\-defaults\fR
@@ -222,6 +224,8 @@ option) will be copied to the home directory\&.
 By default, if this option is not specified and
 \fBCREATE_HOME\fR
 is not enabled, no home directories are created\&.
+.sp
+The directory where the user\*(Aqs home directory is created must exist and have proper SELinux context and permissions\&. Otherwise the user\*(Aqs home directory cannot be created or accessed\&.
 .RE
 .PP
 \fB\-M\fR, \fB\-\-no\-create\-home\fR
@@ -539,7 +543,7 @@ The maximum number of days a password may be used\&. If the password is older th
 .PP
 \fBPASS_MIN_DAYS\fR (number)
 .RS 4
-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)\&.
+The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, 0 will be assumed (which disables the restriction)\&.
 .RE
 .PP
 \fBPASS_WARN_AGE\fR (number)
@@ -693,6 +697,20 @@ Secure group account information\&.
 Default values for account creation\&.
 .RE
 .PP
+/etc/shadow\-maint/useradd\-pre\&.d/*, /etc/shadow\-maint/useradd\-post\&.d/*
+.RS 4
+Run\-part files to execute during user addition\&. The environment variable
+\fBACTION\fR
+will be populated with useradd and
+\fBSUBJECT\fR
+with the
+\fBusername\fR\&.
+useradd\-pre\&.d
+will be executed prior to any user addition\&.
+useradd\-post\&.d
+will execute after user addition\&. If a script exits non\-zero then execution will terminate\&.
+.RE
+.PP
 /etc/skel/
 .RS 4
 Directory containing default files\&.
diff --git a/man/man8/userdel.8 b/man/man8/userdel.8
index 0ada52f1..927d7b93 100644
--- a/man/man8/userdel.8
+++ b/man/man8/userdel.8
@@ -2,12 +2,12 @@
 .\"     Title: userdel
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "USERDEL" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "USERDEL" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -221,6 +221,21 @@ User account information\&.
 Secure user account information\&.
 .RE
 .PP
+/etc/shadow\-maint/userdel\-pre\&.d/*, /etc/shadow\-maint/userdel\-post\&.d/*
+.RS 4
+Run\-part files to execute during user deletion\&. The environment variable
+\fBACTION\fR
+will be populated with
+\fBuserdel\fR
+and
+\fBSUBJECT\fR
+with the username\&.
+userdel\-pre\&.d
+will be executed prior to any user deletion\&.
+userdel\-post\&.d
+will execute after user deletion\&. If a script exits non\-zero then execution will terminate\&.
+.RE
+.PP
 /etc/subgid
 .RS 4
 Per user subordinate group IDs\&.
diff --git a/man/man8/usermod.8 b/man/man8/usermod.8
index ea9adce1..4b86d362 100644
--- a/man/man8/usermod.8
+++ b/man/man8/usermod.8
@@ -2,12 +2,12 @@
 .\"     Title: usermod
 .\"    Author: Julianne Frances Haugh
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "USERMOD" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "USERMOD" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -68,7 +68,7 @@ The user\*(Aqs new login directory\&.
 .sp
 If the
 \fB\-m\fR
-option is given, the contents of the current home directory will be moved to the new home directory, which is created if it does not already exist\&.
+option is given, the contents of the current home directory will be moved to the new home directory, which is created if it does not already exist\&. If the current home directory does not exist the new home directory will not be created\&.
 .RE
 .PP
 \fB\-e\fR, \fB\-\-expiredate\fR\ \&\fIEXPIRE_DATE\fR
@@ -107,6 +107,9 @@ The group name or number of the user\*(Aqs new initial login group\&. The group
 Any file from the user\*(Aqs home directory owned by the previous primary group of the user will be owned by this new group\&.
 .sp
 The group ownership of files outside of the user\*(Aqs home directory must be fixed manually\&.
+.sp
+The change of the group ownership of files inside of the user\*(Aqs home directory is also not done if the home dir owner uid is different from the current or new user id\&. This is a safety measure for special home directories such as
+/\&.
 .RE
 .PP
 \fB\-G\fR, \fB\-\-groups\fR\ \&\fIGROUP1\fR[\fI,GROUP2,\&.\&.\&.\fR[\fI,GROUPN\fR]]]
@@ -143,7 +146,7 @@ to
 .PP
 \fB\-m\fR, \fB\-\-move\-home\fR
 .RS 4
-Move the content of the user\*(Aqs home directory to the new location\&.
+Move the content of the user\*(Aqs home directory to the new location\&. If the current home directory does not exist the new home directory will not be created\&.
 .sp
 This option is only valid in combination with the
 \fB\-d\fR
@@ -192,7 +195,7 @@ directory\&. This option does not chroot and is intended for preparing a cross\-
 .PP
 \fB\-s\fR, \fB\-\-shell\fR\ \&\fISHELL\fR
 .RS 4
-The name of the user\*(Aqs new login shell\&. Setting this field to blank causes the system to select the default login shell\&.
+The path of the user\*(Aqs new login shell\&. Setting this field to blank causes the system to select the default login shell\&.
 .RE
 .PP
 \fB\-u\fR, \fB\-\-uid\fR\ \&\fIUID\fR
@@ -207,6 +210,9 @@ The user\*(Aqs mailbox, and any files which the user owns and which are located
 .sp
 The ownership of files outside of the user\*(Aqs home directory must be fixed manually\&.
 .sp
+The change of the user ownership of files inside of the user\*(Aqs home directory is also not done if the home dir owner uid is different from the current or new user id\&. This is a safety measure for special home directories such as
+/\&.
+.sp
 No checks will be performed with regard to the
 \fBUID_MIN\fR,
 \fBUID_MAX\fR,
diff --git a/man/man8/vipw.8 b/man/man8/vipw.8
index f8f175ee..8ae89585 100644
--- a/man/man8/vipw.8
+++ b/man/man8/vipw.8
@@ -2,12 +2,12 @@
 .\"     Title: vipw
 .\"    Author: Marek Michałkiewicz
 .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/23/2020
+.\"      Date: 07/22/2021
 .\"    Manual: System Management Commands
-.\"    Source: shadow-utils 4.8.1
+.\"    Source: shadow-utils 4.9
 .\"  Language: English
 .\"
-.TH "VIPW" "8" "01/23/2020" "shadow\-utils 4\&.8\&.1" "System Management Commands"
+.TH "VIPW" "8" "07/22/2021" "shadow\-utils 4\&.9" "System Management Commands"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------