ADDUSER.CONF(5) 					      BSD File Formats Manual						   ADDUSER.CONF(5)

NAME

     adduser.conf -- adduser(8) configuration file

DESCRIPTION

     The /etc/adduser.conf file is automatically generated by the adduser(8) utility when invoked with the -C command-line option.  It is not
     meant to be edited by hand.

     The /etc/adduser.conf file is used to pre-set certain configuration options for the adduser(8) utility.  When adduser(8) is invoked, it will
     check to see if this file exists, and if so, the configuration will be used or offered as the default settings.  The adduser.conf file offers
     three types of configuration:

     o	 Default settings offered by adduser(8).  These options are specified in the configuration file and offered as the default during every
	 invocation of the adduser(8) utility.

     o	 Configuration options which can be set in adduser.conf, but overridden by passing a flag to adduser(8).

     o	 Configuration supported by adduser(8) but not offered by a flag or during initial invocation.

     In the first case, these options can be set in adduser.conf but will still be offered when adduser(8) is invoked.	In the second case,
     adduser(8) will read the configuration data unless a flag has been passed to override it.	For example, the defaultshell option.  In the
     third case, the configuration will be utilized, but the user will never be prompted to modify the default setting by either a flag or an
     adduser(8) prompt.  For example, the upwexpire setting.

     The following configuration options can be set in adduser.conf:

	   defaultLgroup  The default group new users will be added to.

	   defaultclass   The default class to place users in as described in login.conf(5).

	   defaultgroups  This option is used to specify what other groups the new account should be added to.

	   passwdtype	  May be one of no, none, random, or yes, as described in adduser(8).  As such, the text is not duplicated here and may be
			  read in adduser(8).

	   homeprefix	  The default home directory prefix, usually /home.

	   defaultshell   The user's default shell which may be any of the shells listed in shells(5).

	   udotdir	  Defines the location of the default shell and environment configuration files.

	   msgfile	  Location of the default new user message file.  This message will be sent to all new users if specified here or at the
			  adduser(8) prompt.

	   disableflag	  The default message enclosed in brackets for the lock account prompt.

	   upwexpire	  The default password expiration time.  Format of the date is either a UNIX time in decimal, or a date in dd-mmm-yy[yy]
			  format, where dd is the day, mmm is the month in either numeric or alphabetic format, and yy[yy] is either a two or four
			  digit year.  This option also accepts a relative date in the form of n[mhdwoy] where n is a decimal, octal (leading 0)
			  or hexadecimal (leading 0x) digit followed by the number of Minutes, Hours, Days, Weeks, Months or Years from the cur-
			  rent date at which the expiration time is to be set.

	   uexpire	  The default account expire time.  The format is similar to the upwexpire option.

	   ugecos	  The default information to be held in the GECOS field of /etc/master.passwd.

	   uidstart	  The default user ID setting.	This must be a number above 1000 and fewer than 65534.

EXAMPLES

     The following is an example adduser.conf file created with the -C adduser(8) flag and modified.

	   # Configuration file for adduser(8).
	   # NOTE: only *some* variables are saved.
	   # Last Modified on Fri Mar 30 14:04:05 EST 2004.

	   defaultLgroup=
	   defaultclass=
	   defaultgroups=
	   passwdtype=yes
	   homeprefix=/home
	   defaultshell=/bin/csh
	   udotdir=/usr/share/skel
	   msgfile=/etc/adduser.msg
	   disableflag=
	   upwexpire=91d # Expire passwords 91 days after creation.

SEE ALSO

     group(5), passwd(5), adduser(8), pw(8), rmuser(8)

HISTORY

     The adduser.conf manual page first appeared in FreeBSD 5.3.

AUTHORS

     This manual page was written by Tom Rhodes <trhodes@FreeBSD.org>.

BUGS

     The internal variables documented here may change without notice.	Do not rely on them.  To modify this file invoke adduser(8) with the -C
     option instead.

BSD
								  April 12, 2007							       BSD