SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from OpenSuSE pwdutils-3.2.5-2.4.1.x86_64.rpm

usermod

Section: Maintenance Commands (8)
Updated: May 2006
Index 

NAME

usermod - modify a user account 

SYNOPSIS

usermod [-D binddn] [-P path] [-g gid [-o]] [-p password]

[--service service] [--help] [--usage] [-v] account
 

DESCRIPTION

usermod modifies an user account using the values specifiedon the command line. 

OPTIONS

-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.
--help
Print a list of valid options with a short description.
--usage
Print a short list of valid options.
-v, --version
Print the version number and exit.
 

NOTES

usermod 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. 

FILES

/etc/group - group information
/etc/passwd - user account information
/etc/shadow - shadow user account information 

SEE ALSO

passwd(1),login.defs(5),group(5),passwd(5),shadow(5),useradd(8),userdel(8) 

AUTHOR

Thorsten Kukuk <kukukAATTsuse.de>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
NOTES
FILES
SEE ALSO
AUTHOR

This document was created byman2html,using the manual pages.