head 1.8; access; symbols netbsd-9-4-RELEASE:1.8 netbsd-10-0-RELEASE:1.8 netbsd-10-0-RC6:1.8 netbsd-10-0-RC5:1.8 netbsd-10-0-RC4:1.8 netbsd-10-0-RC3:1.8 netbsd-10-0-RC2:1.8 netbsd-10-0-RC1:1.8 netbsd-10:1.8.0.26 netbsd-10-base:1.8 netbsd-9-3-RELEASE:1.8 cjep_sun2x-base1:1.8 cjep_sun2x:1.8.0.24 cjep_sun2x-base:1.8 cjep_staticlib_x-base1:1.8 netbsd-9-2-RELEASE:1.8 cjep_staticlib_x:1.8.0.22 cjep_staticlib_x-base:1.8 netbsd-9-1-RELEASE:1.8 phil-wifi-20200421:1.8 phil-wifi-20200411:1.8 is-mlppp:1.8.0.20 is-mlppp-base:1.8 phil-wifi-20200406:1.8 netbsd-8-2-RELEASE:1.8 netbsd-9-0-RELEASE:1.8 netbsd-9-0-RC2:1.8 netbsd-9-0-RC1:1.8 phil-wifi-20191119:1.8 netbsd-9:1.8.0.18 netbsd-9-base:1.8 phil-wifi-20190609:1.8 netbsd-8-1-RELEASE:1.8 netbsd-8-1-RC1:1.8 pgoyette-compat-merge-20190127:1.8 pgoyette-compat-20190127:1.8 pgoyette-compat-20190118:1.8 pgoyette-compat-1226:1.8 pgoyette-compat-1126:1.8 pgoyette-compat-1020:1.8 pgoyette-compat-0930:1.8 pgoyette-compat-0906:1.8 netbsd-7-2-RELEASE:1.7 pgoyette-compat-0728:1.8 netbsd-8-0-RELEASE:1.8 phil-wifi:1.8.0.16 phil-wifi-base:1.8 pgoyette-compat-0625:1.8 netbsd-8-0-RC2:1.8 pgoyette-compat-0521:1.8 pgoyette-compat-0502:1.8 pgoyette-compat-0422:1.8 netbsd-8-0-RC1:1.8 pgoyette-compat-0415:1.8 pgoyette-compat-0407:1.8 pgoyette-compat-0330:1.8 pgoyette-compat-0322:1.8 pgoyette-compat-0315:1.8 netbsd-7-1-2-RELEASE:1.7 pgoyette-compat:1.8.0.14 pgoyette-compat-base:1.8 netbsd-7-1-1-RELEASE:1.7 matt-nb8-mediatek:1.8.0.12 matt-nb8-mediatek-base:1.8 perseant-stdc-iso10646:1.8.0.10 perseant-stdc-iso10646-base:1.8 netbsd-8:1.8.0.8 netbsd-8-base:1.8 prg-localcount2-base3:1.8 prg-localcount2-base2:1.8 prg-localcount2-base1:1.8 prg-localcount2:1.8.0.6 prg-localcount2-base:1.8 pgoyette-localcount-20170426:1.8 bouyer-socketcan-base1:1.8 pgoyette-localcount-20170320:1.8 netbsd-7-1:1.7.0.30 netbsd-7-1-RELEASE:1.7 netbsd-7-1-RC2:1.7 netbsd-7-nhusb-base-20170116:1.7 bouyer-socketcan:1.8.0.4 bouyer-socketcan-base:1.8 pgoyette-localcount-20170107:1.8 netbsd-7-1-RC1:1.7 pgoyette-localcount-20161104:1.8 netbsd-7-0-2-RELEASE:1.7 localcount-20160914:1.8 netbsd-7-nhusb:1.7.0.28 netbsd-7-nhusb-base:1.7 pgoyette-localcount-20160806:1.8 pgoyette-localcount-20160726:1.8 pgoyette-localcount:1.8.0.2 pgoyette-localcount-base:1.8 netbsd-7-0-1-RELEASE:1.7 netbsd-7-0:1.7.0.26 netbsd-7-0-RELEASE:1.7 netbsd-7-0-RC3:1.7 netbsd-7-0-RC2:1.7 netbsd-7-0-RC1:1.7 netbsd-5-2-3-RELEASE:1.5 netbsd-5-1-5-RELEASE:1.5 netbsd-6-0-6-RELEASE:1.7 netbsd-6-1-5-RELEASE:1.7 netbsd-7:1.7.0.24 netbsd-7-base:1.7 yamt-pagecache-base9:1.7 yamt-pagecache-tag8:1.7 netbsd-6-1-4-RELEASE:1.7 netbsd-6-0-5-RELEASE:1.7 tls-earlyentropy:1.7.0.22 tls-earlyentropy-base:1.7 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.7 riastradh-drm2-base3:1.7 netbsd-6-1-3-RELEASE:1.7 netbsd-6-0-4-RELEASE:1.7 netbsd-5-2-2-RELEASE:1.5 netbsd-5-1-4-RELEASE:1.5 netbsd-6-1-2-RELEASE:1.7 netbsd-6-0-3-RELEASE:1.7 netbsd-5-2-1-RELEASE:1.5 netbsd-5-1-3-RELEASE:1.5 netbsd-6-1-1-RELEASE:1.7 riastradh-drm2-base2:1.7 riastradh-drm2-base1:1.7 riastradh-drm2:1.7.0.16 riastradh-drm2-base:1.7 netbsd-6-1:1.7.0.20 netbsd-6-0-2-RELEASE:1.7 netbsd-6-1-RELEASE:1.7 netbsd-6-1-RC4:1.7 netbsd-6-1-RC3:1.7 agc-symver:1.7.0.18 agc-symver-base:1.7 netbsd-6-1-RC2:1.7 netbsd-6-1-RC1:1.7 yamt-pagecache-base8:1.7 netbsd-5-2:1.5.0.2 netbsd-6-0-1-RELEASE:1.7 yamt-pagecache-base7:1.7 netbsd-5-2-RELEASE:1.5 netbsd-5-2-RC1:1.5 matt-nb6-plus-nbase:1.7 yamt-pagecache-base6:1.7 netbsd-6-0:1.7.0.14 netbsd-6-0-RELEASE:1.7 netbsd-6-0-RC2:1.7 tls-maxphys:1.7.0.12 tls-maxphys-base:1.7 matt-nb6-plus:1.7.0.10 matt-nb6-plus-base:1.7 netbsd-6-0-RC1:1.7 yamt-pagecache-base5:1.7 yamt-pagecache-base4:1.7 netbsd-6:1.7.0.8 netbsd-6-base:1.7 netbsd-5-1-2-RELEASE:1.5 netbsd-5-1-1-RELEASE:1.5 yamt-pagecache-base3:1.7 yamt-pagecache-base2:1.7 yamt-pagecache:1.7.0.6 yamt-pagecache-base:1.7 cherry-xenmp:1.7.0.4 cherry-xenmp-base:1.7 bouyer-quota2-nbase:1.7 bouyer-quota2:1.7.0.2 bouyer-quota2-base:1.7 matt-mips64-premerge-20101231:1.7 matt-nb5-mips64-premerge-20101231:1.5 matt-nb5-pq3:1.5.0.14 matt-nb5-pq3-base:1.5 netbsd-5-1:1.5.0.12 netbsd-5-1-RELEASE:1.5 netbsd-5-1-RC4:1.5 matt-nb5-mips64-k15:1.5 netbsd-5-1-RC3:1.5 netbsd-5-1-RC2:1.5 netbsd-5-1-RC1:1.5 netbsd-5-0-2-RELEASE:1.5 matt-nb5-mips64-premerge-20091211:1.5 matt-premerge-20091211:1.5 matt-nb5-mips64-u2-k2-k4-k7-k8-k9:1.5 matt-nb4-mips64-k7-u2a-k9b:1.5 matt-nb5-mips64-u1-k1-k5:1.5 matt-nb5-mips64:1.5.0.10 netbsd-5-0-1-RELEASE:1.5 jym-xensuspend-nbase:1.5 netbsd-5-0:1.5.0.8 netbsd-5-0-RELEASE:1.5 netbsd-5-0-RC4:1.5 netbsd-5-0-RC3:1.5 netbsd-5-0-RC2:1.5 jym-xensuspend:1.5.0.6 jym-xensuspend-base:1.5 netbsd-5-0-RC1:1.5 netbsd-5:1.5.0.4 netbsd-5-base:1.5 matt-mips64-base2:1.5 matt-mips64:1.4.0.20 netbsd-4-0-1-RELEASE:1.4 wrstuden-revivesa-base-3:1.5 wrstuden-revivesa-base-2:1.5 wrstuden-fixsa-newbase:1.4 wrstuden-revivesa-base-1:1.4 yamt-pf42-base4:1.4 yamt-pf42-base3:1.4 hpcarm-cleanup-nbase:1.4 yamt-pf42-baseX:1.4 yamt-pf42-base2:1.4 wrstuden-revivesa:1.4.0.18 wrstuden-revivesa-base:1.4 yamt-pf42:1.4.0.16 yamt-pf42-base:1.4 keiichi-mipv6-nbase:1.4 keiichi-mipv6:1.4.0.14 keiichi-mipv6-base:1.4 matt-armv6-nbase:1.4 matt-armv6-prevmlocking:1.4 wrstuden-fixsa-base-1:1.4 netbsd-4-0:1.4.0.12 netbsd-4-0-RELEASE:1.4 cube-autoconf:1.4.0.10 cube-autoconf-base:1.4 netbsd-4-0-RC5:1.4 netbsd-4-0-RC4:1.4 netbsd-4-0-RC3:1.4 netbsd-4-0-RC2:1.4 netbsd-4-0-RC1:1.4 matt-armv6:1.4.0.8 matt-armv6-base:1.4 matt-mips64-base:1.4 hpcarm-cleanup:1.4.0.6 hpcarm-cleanup-base:1.4 netbsd-3-1-1-RELEASE:1.3 netbsd-3-0-3-RELEASE:1.3 wrstuden-fixsa:1.4.0.4 wrstuden-fixsa-base:1.4 abandoned-netbsd-4-base:1.3 abandoned-netbsd-4:1.3.0.12 netbsd-3-1:1.3.0.14 netbsd-3-1-RELEASE:1.3 netbsd-3-0-2-RELEASE:1.3 netbsd-3-1-RC4:1.3 netbsd-3-1-RC3:1.3 netbsd-3-1-RC2:1.3 netbsd-3-1-RC1:1.3 netbsd-4:1.4.0.2 netbsd-4-base:1.4 netbsd-3-0-1-RELEASE:1.3 netbsd-3-0:1.3.0.10 netbsd-3-0-RELEASE:1.3 netbsd-3-0-RC6:1.3 netbsd-3-0-RC5:1.3 netbsd-3-0-RC4:1.3 netbsd-3-0-RC3:1.3 netbsd-3-0-RC2:1.3 netbsd-3-0-RC1:1.3 netbsd-2-0-3-RELEASE:1.3 netbsd-2-1:1.3.0.8 netbsd-2-1-RELEASE:1.3 netbsd-2-1-RC6:1.3 netbsd-2-1-RC5:1.3 netbsd-2-1-RC4:1.3 netbsd-2-1-RC3:1.3 netbsd-2-1-RC2:1.3 netbsd-2-1-RC1:1.3 netbsd-2-0-2-RELEASE:1.3 netbsd-3:1.3.0.6 netbsd-3-base:1.3 netbsd-2-0-1-RELEASE:1.3 netbsd-2:1.3.0.4 netbsd-2-base:1.3 netbsd-2-0-RELEASE:1.3 netbsd-2-0-RC5:1.3 netbsd-2-0-RC4:1.3 netbsd-2-0-RC3:1.3 netbsd-2-0-RC2:1.3 netbsd-2-0-RC1:1.3 netbsd-2-0:1.3.0.2 netbsd-2-0-base:1.3 netbsd-1-6-PATCH002-RELEASE:1.2.2.3 netbsd-1-6-PATCH002:1.2.2.3 netbsd-1-6-PATCH002-RC4:1.2.2.3 netbsd-1-6-PATCH002-RC3:1.2.2.3 netbsd-1-6-PATCH002-RC2:1.2.2.3 netbsd-1-6-PATCH002-RC1:1.2.2.3 netbsd-1-6-PATCH001:1.2.2.3 netbsd-1-6-PATCH001-RELEASE:1.2.2.3 netbsd-1-6-PATCH001-RC3:1.2.2.3 netbsd-1-6-PATCH001-RC2:1.2.2.3 netbsd-1-6-PATCH001-RC1:1.2.2.3 fvdl_fs64_base:1.3 netbsd-1-6-RELEASE:1.2.2.3 netbsd-1-6-RC3:1.2.2.3 netbsd-1-6-RC2:1.2.2.3 netbsd-1-6-RC1:1.2.2.3 netbsd-1-5-PATCH003:1.2.4.2 netbsd-1-5:1.2.0.4 netbsd-1-6:1.2.0.2; locks; strict; comment @.\" @; 1.8 date 2016.02.09.14.14.02; author wiz; state Exp; branches; next 1.7; commitid oO521yuuheDmqfUy; 1.7 date 2009.12.31.20.14.19; author wiz; state Exp; branches; next 1.6; 1.6 date 2009.12.31.19.59.31; author mlelstv; state Exp; branches; next 1.5; 1.5 date 2008.07.18.21.03.03; author apb; state Exp; branches; next 1.4; 1.4 date 2006.10.07.09.20.07; author elad; state Exp; branches 1.4.18.1; next 1.3; 1.3 date 2002.10.02.13.49.11; author grant; state Exp; branches; next 1.2; 1.2 date 2002.06.01.09.21.11; author wiz; state Exp; branches 1.2.2.1 1.2.4.1; next 1.1; 1.1 date 2002.06.01.06.28.06; author grant; state Exp; branches; next ; 1.4.18.1 date 2008.09.18.04.30.16; author wrstuden; state Exp; branches; next ; 1.2.2.1 date 2002.06.01.09.21.11; author lukem; state dead; branches; next 1.2.2.2; 1.2.2.2 date 2002.06.04.12.10.53; author lukem; state Exp; branches; next 1.2.2.3; 1.2.2.3 date 2002.06.04.12.15.00; author lukem; state Exp; branches; next ; 1.2.4.1 date 2002.06.01.09.21.11; author he; state dead; branches; next 1.2.4.2; 1.2.4.2 date 2002.06.26.17.21.39; author he; state Exp; branches; next ; desc @@ 1.8 log @Document file format better. From Travis Paul and Matthew Bauer. Bump date. Addresses PR 50787. @ text @.\" $NetBSD: usermgmt.conf.5,v 1.7 2009/12/31 20:14:19 wiz Exp $ .\" .\" Copyright (c) 2002 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This document is derived from works contributed to The NetBSD Foundation .\" by Grant Beattie. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .Dd February 9, 2016 .Dt USERMGMT.CONF 5 .Os .\" turn off hyphenation .hym 999 .Sh NAME .Nm usermgmt.conf .Nd user management tools configuration file .Sh SYNOPSIS .Nm usermgmt.conf .Sh DESCRIPTION The .Nm usermgmt.conf file defines the default values used by the user management tools, .Xr useradd 8 and friends. .Pp Options in this file can be set by manually editing .Pa /etc/usermgmt.conf or using the .Fl D option to .Xr useradd 8 . .Pp .Bl -tag -width preserveX .It Ic base_dir sets the base directory name, in which new users' home directories are created when using the .Fl m option to .Xr useradd 8 . .It Ic class sets the default login class for new users. See .Xr login.conf 5 for more information on user login classes. .It Ic expire sets the default time at which the current password expires. This can be used to implement password aging. Both the .Ar expire and .Ar inactive fields should be entered in the form .Dq month day year , where month is the month name (the first three characters are sufficient), day is the day of the month, and year is the year. Time in seconds since the epoch (UTC) is also valid. A value of 0 can be used to disable this feature. .It Ic group sets the default primary group for new users. If this is .Ql =uid , then a uid and gid will be picked which are both unique and the same, and a line will be added to .Pa /etc/group to describe the new group. It has the format: .br .Bd -ragged -offset indent -compact .Ic group .Ar gid | name | Li =uid .Ed .It Ic homeperm sets the default permissions of the newly created home directory if .Fl m is given to .Xr useradd 8 . The permission is specified as an octal number, with or without a leading zero. .It Ic inactive sets the default time at which new accounts expire. A value of 0 can be used to disable this feature. Also see the .Ar expire field. .It Ic password specifies an already-encrypted default password. .It Ic preserve If this value is one of .Ql true , .Ql yes , or a non-zero number, then the user login information will be preserved when removing a user with .Xr userdel 8 . .It Ic range specifies the uid boundaries for new users. If unspecified, the default is .Dq 1000..60000 . It has the format: .Bd -unfilled -offset indent -compact .Ic range Ar starting-uid Ns Li .. Ns Ar ending-uid .Ed .It Ic gid_range specifies the gid boundaries for new groups. If unspecified, the default is .Dq 1000..60000 . It has the format: .Bd -unfilled -offset indent -compact .Ic gid_range Ar starting-gid Ns Li .. Ns Ar ending-gid .Ed .It Ic shell sets the default login shell for new users. .It Ic skel_dir sets the default skeleton directory in which to find files with which to populate the new user's home directory. .El .Ss SYNTAX The .Nm file uses a simple syntax format. Each line must contain one option. That option must be in the front of the line (no spaces). Any number of white spaces such as ' ' and '\et' may follow. The line ends with a list of options from each. .Sh FILES .Bl -tag -width /etc/usermgmt.conf -compact .It Pa /etc/usermgmt.conf .It Pa /etc/skel/* .It Pa /etc/login.conf .El .Sh EXAMPLES .Bd -unfilled -offset indent -compact group wheel base_dir /home/ skel_dir /etc/skel shell /bin/sh inactive 0 .Ed .Sh SEE ALSO .Xr login.conf 5 , .Xr passwd 5 , .Xr user 8 , .Xr useradd 8 , .Xr userdel 8 , .Xr usermod 8 .Sh HISTORY The .Nm configuration file first appeared in .Nx 1.5 . @ 1.7 log @Bump date for gid_range. @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.6 2009/12/31 19:59:31 mlelstv Exp $ d32 1 a32 1 .Dd December 31, 2009 d138 8 d152 8 @ 1.6 log @Add new keyword gid_range to usermgmt.conf which specifies a default GID range for groupadd(8). @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.5 2008/07/18 21:03:03 apb Exp $ d32 1 a32 1 .Dd July 18, 2008 @ 1.5 log @man page fixes from PR 39164. @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.4 2006/10/07 09:20:07 elad Exp $ d124 8 @ 1.4 log @PR/30351: Hubert Feyrer: useradd(8) doesn't allow setting permissions of new home [patch] Adapted to current code and some nits from myself. Thanks for the patch! @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.3 2002/10/02 13:49:11 grant Exp $ d32 1 a32 1 .Dd October 7, 2006 d86 1 a86 1 and the same, and a line added to d88 2 a89 1 to describe the new group. It has the format: @ 1.4.18.1 log @Sync with wrstuden-revivesa-base-2. @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.4 2006/10/07 09:20:07 elad Exp $ d32 1 a32 1 .Dd July 18, 2008 d86 1 a86 1 and the same, and a line will be added to d88 1 a88 2 to describe the new group. It has the format: @ 1.3 log @new sentence, new line. @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.2 2002/06/01 09:21:11 wiz Exp $ d32 1 a32 1 .Dd May 28, 2002 d94 6 @ 1.2 log @Widen tag for list. @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.1 2002/06/01 06:28:06 grant Exp $ d69 3 a71 2 sets the default time at which the current password expires. This can be used to implement password aging. Both the d78 2 a79 2 sufficient), day is the day of the month, and year is the year. Time in seconds since the epoch (UTC) is also valid. @ 1.2.4.1 log @file usermgmt.conf.5 was added on branch netbsd-1-5 on 2002-06-26 17:21:39 +0000 @ text @d1 139 @ 1.2.4.2 log @Pull up revisions 1.1 (new, requested by grant): Synchronize with recent developments: o add usermgmt.conf manual page o accept "month day year" for -e and -f option arguments of ``user'' o support multiple uid ranges o fix skeleton directory changes o improve error handling o fix varargs usage @ text @a0 139 .\" $NetBSD: usermgmt.conf.5,v 1.2.4.1 2002/06/26 17:21:39 he Exp $ .\" .\" Copyright (c) 2002 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This document is derived from works contributed to The NetBSD Foundation .\" by Grant Beattie. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .Dd May 28, 2002 .Dt USERMGMT.CONF 5 .Os .\" turn off hyphenation .hym 999 .Sh NAME .Nm usermgmt.conf .Nd user management tools configuration file .Sh SYNOPSIS .Nm usermgmt.conf .Sh DESCRIPTION The .Nm usermgmt.conf file defines the default values used by the user management tools, .Xr useradd 8 and friends. .Pp Options in this file can be set by manually editing .Pa /etc/usermgmt.conf or using the .Fl D option to .Xr useradd 8 . .Pp .Bl -tag -width preserveX .It Ic base_dir sets the base directory name, in which new users' home directories are created when using the .Fl m option to .Xr useradd 8 . .It Ic class sets the default login class for new users. See .Xr login.conf 5 for more information on user login classes. .It Ic expire sets the default time at which the current password expires. This can be used to implement password aging. Both the .Ar expire and .Ar inactive fields should be entered in the form .Dq month day year , where month is the month name (the first three characters are sufficient), day is the day of the month, and year is the year. Time in seconds since the epoch (UTC) is also valid. A value of 0 can be used to disable this feature. .It Ic group sets the default primary group for new users. If this is .Ql =uid , then a uid and gid will be picked which are both unique and the same, and a line added to .Pa /etc/group to describe the new group. It has the format: .br .Bd -ragged -offset indent -compact .Ic group .Ar gid | name | Li =uid .Ed .It Ic inactive sets the default time at which new accounts expire. A value of 0 can be used to disable this feature. Also see the .Ar expire field. .It Ic password specifies an already-encrypted default password. .It Ic preserve If this value is one of .Ql true , .Ql yes , or a non-zero number, then the user login information will be preserved when removing a user with .Xr userdel 8 . .It Ic range specifies the uid boundaries for new users. If unspecified, the default is .Dq 1000..60000 . It has the format: .Bd -unfilled -offset indent -compact .Ic range Ar starting-uid Ns Li .. Ns Ar ending-uid .Ed .It Ic shell sets the default login shell for new users. .It Ic skel_dir sets the default skeleton directory in which to find files with which to populate the new user's home directory. .El .Sh FILES .Bl -tag -width /etc/usermgmt.conf -compact .It Pa /etc/usermgmt.conf .It Pa /etc/skel/* .It Pa /etc/login.conf .El .Sh SEE ALSO .Xr login.conf 5 , .Xr passwd 5 , .Xr user 8 , .Xr useradd 8 , .Xr userdel 8 , .Xr usermod 8 .Sh HISTORY The .Nm configuration file first appeared in .Nx 1.5 . @ 1.2.2.1 log @file usermgmt.conf.5 was added on branch netbsd-1-6 on 2002-06-04 12:10:53 +0000 @ text @d1 139 @ 1.2.2.2 log @Pull up revision 1.1 (requested by grant in ticket #134): add usermgmt.conf man page. user -e and -f now accepts "month day year" (ala chpass(1)) and seconds-since-epoch. correct man pages accordingly. @ text @a0 139 .\" $NetBSD: usermgmt.conf.5,v 1.2.2.1 2002/06/04 12:10:53 lukem Exp $ .\" .\" Copyright (c) 2002 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This document is derived from works contributed to The NetBSD Foundation .\" by Grant Beattie. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .Dd May 28, 2002 .Dt USERMGMT.CONF 5 .Os .\" turn off hyphenation .hym 999 .Sh NAME .Nm usermgmt.conf .Nd user management tools configuration file .Sh SYNOPSIS .Nm usermgmt.conf .Sh DESCRIPTION The .Nm usermgmt.conf file defines the default values used by the user management tools, .Xr useradd 8 and friends. .Pp Options in this file can be set by manually editing .Pa /etc/usermgmt.conf or using the .Fl D option to .Xr useradd 8 . .Pp .Bl -tag -width Ds .It Ic base_dir sets the base directory name, in which new users' home directories are created when using the .Fl m option to .Xr useradd 8 . .It Ic class sets the default login class for new users. See .Xr login.conf 5 for more information on user login classes. .It Ic expire sets the default time at which the current password expires. This can be used to implement password aging. Both the .Ar expire and .Ar inactive fields should be entered in the form .Dq month day year , where month is the month name (the first three characters are sufficient), day is the day of the month, and year is the year. Time in seconds since the epoch (UTC) is also valid. A value of 0 can be used to disable this feature. .It Ic group sets the default primary group for new users. If this is .Ql =uid , then a uid and gid will be picked which are both unique and the same, and a line added to .Pa /etc/group to describe the new group. It has the format: .br .Bd -ragged -offset indent -compact .Ic group .Ar gid | name | Li =uid .Ed .It Ic inactive sets the default time at which new accounts expire. A value of 0 can be used to disable this feature. Also see the .Ar expire field. .It Ic password specifies an already-encrypted default password. .It Ic preserve If this value is one of .Ql true , .Ql yes , or a non-zero number, then the user login information will be preserved when removing a user with .Xr userdel 8 . .It Ic range specifies the uid boundaries for new users. If unspecified, the default is .Dq 1000..60000 . It has the format: .Bd -unfilled -offset indent -compact .Ic range Ar starting-uid Ns Li .. Ns Ar ending-uid .Ed .It Ic shell sets the default login shell for new users. .It Ic skel_dir sets the default skeleton directory in which to find files with which to populate the new user's home directory. .El .Sh FILES .Bl -tag -width /etc/usermgmt.conf -compact .It Pa /etc/usermgmt.conf .It Pa /etc/skel/* .It Pa /etc/login.conf .El .Sh SEE ALSO .Xr login.conf 5 , .Xr passwd 5 , .Xr user 8 , .Xr useradd 8 , .Xr userdel 8 , .Xr usermod 8 .Sh HISTORY The .Nm configuration file first appeared in .Nx 1.5 . @ 1.2.2.3 log @Pull up revision 1.2 (requested by grant in ticket #134): Widen tag for list. @ text @d1 1 a1 1 .\" $NetBSD: usermgmt.conf.5,v 1.2.2.2 2002/06/04 12:15:00 lukem Exp $ d56 1 a56 1 .Bl -tag -width preserveX @ 1.1 log @add usermgmt.conf man page. user -e and -f now accepts "month day year" (ala chpass(1)) and seconds-since-epoch. correct man pages accordingly. @ text @d1 1 a1 1 .\" $NetBSD$ d56 1 a56 1 .Bl -tag -width Ds @