passmgmt(1M) 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 com-
mand. 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.
OPTIONS
-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
Page 1 Reliant UNIX 5.44 Printed 11/98
passmgmt(1M) passmgmt(1M)
interpreted as /usr/bin/sh.
-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.
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.
FILES
/etc/passwd
/etc/shadow
/etc/opasswd
/etc/oshadow
SEE ALSO
passwd(1), useradd(1M), userdel(1M), usermod(1M), passwd(4), sha-
dow(4).
Page 2 Reliant UNIX 5.44 Printed 11/98