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

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
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] login
useradd -D [-g group][-b base_dir][-f inactive][-e expire]
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. 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.
-s shell Specifies 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 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.
-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.
-e expire Specifies the date on which this login can no longer be used. After expire, 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 format, except a Julian date. For example, a
date may be entered in either of the following formats:
July 13, 1993
7/13/93
Section 1M−−982 − 1 − HP-UX Release 11i: December 2000
___
___