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.