USERMGMT.CONF(5)

NAME
usermgmt.conf - user management tools configuration file

SYNOPSIS
usermgmt.conf

DESCRIPTION
The usermgmt.conf file defines the default values used by the user management tools, useradd(8) and friends.

Options in this file can be set by manually editing /etc/usermgmt.conf or using the -D option to useradd(8).

base_dir
    sets the base directory name, in which new users' home directories are created when using the -m option to useradd(8).

class
    sets the default login class for new users. See login.conf(5) for more information on user login classes.

expire
    sets the default time at which the current password expires. This can be used to implement password aging. Both the expire and inactive fields should be entered in the form “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.

group
    sets the default primary group for new users. If this is ‘=uid’, then a uid and gid will be picked which are both unique and the same, and a line will be added to /etc/group to describe the new group. It has the format:
    group gid | name | =uid

homeperm
    sets the default permissions of the newly created home directory if -m is given to useradd(8). The permission is specified as an octal number, with or without a leading zero.

inactive
    sets the default time at which new accounts expire. A value of 0 can be used to disable this feature. Also see the expire field.

password
    specifies an already-encrypted default password.

preserve
    If this value is one of ‘true’, ‘yes’, or a non-zero number, then the user login information will be preserved when removing a user with userdel(8).

range
    specifies the uid boundaries for new users. If unspecified, the default is “1000..60000”. It has the format:
        range starting-uid..ending-uid

gid_range
    specifies the gid boundaries for new groups. If unspecified, the default is “1000..60000”. It has the format:
        gid_range starting-gid..ending-gid

shell
    sets the default login shell for new users.

skel_dir
    sets the default skeleton directory in which to find files with which to populate the new user's home directory.

  SYNTAX
The usermgmt.conf 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 '\t' may follow. The line ends with a list of options from each.

FILES
/etc/usermgmt.conf
/etc/skel/*
/etc/login.conf

EXAMPLES
    group     wheel
    base_dir  /home/
    skel_dir  /etc/skel
    shell     /bin/sh
    inactive  0

SEE ALSO
login.conf(5), passwd(5), user(8), useradd(8), userdel(8), usermod(8)

HISTORY
The usermgmt.conf configuration file first appeared in NetBSD 1.5.