USERMGMT.CONF(5) | File Formats Manual | 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.

February 9, 2016 | NetBSD 11.0