PASSMGMT(1M) INTERACTIVE UNIX System PASSMGMT(1M)
NAME
passmgmt - password files management
SYNOPSIS
passmgmt -a options name
passmgmt -m options name
passmgmt -d name
DESCRIPTION
The passmagmt command updates information in the password
files. This command works with both /etc/passwd and
/etc/shadow. If there is no shadow password file the
changes done by passmgmt will go in /etc/passwd.
passmgmt -a adds an entry for user name to the login pass-
word 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(1M) com-
mand is executed to set the password.
passmgmt -m modifies the entry for user name in the login
password files. The name field in the /etc/shadow entry and
all the fields (except the password field) in the
/etc/password entry can be modified by this command. Only
fields entered on the command line will be modified. If
there is no /etc/shadow file, all modifications are made in
/etc/passwd.
passmgmt -d deletes the entry 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.
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 max-
imum of 256 characters and defaults to
/usr/name.
-u uid UID of the name. This number must range from 0
to the maximum 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.
Rev. Base System Page 1
PASSMGMT(1M) INTERACTIVE UNIX System PASSMGMT(1M)
-g gid GID of the name. This number must range from 0
to the maximum 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/shadow
/etc/opasswd
/etc/oshadow
SEE ALSO
passwd(1), passwd(1M).
passwd(4) in the INTERACTIVE SDS Guide and Programmer'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),
Rev. Base System Page 2
PASSMGMT(1M) INTERACTIVE UNIX System PASSMGMT(1M)
already exists (if -a is specified), or logname
already exists (if -m -l is specified).
NOTE
You cannot use a colon or <cr> because it will be inter-
preted as a field separator.
Rev. Base System Page 3