HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

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 [-k skel_dir]] [
-f inactive][-e expire][-r update_homedir_ownership] login
useradd -D [-g group][
-b base_dir][-f inactive][-e expire][-r update_homedir_ownership]
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.
New Behavior
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
/etc/group file.
Options
The useradd command supports the following options:
-u uid Specifies the UID for the new user. uid must be a non-negative decimal integer less
than MAXUID as it is 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 Allows the UID to be non-unique (i.e., a duplicate).
-g group Specifies 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 useradd -D -g group.
-G group Specifies 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 Specifies 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 Specifies the full path name 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 Specifies 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 Creates the home directory for the new login if it does not exist. If the home directory
exists, the directory must have read and execute permission by group, where group is
the primary group of the new login. The -m option must be used to create a home
directory.
-k skel_dir Specifies the skeleton directory that contains information that can be copied to the
new login’s home directory. This directory must exist. The system provides a skele-
ton directory, /etc/skel , that can be used for this purpose.
-f inactive Specifies the maximum number of days of continuous inactivity of the login before the
login is declared invalid. Normal values are positive integers, while a value of −1
defeats this status. This option is supported on trusted systems and also on shadow
password systems if the TrustedMigration product is installed.
HP-UX 11i Version 2: December 2007 Update − 1 − Hewlett-Packard Company 571