luseradd
Section: User Commands (1)
Updated: 2009-12-09
Page Index
NAME
luseradd - Add an user
SYNOPSIS
luseradd [
OPTION]...
user
DESCRIPTION
Adds an user with name
user.
OPTIONS
- -c, --gecos=gecos
-
Set the GECOS field to gecos.
The GECOS field is traditionally used to store user's real name
and other information.
- -d, --directory=directory
-
Set user's home directory to directory.
If this option is not present,
a default specified by
libuser
configuration is used.
- -g, --gid=group
-
Set user's primary group to group.
group can either be a group ID of an existing group, or a group name;
if group is a group name and the group does not exist,
it is created.
If the --gid option is not specified,
the default group name is user.
- -i, --interactive
-
Ask all questions when connecting to the user database,
even if default answers are set up in
libuser
configuration.
- -k, --skeleton=directory
-
Populate the newly created user's home directory with a copy of
directory.
If this option is not present,
a default directory specified by
libuser
configuration,
or /etc/skel if
libuser
configuration does not specify a default,
is used.
- -M, --nocreatehome
-
Don't create a home directory and a mail spool for the newly created user.
- -n, --nocreategroup
-
If a group is not specified using -g,
use group name "users" instead of user.
Note that despite the name of the option,
the group will still be created if it does not exist.
- -P, --plainpassword=password
-
Set user's password to password.
Note that the password can be viewed while running
luseradd
using tools such as
ps(1).
- -p, --password=encrypted
-
Set user's password to the password represented by the hash
encrypted.
Note that the hash can be viewed while running
luseradd
using tools such as
ps(1).
- -r, --reserved
-
The user is a system user.
Users that are not marked as system user
usually have automatically selected user IDs above a certain value
(configured as
LU_UIDNUMBER
in libuser.conf(5)).
This information is also passed to the
libuser
backends.
This option implies the -M option.
- -s, --shell=shell
-
Set user's login shell to shell.
If this option is not present,
a default specified by
libuser
configuration is used.
- -u, --uid=uid
-
Use user ID uid for the newly created user.
An user ID is selected automatically if this option is not present.
- --commonname=name
-
Use common name
name
for the newly created user.
This attribute is only supported in some backends (e.g.LDAP),
and its support may have further limitations (e.g. LDAP schema rules).
- --givenname=name
-
Use given name
name
for the newly created user.
This attribute is only supported in some backends (e.g.LDAP),
and its support may have further limitations (e.g. LDAP schema rules).
- --homephone=phone
-
Use home telephone number
phone
for the newly created user.
This attribute is only supported in some backends (e.g.LDAP),
and its support may have further limitations (e.g. LDAP schema rules).
- --roomnumber=room
-
Use room number
room
for the newly created user.
This attribute is only supported in some backends (e.g.LDAP),
and its support may have further limitations (e.g. LDAP schema rules).
- --surname=name
-
Use surname
name
for the newly created user.
This attribute is only supported in some backends (e.g.LDAP),
and its support may have further limitations (e.g. LDAP schema rules).
- --telephonenumber=phone
-
Use telephone number
phone
for the newly created user.
This attribute is only supported in some backends (e.g.LDAP),
and its support may have further limitations (e.g. LDAP schema rules).
EXIT STATUS
The exit status is 0 on success, nonzero on error.