1*4fb31a24Sjmc.\" $OpenBSD: usermgmt.conf.5,v 1.2 2003/06/15 06:40:15 jmc Exp $ 28124f21aSmillert.\" $NetBSD: usermgmt.conf.5,v 1.3 2002/10/02 13:49:11 grant Exp $ 38124f21aSmillert.\" 48124f21aSmillert.\" Copyright (c) 2002 The NetBSD Foundation, Inc. 58124f21aSmillert.\" All rights reserved. 68124f21aSmillert.\" 78124f21aSmillert.\" This document is derived from works contributed to The NetBSD Foundation 88124f21aSmillert.\" by Grant Beattie. 98124f21aSmillert.\" 108124f21aSmillert.\" Redistribution and use in source and binary forms, with or without 118124f21aSmillert.\" modification, are permitted provided that the following conditions 128124f21aSmillert.\" are met: 138124f21aSmillert.\" 1. Redistributions of source code must retain the above copyright 148124f21aSmillert.\" notice, this list of conditions and the following disclaimer. 158124f21aSmillert.\" 2. Redistributions in binary form must reproduce the above copyright 168124f21aSmillert.\" notice, this list of conditions and the following disclaimer in the 178124f21aSmillert.\" documentation and/or other materials provided with the distribution. 188124f21aSmillert.\" 3. The name of the author may not be used to endorse or promote products 198124f21aSmillert.\" derived from this software without specific prior written permission. 208124f21aSmillert.\" 218124f21aSmillert.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 228124f21aSmillert.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 238124f21aSmillert.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 248124f21aSmillert.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 258124f21aSmillert.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 268124f21aSmillert.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 278124f21aSmillert.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 288124f21aSmillert.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 298124f21aSmillert.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 308124f21aSmillert.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 318124f21aSmillert.\" SUCH DAMAGE. 328124f21aSmillert.\" 338124f21aSmillert.Dd May 28, 2002 348124f21aSmillert.Dt USERMGMT.CONF 5 358124f21aSmillert.Os 368124f21aSmillert.\" turn off hyphenation 378124f21aSmillert.hym 999 388124f21aSmillert.Sh NAME 398124f21aSmillert.Nm usermgmt.conf 408124f21aSmillert.Nd user management tools configuration file 418124f21aSmillert.Sh SYNOPSIS 428124f21aSmillert.Nm usermgmt.conf 438124f21aSmillert.Sh DESCRIPTION 448124f21aSmillertThe 458124f21aSmillert.Nm usermgmt.conf 468124f21aSmillertfile defines the default values used by the user management tools, 478124f21aSmillert.Xr user 8 . 488124f21aSmillert.Pp 498124f21aSmillertOptions in this file can be set by manually editing 508124f21aSmillert.Pa /etc/usermgmt.conf 518124f21aSmillertor using the 528124f21aSmillert.Fl D 538124f21aSmillertoption to 548124f21aSmillert.Xr useradd 8 . 558124f21aSmillert.Pp 568124f21aSmillert.Bl -tag -width preserveX 578124f21aSmillert.It Ic base_dir 588124f21aSmillertsets the base directory name, in which new users' home directories 598124f21aSmillertare created when using the 608124f21aSmillert.Fl m 618124f21aSmillertoption to 628124f21aSmillert.Xr useradd 8 . 638124f21aSmillert.It Ic class 648124f21aSmillertsets the default login class for new users. 658124f21aSmillertSee 668124f21aSmillert.Xr login.conf 5 678124f21aSmillertfor more information on user login classes. 688124f21aSmillert.It Ic expire 698124f21aSmillertsets the default time at which the current password expires. 708124f21aSmillertThis can be used to implement password aging. 718124f21aSmillertBoth the 728124f21aSmillert.Ar expire 738124f21aSmillertand 748124f21aSmillert.Ar inactive 758124f21aSmillertfields should be entered in the form 768124f21aSmillert.Dq month day year , 778124f21aSmillertwhere month is the month name (the first three characters are 788124f21aSmillertsufficient), day is the day of the month, and year is the year. 798124f21aSmillertTime in seconds since the epoch (UTC) is also valid. 808124f21aSmillertA value of 0 can be used to disable this feature. 818124f21aSmillert.It Ic group 828124f21aSmillertsets the default primary group for new users. 838124f21aSmillertIf this is 848124f21aSmillert.Ql =uid , 85*4fb31a24Sjmcthen a UID and GID will be picked which are both unique 868124f21aSmillertand the same, and a line added to 878124f21aSmillert.Pa /etc/group 88*4fb31a24Sjmcto describe the new group. 89*4fb31a24SjmcIt has the format: 90*4fb31a24Sjmc.Pp 918124f21aSmillert.Bd -ragged -offset indent -compact 928124f21aSmillert.Ic group 938124f21aSmillert.Ar gid | name | Li =uid 948124f21aSmillert.Ed 958124f21aSmillert.It Ic inactive 968124f21aSmillertsets the default time at which new accounts expire. 978124f21aSmillertA value of 0 can be used to disable this feature. 988124f21aSmillertAlso see the 998124f21aSmillert.Ar expire 1008124f21aSmillertfield. 1018124f21aSmillert.It Ic password 1028124f21aSmillertspecifies an already-encrypted default password. 1038124f21aSmillert.It Ic preserve 1048124f21aSmillertIf this value is one of 1058124f21aSmillert.Ql true , 1068124f21aSmillert.Ql yes , 1078124f21aSmillertor a non-zero number, then the user login information will be 1088124f21aSmillertpreserved when removing a user with 1098124f21aSmillert.Xr userdel 8 . 1108124f21aSmillert.It Ic range 111*4fb31a24Sjmcspecifies the UID boundaries for new users. 1128124f21aSmillertIf unspecified, the default is 1138124f21aSmillert.Dq 1000..60000 . 1148124f21aSmillertIt has the format: 1158124f21aSmillert.Bd -unfilled -offset indent -compact 1168124f21aSmillert.Ic range Ar starting-uid Ns Li .. Ns Ar ending-uid 1178124f21aSmillert.Ed 1188124f21aSmillert.It Ic shell 1198124f21aSmillertsets the default login shell for new users. 1208124f21aSmillert.It Ic skel_dir 1218124f21aSmillertsets the default skeleton directory in which to find files 1228124f21aSmillertwith which to populate the new user's home directory. 1238124f21aSmillert.El 1248124f21aSmillert.Sh FILES 1258124f21aSmillert.Bl -tag -width /etc/usermgmt.conf -compact 1268124f21aSmillert.It Pa /etc/usermgmt.conf 1278124f21aSmillert.It Pa /etc/skel/* 1288124f21aSmillert.It Pa /etc/login.conf 1298124f21aSmillert.El 1308124f21aSmillert.Sh SEE ALSO 1318124f21aSmillert.Xr login.conf 5 , 1328124f21aSmillert.Xr passwd 5 , 1338124f21aSmillert.Xr user 8 , 1348124f21aSmillert.Xr useradd 8 , 1358124f21aSmillert.Xr userdel 8 , 1368124f21aSmillert.Xr usermod 8 1378124f21aSmillert.Sh HISTORY 1388124f21aSmillertThe 1398124f21aSmillert.Nm 1408124f21aSmillertconfiguration file first appeared in 1418124f21aSmillert.Ox 2.7 . 142