passmgmt(1M) MISC. REFERENCE MANUAL PAGES 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 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:
-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 non-negative value for the sys-
tem. 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 sys-
tem. The default is 1.
Last change: 1
passmgmt(1M) MISC. REFERENCE MANUAL PAGES passmgmt(1M)
-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.
-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 sha-
dow(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).
Last change: 2
passmgmt(1M) MISC. REFERENCE MANUAL PAGES passmgmt(1M)
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 func-
tionality has been replaced and enhanced by useradd, user-
del, and usermod. These commands are currently available.
Last change: 3