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 (500 by default).  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.

EXIT STATUS

       The exit status is 0 on success, nonzero on error.