luseradd(1)                                                                                                          luseradd(1)



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 informa-
              tion.


       -d, --directory=directory
              Set user's home directory to directory.  If this option is not present, a default specified by libuser  configura-
              tion 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 configura-
              tion.


       -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.


       --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.



libuser                                                    2009-12-09                                                luseradd(1)