Back to main site | Back to man page index

luseradd(1)                                    General Commands Manual                                    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 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


       -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  back‐
              ends (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)