passmgmt(NADM)                                                passmgmt(NADM)


 Name

    passmgmt - password files management

 Syntax

    passmgmt -a options name
    passmgmt -m options name
    passmgmt -d name
    passmgmt -f name
    passmgmt -n name

 Description

    The passmgmt command updates information in the password files.  This
    command works with /etc/passwd.local.

    passmgmt -a adds an entry for user name to the login password files.
    This command does not create any directory for the new user, and there is
    no password, until the passwd(C) or yppasswd(NC) command is executed to
    set the password.

    passmgmt -m modifies the entry for user name in the login password files.
    All the fields in the /etc/passwd.local entry can be modified by this
    command.  Only fields entered on the command line will be modified.

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

    passmgmt -f unlocks the account for user name from the login password
    files.  It will not remove any files that the user owns on the system;
    they must be removed manually.

    passmgmt -n alters the status for networked user name from a networked
    account to a local account.

    name, the login name of the user, must be unique.

    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 max-
                imum value for the system.  It defaults to the next available
                UID greater than 100.  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 max-
                imum 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 length of shell is 256 characters. The default is for
                this field to be empty and to be interpreted as /bin/sh.

    -l logname  This option changes the name to logname for the -m option
                only.

    The total size of each login entry, whether existing or new, is limited
    to a maximum of 511 bytes in the password files.


 Files

    /etc/passwd
    /etc/passwd.local
    /etc/passwd

 See also

    passwd(C), yppasswd(NC), passwd(C)

 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

    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 <Return> because it will be interpreted as a
    field separator.