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.