USERMOD(8) | System Manager's Manual | USERMOD(8) |
usermod
—
usermod |
[-FmoSv ] [-C
yes/no] [-c
comment] [-d
home-dir] [-e
expiry-time] [-f
inactive-time] [-G
secondary-group] [-g
gid | name |
=uid ] [-L
login-class] [-l
new-login] [-p
password] [-s
shell] [-u
uid] user |
usermod
utility modifies user login information on
the system.
Default values are taken from the information provided in the /etc/usermgmt.conf file, which, if running as root, is created using the built-in defaults if it does not exist.
See user(8) for more
information about EXTENSIONS
.
After setting any defaults, and then reading values from /etc/usermgmt.conf, the following command line options are processed:
-C
yes/no-c
comment-d
home-directory-m
option is specified, tries to move the old home
directory to home-directory.-e
expiry-time-F
-f
inactive-time-e
option.-G
secondary-group-g
gid | name |
=uid
=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.
This value can be preset for all users by using the
group field in the
/etc/usermgmt.conf file. See
usermgmt.conf(5) for
more details.-L
login-classEXTENSIONS
.-l
new-user.
’,
‘-
’, and
‘_
’.-m
-d
is not specified, the
new-user argument of the -l
option is used; one of -d
and
-l
is needed.-o
-p
passwordEXTENSIONS
.-S
EXTENSIONS
.-s
shell-u
uid-v
EXTENSIONS
.Once the information has been verified,
usermod
uses
pwd_mkdb(8) to update the
user database. This is run in the background. At very large sites this can
take several minutes. Until this update is completed, the password file is
unavailable for other updates and the new information is not available to
programs.
usermod
utility exits 0 on success,
and >0 if an error occurs.
usermod
utility first appeared in
NetBSD 1.5. It is based on the
addnerd package by the same author.
usermod
utility was written by
Alistair G. Crooks ⟨agc@NetBSD.org⟩.
January 13, 2009 | NetBSD 9.4 |