From: ikerexxe Date: Tue, 2 Feb 2021 10:27:17 +0000 (+0100) Subject: man: usermod clarification X-Git-Tag: v4.9~36^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F310%2Fhead;p=thirdparty%2Fshadow.git man: usermod clarification man/usermod.8.xml: specify what happens when the current home directory doesn't exist if using -d and -m options. Moreover, specify what happens when the group ownership is changed and the uid's don't match in -u and -g options. --- diff --git a/man/usermod.8.xml b/man/usermod.8.xml index a1d0efd8d..79305896c 100644 --- a/man/usermod.8.xml +++ b/man/usermod.8.xml @@ -143,7 +143,8 @@ If the 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. + not already exist. If the current home directory does not exist + the new home directory will not be created. @@ -205,6 +206,12 @@ The group ownership of files outside of the user's home directory must be fixed manually. + + The change of the group ownership of files inside of the user's + 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 /. + @@ -267,7 +274,8 @@ Move the content of the user's home directory to the new - location. + location. If the current home directory does not exist + the new home directory will not be created. This option is only valid in combination with the @@ -380,6 +388,12 @@ The ownership of files outside of the user's home directory must be fixed manually. + + The change of the user ownership of files inside of the user's + 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 /. + No checks will be performed with regard to the , ,