| USERMOD(8) | System Manager's Manual | USERMOD(8) | 
usermod —
| usermod | [ -FmoSv] [-Cyes/no] [-ccomment] [-dhome-dir] [-eexpiry-time] [-finactive-time] [-Gsecondary-group] [-ggid | name |=uid] [-Llogin-class] [-lnew-login] [-ppassword] [-sshell] [-uuid] 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.-SEXTENSIONS.-s
    shell-u
    uid-vEXTENSIONS.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 |