PASSMGMT(1M)        RISC/os Reference Manual         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.  If there is no /etc/shadow, the changes done
     by passmgmt will only go to /etc/passwd.

     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 pass-
     word files. It will not remove any files that the user owns
     on the system; they must be removed manually.

     The following options are available:

     -ccomment      A short description of the login. It is lim-
                    ited to a maximum of 128 characters and
                    defaults to an empty field.

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

     -uuid          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.

     -ggid          GID of the name.  This number must range from



                        Printed 11/19/92                   Page 1

PASSMGMT(1M)        RISC/os Reference Manual         PASSMGMT(1M)



                    0 to the maximum non-negative value for the
                    system. The default is 1.

     -sshell        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 /bin/sh.

     -llogname      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
     passwd(4) in the System Aministrator'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).

NOTE
     You cannot use a colon or <cr> as part of an argument
     because it will be interpreted as a field separator in the
     password file.






 Page 2                 Printed 11/19/92