summaryrefslogtreecommitdiff
path: root/man/man8/usermod.8
diff options
context:
space:
mode:
Diffstat (limited to 'man/man8/usermod.8')
-rw-r--r--man/man8/usermod.818
1 files changed, 12 insertions, 6 deletions
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,