useradd.1m (2010 09)

u
useradd(1M) useradd(1M)
NAME
useradd - add a new user login to the system
SYNOPSIS
useradd [-u uid [-o]] [
-g group][-G group[,group]...] [-d dir ][-s
shell ][-c comment ]
[
-m [-i][-k
skel_dir ]] [-f inactive ][-e expire ][-r update_homedir_ownership]
[
-p encrypted_password][
-t template ][
-P -S alternate_password_file] login
useradd -D [-g group ][
-b base_dir ][-f inactive ][-e expire ][-r update_homedir_ownership]
[
-k skel_dir ][-s shell ][
-c comment][-O allow_dup_uids][
-t template ]
DESCRIPTION
The
useradd command creates a user login on the system by adding the appropriate entry to the
/etc/passwd file and any security files, modifying the
/etc/group file as necessary, creating a home
directory, and copying the appropriate default files into the home directory depending on the command
line options. The new login remains locked until the
passwd (see passwd (1)) command is invoked.
Refer to usergroupname(5) to understand the functionality changes with the Numeric User Group Name
feature.
New Behavior
The login will not be added to the primary group entry in the
/etc/group file, even if the primary
group is specified in the command line. However, the login is added to the corresponding supplemental
group in the /etc/group file.
Options
The
useradd command supports the following options:
-u uid Specify the UID for the new user. uid must be a non-negative decimal integer less
than MAXUID as defined in the <param.h> header file. uid defaults to the next
available unique number above the maximum currently assigned number. UIDs
from 0-99 are reserved.
-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
defines the primary group membership of the new login. The default for this option
can be reset by invoking the useradd -D -g group command.
-G group Specify the integer group ID or character string name of an existing group. This
defines the supplemental group memberships of the new login. Multiple groups
may be specified as a comma separated list. Duplicates within group with the -g
and -G options are ignored.
-d dir Specify the home directory of the new login. It defaults to base_dir/login, where
login is the new login and base_dir is the base directory for new login home direc-
tories.
To specify directory creation, you must use the
-m option.
-s shell Specify the full pathname of the new login shell. The default is an empty field,
which causes the system to use /sbin/sh as the login shell. The value of shell
must be a valid executable file.
-c comment Specify the comment field present in the /etc/passwd entry for this login. This
can be any text string. A short description of the new login is suggested for this
field.
-m Create the home directory for the new login if it does not exist. If the home direc-
tory exists, the directory must have read and execute permission by group , where
group is the primary group of the new login. This condition can be overridden using
the -i option. The -m option must be used to create a home directory.
-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 permis-
sions will be same as that of a newly created home directory.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1