passmgmt(1M)                     UNIX System V                     passmgmt(1M)


NAME
      passmgmt - password files management

SYNOPSIS
      passmgmt -a options name
      passmgmt -m options name
      passmgmt -d name

DESCRIPTION
      The passmgmt command updates information in the password files.  This
      command works with both /etc/passwd and /etc/shadow.

      passmgmt -a adds an entry for user name to the password files.  This
      command does not create any directory for the new user and the new login
      remains locked (with the string *LK* in the password field) until the
      passwd(1) command is executed to set the password.

      passmgmt -m modifies the entry for user name in the password files.  The
      name field in the /etc/shadow entry and all the fields (except the
      password field) in the /etc/passwd entry can be modified by this command.
      Only fields entered on the command line will be modified.

      passmgmt -d deletes the entry for user name from the password files.  It
      will not remove any files that the user owns on the system; they must be
      removed manually.

      The following options are available:

      -c comment  A short description of the login.  It is limited to a maximum
                  of 128 characters and defaults to an empty field.

      -h homedir  Home directory of name.  It is limited to a maximum of 256
                  characters and defaults to /usr/name.

      -u uid      UID of the name.  This number must range from 0 to the
                  maximum non-negative value for the system.  It defaults to
                  the next available UID greater than 99.  Without the -o
                  option, it enforces the uniqueness of a UID.

      -o          This option allows a UID to be non-unique.  It is used only
                  with the -u option.

      -g gid      GID of the name.  This number must range from 0 to the
                  maximum non-negative value for the system.  The default is 1.

      -s shell    Login shell for name.  It should be the full pathname of the
                  program that will be executed when the user logs in.  The
                  maximum size of shell is 256 characters. The default is for
                  this field to be empty and to be interpreted as /usr/bin/sh.





10/89                                                                    Page 1

passmgmt(1M)                     UNIX System V                     passmgmt(1M)


      -l logname  This option changes the name to logname.  It is used only
                  with the -m option.

      The total size of each login entry is limited to a maximum of 511 bytes
      in each of the password files.

FILES
      /etc/passwd,
      /etc/shadow,
      /etc/opasswd,
      /etc/oshadow

SEE ALSO
      useradd(1M), userdel(1M), usermod(1M), passwd(4), and shadow(4) in the
      System Administrator's Reference Manual
      passwd(1) in the User's Reference Manual

DIAGNOSTICS
      The passmgmt command exits with one of the following values:

      0         Success.

      1         Permission denied.

      2         Invalid command syntax.  Usage message of the passmgmt command
                will be displayed.

      3         Invalid argument provided to option.

      4         UID in use.

      5         Inconsistent password files (e.g., name is in the /etc/passwd
                file and not in the /etc/shadow file, or vice versa).

      6         Unexpected failure.  Password files unchanged.

      7         Unexpected failure.  Password file(s) missing.

      8         Password file(s) busy.  Try again later.

      9         name does not exist (if -m or -d is specified), already exists
                (if -a is specified), or logname already exists (if -m -l is
                specified).

NOTES
      You cannot use a colon or carriage return as part of an argument because
      it is interpreted as a field separator in the password file.

      This command will be removed in a future release.  Its functionality has
      been replaced and enhanced by useradd, userdel, and usermod.  These
      commands are currently available.



Page 2                                                                    10/89