usermod.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

usermod(1M) usermod(1M)

NAME

usermod - modify a user login on the system

SYNOPSIS

usermod [-u uid [-o]] [

-g group][-G group[,group]...] [-d dir [-m [

-i]]] [-s shell ]

[

-c comment][-f inactive ][

-l new_logname ][-e expire ]

[

-p encrypted_password][

-F][

-P -S alternate_password_ﬁle] login

DESCRIPTION

The

usermod command modiﬁes a user login on the system by changing the appropriate login related

ﬁles.

The

usermod command requires the login argument. login is the login name, speciﬁed as a string of

printable characters. It may not contain a colon (

:) or a newline (\n).

Refer to usergroupname(5) to understand the functionality changes with the Numeric User Group Name

feature.

New Behavior

If the primary group of a user is modiﬁed, then the user name is not added to the primary group entry in

/etc/group ﬁle. However, if -G option is speciﬁed the user is added to the corresponding supplemen-

tal group.

Options

The

usermod command supports the following options:

-u uid Specify the UID for the user. uid must be a non-negative decimal integer less

than MAXUID as it is deﬁned in the <param.h> header ﬁle.

-o Allow the UID to be non-unique (that is, a duplicate).

-g group Specify the integer group ID or character string name of an existing group. This

redeﬁnes the primary group membership of the login.

-G group Specify the integer group ID or character string name of an existing group. This

redeﬁnes the supplemental group memberships of the login. Duplicates within

group with the -g and -G options are ignored.

-d dir Specify the new home directory of the login. It defaults to base_dir/login, where

tories.

-m Move the user’s home directory to the directory speciﬁed with the

-d option.

The operation cannot be performed if the user’s home directory is the root direc-

tory or if the user’s home directory is speciﬁed in the

/etc/default/usermod

conﬁguration ﬁle. See usermod (4). If the home

directory exists, the directory must have read and execute permission by group,

where group is the primary group of the login. This condition can be overridden

using the

-i option.

-i Inherit an existing home directory, regardless of its current access permissions.

Typically use this option to inherit orphaned directories, that is, directories that

are not owned by any active user of the system. Note that using the -i option

will impact shared home directories; hence use the -i option with caution. The

permissions will be same as that of newly created home directory.

-s shell Specify the full pathname of the login shell. The value of shell must be a valid

executable ﬁle.

-c comment Specify the comment ﬁeld present in the /etc/passwd entry of this login.

This can be any text string. A short description of the login is suggested for this

ﬁeld.

-f inactive Specify the maximum number of days of continuous inactivity of the login before

the account is locked. For the valid values of inactive refer to description of inac-

tivity ﬁeld in shadow(4).

-l new_logname Specify the new login name for the user. It consists of a string of printable char-

acters that does not contain a colon (:) or a newline (\n).

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
usermod(1M) usermod(1M) NAME usermod - modify a user login on the system SYNOPSIS usermod [-u uid [-o] ] [-g group ] [-G group[,group ]...] [-d dir [-m [-i] ] ] [-s shell ] [-c comment ] [-f inactive ] [-l new_logname ] [-e expire ] [-p encrypted_password] [-F] [-P -S alternate_password_file ] login DESCRIPTION The usermod command modifies a user login on the system by changing the appropriate login related files. The usermod command requires the login argument.
PAGE 2
usermod(1M) -e expire usermod(1M) Specify the date on which this login can no longer be used. After the expire date occurs, no user will be able to access this login. This option is used to create temporary logins. expire , which is a date, may be typed in any desired format, except a Julian date. For example, a date may be entered as either of the following: July 13, 1993 7/13/93 A value of ’’ (two single quotes) or "" (two double quotes) results in no expiration date.
PAGE 3
usermod(1M) usermod(1M) 6 The login to be modified or the group specified with the -g option does not exist. 8 The login to be modified is in use. 9 new_logname is not unique. 10 Cannot modify the /etc/group file. The other parts of the update request will be performed. 11 There is insufficient space to move the home directory (with the -m option). The other parts of the update request will be performed. 12 Unable to complete the move of the home directory to the new home directory.
PAGE 4
(Notes) A (Notes) uA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010