Provided by: adduser_3.112ubuntu1_all bug

NAME

       /etc/adduser.conf  - configuration file for adduser(8) and addgroup(8).

DESCRIPTION

       The  file  /etc/adduser.conf  contains  defaults   for   the   programs
       adduser(8) , addgroup(8) , deluser(8) and delgroup(8).  Each line holds
       a single value pair in the form  option  =  value.   Double  or  single
       quotes are allowed around the value, as is whitespace around the equals
       sign.  Comment lines must have a hash sign (#) in the first column.

       The valid configuration options are:

       DSHELL The login shell to be used  for  all  new  users.   Defaults  to
              /bin/bash.

       DHOME  The  directory  in which new home directories should be created.
              Defaults to /home.

       GROUPHOMES
              If this is set to yes, the home directories will be  created  as
              /home/[groupname]/user.  Defaults to no.

       LETTERHOMES
              If  this  is  set to yes, then the home directories created will
              have an extra directory inserted which is the  first  letter  of
              the loginname.  For example: /home/u/user.  Defaults to no.

       SKEL   The  directory  from  which  skeletal  user  configuration files
              should be copied.  Defaults to /etc/skel.

       FIRST_SYSTEM_UID and LAST_SYSTEM_UID
              specify an inclusive range of UIDs from which system UIDs can be
              dynamically  allocated.  Default to 100 - 999.  Please note that
              system software, such as the users allocated by the  base-passwd
              package, may assume that UIDs less than 100 are unallocated.

       FIRST_UID and LAST_UID
              specify an inclusive range of UIDs from which normal user’s UIDs
              can be dynamically allocated. Default to 1000 - 29999.

       FIRST_SYSTEM_GID and LAST_SYSTEM_GID
              specify an inclusive range of GIDs from which system GIDs can be
              dynamically allocated.  Default to 100 - 999.

       FIRST_GID and LAST_GID
              specify  an  inclusive  range  of GIDs from which normal group’s
              GIDs can be dynamically allocated. Default to 1000 - 29999.

       USERGROUPS
              If this is set to yes, then each  created  user  will  be  given
              their  own  group to use.  If this is no, then each created user
              will be placed in the group whose GID is USERS_GID (see  below).
              The default is yes.

       USERS_GID
              If  USERGROUPS  is  no,  then  USERS_GID is the GID given to all
              newly-created users.  The default value is 100.

       DIR_MODE
              If set to a valid value (e.g. 0755 or 755), directories  created
              will  have the specified permissions as umask. Otherwise 0755 is
              used as default.

       SETGID_HOME
              If this is set to yes, then  home  directories  for  users  with
              their own group ( USERGROUPS=yes ) will have the setgid bit set.
              This was the default  setting  for  adduser  versions  <<  3.13.
              Unfortunately  it  has some bad side effects, so we no longer do
              this per default. If you want  it  nevertheless  you  can  still
              activate it here.

       QUOTAUSER
              If  set  to  a nonempty value, new users will have quotas copied
              from that user.  The default is empty.

       NAME_REGEX
              User  and  group  names  are  checked   against   this   regular
              expression.  If  the  name  doesn’t  match this regexp, user and
              group creation in adduser is refused unless  --force-badname  is
              set.  With  --force-badname set, only weak checks are performed.
              The default is the most  conservative  ^[a-z][-a-z0-9]*$.   When
              --system is specified, NAME_REGEX_SYSTEM is used instead.

       NAME_REGEX_SYSTEM
              Names   of   system  users  are  checked  against  this  regular
              expression.  If --system is supplied and the name doesn’t  match
              this regexp, user creation in adduser is refused unless --force-
              badname is set. With --force-badname set, only weak  checks  are
              performed. The default is as for the default NAME_REGEX but also
              allowing uppercase letters.

       SKEL_IGNORE_REGEX
              Files in /etc/skel/ are checked  against  this  regex,  and  not
              copied  to the newly created home directory if they match.  This
              is by default set to the regular expression matching files  left
              over from unmerged config files (dpkg-(old|new|dist)).

       ADD_EXTRA_GROUPS
              Setting  this to something other than 0 (the default) will cause
              adduser to add newly created non-system users  to  the  list  of
              groups defined by EXTRA_GROUPS (below).

       EXTRA_GROUPS
              This  is  the  list  of groups that new non-system users will be
              added to.  By default, this list is ’dialout cdrom floppy  audio
              video plugdev users games’

NOTES

       VALID NAMES
              adduser and addgroup enforce conformity to IEEE Std 1003.1-2001,
              which allows only the following characters to  appear  in  group
              and  user names: letters, digits, underscores, periods, at signs
              (@) and dashes. The name may no start with a dash. The "$"  sign
              is allowed at the end of usernames (to conform to samba).

              An  additional  check  can  be  adjusted  via  the configuration
              parameter NAME_REGEX to enforce a local policy.

FILES

       /etc/adduser.conf

SEE ALSO

       adduser(8), addgroup(8), deluser(8), delgroup(8), deluser.conf(5)