2 .\" Copyright (c) 2004 Tom Rhodes
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37 file is automatically generated by the
39 utility when invoked with the
42 It is not meant to be edited by hand.
46 file is used to pre-set certain configuration options for
52 is invoked, it will check to see if this file exists, and
53 if so, the configuration will be used or offered as the
57 file offers three types of configuration:
60 Default settings offered by
62 These options are specified in the configuration file and offered
63 as the default during every invocation of the
67 Configuration options which can be set in
69 but overridden by passing a flag to
72 Configuration supported by
74 but not offered by a flag or during initial invocation.
77 In the first case, these options can be set in
79 but will still be offered when
84 will read the configuration data unless a flag
85 has been passed to override it.
89 In the third case, the configuration will be utilized, but the
90 user will never be prompted to modify the default setting by
98 The following configuration options can be set in
100 .Bl -tag -width ".Va defaultgroups" -offset indent
102 The default group new users will be added to.
104 The default class to place users in as described in
107 This option is used to specify what other groups the new account
111 .Cm no , none , random ,
116 As such, the text is not duplicated here and may be
120 The default home directory prefix, usually
123 The user's default shell which may be any of the shells listed in
126 Defines the location of the default shell and environment
129 Location of the default new user message file.
130 This message will be sent to all new users if specified
135 The default message enclosed in brackets for the
138 The default password expiration time.
139 Format of the date is either a
141 time in decimal, or a date in
143 .Ar dd No - Ar mmm No - Ar yy Op Ar yy
149 is the month in either numeric or
150 alphabetic format, and
152 is either a two or four digit year.
153 This option also accepts a relative date in the form of
155 .Ar n Op Ar m h d w o y
159 is a decimal, octal (leading 0) or hexadecimal (leading 0x) digit
160 followed by the number of Minutes, Hours, Days, Weeks, Months or
161 Years from the current date at
162 which the expiration time is to be set.
164 The default account expire time.
165 The format is similar to the
169 The default information to be held in the GECOS field of
170 .Pa /etc/master.passwd .
172 The default user ID setting.
173 This must be a number above 1000 and fewer than 65534.
175 Do not attempt to create ZFS home dataset.
178 The following is an example
180 file created with the
184 .Bd -literal -offset indent
185 # Configuration file for adduser(8).
186 # NOTE: only *some* variables are saved.
187 # Last Modified on Fri Mar 30 14:04:05 EST 2004.
194 defaultshell=/bin/csh
195 udotdir=/usr/share/skel
196 msgfile=/etc/adduser.msg
198 upwexpire=91d # Expire passwords 91 days after creation.
209 manual page first appeared in
212 This manual page was written by
213 .An Tom Rhodes Aq Mt trhodes@FreeBSD.org .
215 The internal variables documented here may change without notice.
217 To modify this file invoke