MAN page from OpenSuSE pwdutils-3.2.5-2.4.1.x86_64.rpm
Section: Maintenance Commands (8)
Updated: May 2006Index
usermod - modify a user account
- usermod [-D binddn] [-P path] [-g gid [-o]] [-p password]
[--service service] [--help] [--usage] [-v] account
modifies an user account using the values specifiedon the command line.
- -c, --comment comment
- This option specifies the new users finger information.It is normally modified using thechfn(1)utility.
- -d, --home homedir
- This option specifies the new home directory of the user.
- -e, --expire expire
- With this option the date when the account will be expired canbe changed. expiredate has to be specified as number ofdays since January 1st, 1970. The date may also be expressed inthe format YYYY-MM-DD.
- -f, --inactive inactive
- This option is used to set the number of days of inactivity aftera password has expired before the account is locked. A user whoseaccount is locked must contact the system administrator beforebeing able to use the account again.A value of -1 disables this feature.
- -G, --groups group,...
- With this option a list of supplementary groups can be specified,which the user should become a member of. Each group is separatedfrom the next one only by a comma, without whitespace. The user isremoved from all other groups not specified.
- -g, --gid gid
- The group name or number of the user's new primary group. The groupname must exist and a group number must refer to an already existinggroup.
- -l, --login name
- Specify the new account name for the user. The account name must beginwith an alphabetic character and the rest of the string should be fromthe POSIX portable character class. Nothing else is changed.
- -m, --move_home
- Move the user's home directory to the new directory specified with the-doption. If the old directory does not exist, nothing is done. If thenew directory already exists, the program aborts with an error.
- -o, --non-unique
- Allow duplicate (non-unique) User IDs.
- -p, --password password
- Encrypted password as returned bycrypt(3)as the new password.
- -s, --shell shell
- Specify user's new login shell. The value of shell must be avalid executable file. It is normally modified using thechsh(1)utility.
- -u, --uid uid
- Change the userid to be the given number. Thisvalue must be positive and unique (unless the-ooption is used).Any file with the old UID of the user and which is located inthe directory tree rooted at the user's home directory will bechanged to be owned by the new UID automatically.
- -D, --binddn binddn
- Use the Distinguished Name binddn to bind to the LDAP directory.The user will be prompted for a password for simple authentication.
- -L, --lock
- A system administrator can lock the account of the specified user.
- -U, --unlock
- A system administrator can unlock the specified account, if theaccount is not passwordless afterwards (it will not unlock anaccount that has only "!" as a password).
- -P, --path path
- The passwd and shadow files are located below thespecified directory path.usermod will use this files, not /etc/passwd and/etc/shadow.
- --service service
- Modify the account from a special directory. The default is files,but ldap is also valid.
- Print a list of valid options with a short description.
- Print a short list of valid options.
- -v, --version
- Print the version number and exit.
will not allow you to change the name, User ID orhome directory of a user, which is logged in. usermod
willnot change the User ID of running processes and not the ownershipof crontab and at jobs.
/etc/group - group information
/etc/passwd - user account information
/etc/shadow - shadow user account information
Thorsten Kukuk <kukukAATTsuse.de>
- SEE ALSO
This document was created byman2html,using the manual pages.