1.\" $OpenBSD: usermgmt.conf.5,v 1.14 2016/11/30 20:26:37 jmc Exp $ 2.\" $NetBSD: usermgmt.conf.5,v 1.3 2002/10/02 13:49:11 grant Exp $ 3.\" 4.\" Copyright (c) 2002 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" This document is derived from works contributed to The NetBSD Foundation 8.\" by Grant Beattie. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 3. The name of the author may not be used to endorse or promote products 19.\" derived from this software without specific prior written permission. 20.\" 21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 22.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 26.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 27.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.Dd $Mdocdate: November 30 2016 $ 34.Dt USERMGMT.CONF 5 35.Os 36.Sh NAME 37.Nm usermgmt.conf 38.Nd user management tools configuration file 39.Sh DESCRIPTION 40The 41.Nm usermgmt.conf 42file defines the default values used by the user management tools, 43.Xr user 8 . 44.Pp 45Options in this file can be set by manually editing 46.Pa /etc/usermgmt.conf 47or using the 48.Fl D 49option to 50.Xr useradd 8 . 51.Bl -tag -width preserveX 52.It Ic base_dir 53Sets the base directory name, in which new users' home directories 54are created when using the 55.Fl m 56option to 57.Xr useradd 8 . 58.It Ic class 59Sets the default login class for new users. 60See 61.Xr login.conf 5 62for more information on user login classes. 63.It Ic expire 64Sets the default time at which the new accounts expire. 65Both the 66.Ar expire 67and 68.Ar inactive 69fields should be entered in the form 70.Dq month day year , 71where month is the month name (the first three characters are 72sufficient), day is the day of the month, and year is the year. 73Time in seconds since the Epoch (UTC) is also valid. 74A value of 0 can be used to disable this feature. 75.It Ic group 76Sets the default primary group for new users. 77If this is the special string 78.Cm =uid , 79a group is created with the same numeric ID as the UID; 80if such a group already exists a warning is given 81and no group is created. 82It has the format: 83.Bd -ragged -offset indent 84.Ic group 85.Ar gid | name | Cm =uid 86.Ed 87.It Ic inactive 88Sets the default time at which the passwords of new accounts expire. 89A value of 0 can be used to disable this feature. 90Also see the 91.Ar expire 92field. 93.It Ic password 94Specifies a default password encrypted with 95.Xr encrypt 1 . 96.It Ic preserve 97If this value is one of 98.Ql true , 99.Ql yes , 100or a non-zero number, then the user login information will be 101preserved when removing a user with 102.Xr userdel 8 . 103.It Ic range 104Specifies the UID boundaries for new users. 105If unspecified, the default is 106.Dq 1000..60000 . 107It has the format: 108.Bd -unfilled -offset indent 109.Ic range Ar starting-uid Ns Li .. Ns Ar ending-uid 110.Ed 111.It Ic shell 112Sets the default login shell for new users. 113.It Ic skel_dir 114Sets the default skeleton directory in which to find files 115with which to populate the new user's home directory. 116.El 117.Sh FILES 118.Bl -tag -width /etc/usermgmt.conf -compact 119.It Pa /etc/usermgmt.conf 120.It Pa /etc/skel/* 121.It Pa /etc/login.conf 122.El 123.Sh SEE ALSO 124.Xr login.conf 5 , 125.Xr passwd 5 , 126.Xr user 8 , 127.Xr useradd 8 , 128.Xr userdel 8 , 129.Xr usermod 8 130.Sh STANDARDS 131Other implementations of the 132.Xr user 8 133utilities use the 134.Ar inactive-time 135parameter to refer to the maximum number of days allowed between logins (this 136is used to lock "stale" accounts that have not been used for a period of time). 137However, on 138.Ox 139systems this parameter refers instead to the password change time. 140This is due to differences in the 141.Xr passwd 5 142database compared to other operating systems. 143.Sh HISTORY 144The 145.Nm 146configuration file first appeared in 147.Ox 2.7 . 148