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.

libuser                                            Jan 12 2005                                       luseradd(8)