USERMGMT.CONF(5) BSD 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.
FILES
/etc/usermgmt.conf
/etc/skel/*
/etc/login.conf
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.
BSD December 31, 2009 BSD
Check Out this Related Man Page
useradd(8) System Manager's Manual useradd(8)NAME
useradd - create a new user account
SYNOPSIS
useradd [-D binddn] [-P path] [-c comment] [-d homedir]
[-e expire] [-f inactive] [-G group,...] [-g gid]
[-m [-k skeldir]] [-o] [-p password] [-u uid]
[-U umask] [-r] [-s shell] [--service service] [--help]
[--usage] [-v] [--preferred-uid uid] account
useradd --show-defaults
useradd --save-defaults [-d homedir] [-e expire] [-f inactive]
[-g gid] [-G group,...] [-k skeldir] [-U umask] [-s shell]
DESCRIPTION
useradd creates a new user account using the default values from /etc/default/useradd and the specified on the command line. Depending on
the command line options the new account will be added to the system files or LDAP database, the home directory will be created and the
initial default files and directories will be copied.
The account name must begin with an alphabetic character and the rest of the string should be from the POSIX portable character class ([A-
Za-z_][A-Za-z0-9_-.]*[A-Za-z0-9_-.$]).
OPTIONS -c, --comment comment
This option specifies the users finger information.
-d, --home homedir
This option specifies the users home directory. If not specified, the default from /etc/default/useradd is used.
-e, --expire expire
With this option the date when the account will be expired can be changed. expiredate has to be specified as number of days since
January 1st, 1970. The date may also be expressed in the format YYYY-MM-DD. If not specified, the default from /etc/default/useradd
is used.
-f, --inactive inactive
This option is used to set the number of days of inactivity after a password has expired before the account is locked. A user whose
account is locked must contact the system administrator before being able to use the account again. A value of -1 disables this
feature. If not specified, the default from /etc/default/useradd is used.
-G, --groups group,...
With this option a list of supplementary groups can be specified, which the user should become a member of. Each group is separated
from the next one only by a comma, without whitespace. If not specified, the default from /etc/default/useradd is used.
-g, --gid gid
The group name or number of the user's main group. The group name or number must refer to an already existing group. If not speci-
fied, the default from /etc/default/useradd is used.
-k, --skel skeldir
Specify an alternative skel directory. This option is only valid, if the home directory for the new user should be created, too. If
not specified, the default from /etc/default/useradd or /etc/skel is used.
-m, --create-home
Create home directory for new user account.
-o, --non-unique
Allow duplicate (non-unique) User IDs.
-p, --password password
Encrypted password as returned by crypt(3) for the new account. The default is to disable the account.
-U, --umask umask
The permission mask is initialized to this value. It is used by useradd for creating new home directories. The default is taken from
/etc/default/useradd.
-u, --uid uid
Force the new userid to be the given number. This value must be positive and unique. The default is to use the first free ID after
the greatest used one. The range from which the user ID is chosen can be specified in /etc/login.defs.
--preferred-uid uid
Set the new userid to the specified value if possible. If that value is already in use the first free ID will be chosen as described
above.
-r, --system
Create a system account. A system account is an user with an UID between SYSTEM_UID_MIN and SYSTEM_UID_MAX as defined in
/etc/login.defs, if no UID is specified. The GROUPS entry in /etc/default/useradd is ignored, too.
-s, --shell shell
Specify user's login shell. The default for normal user accounts is taken from /etc/default/useradd, the default for system accounts
is /bin/false.
--service service
Add the account to a special directory. The default is files, but ldap is also valid.
-D, --binddn binddn
Use the Distinguished Name binddn to bind to the LDAP directory. The user will be prompted for a password for simple authentica-
tion.
-P, --path path
The passwd and shadow files are located below the specified directory path. useradd will use this files, not /etc/passwd and
/etc/shadow.
--help Print a list of valid options with a short description.
--usage
Print a short list of valid options.
-v, --version
Print the version number and exit.
FILES
/etc/passwd - user account information
/etc/shadow - shadow user account information
/etc/group - group information
/etc/default/useradd - default values for account creation
/etc/skel - directory containing default files
SEE ALSO passwd(1), login.defs(5), passwd(5), shadow(5), userdel(8), usermod(8)AUTHOR
Thorsten Kukuk <kukuk@suse.de>
pwdutils May 2010 useradd(8)