System Administration Commands 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.
passmgmt can be used only by the super-user.
OPTIONS
-c comment A short description of the login, enclosed
in quotes. It is limited to a maximum of 128
characters and defaults to an empty field.
-e expire Specify the expiration date for a login.
After this date, no user will be able to
access this login. The expire option argu-
ment is a date entered using one of the date
formats included in the template file
/etc/datemsk. See getdate(3C).
SunOS 5.11 Last change: 27 Aug 2007 1
System Administration Commands passmgmt(1M)
-f inactive The maximum number of days allowed between
uses of a login ID before that ID is
declared invalid. Normal values are positive
integers. A value of 0 defeats the status.
Changing the password reactivates an account
for the inactivity period.
-g gid GID of name. This number must range from 0
to the maximum non-negative value for the
system. The default is 1.
-h homedir Home directory of name. It is limited to a
maximum of 256 characters and defaults to
/usr/name.
-K key=value Set a key=value pair. See userattr(4),
authattr(4), and profattr(4). The valid
key=value pairs are defined in userattr(4),
but the "type" key is subject to the
usermod(1M) and rolemod(1M) restrictions.
Multiple key=value pairs may be added with
multiple -K options.
-k skeldir A directory that contains skeleton informa-
tion (such as .profile) that can be copied
into a new user's home directory. This
directory must already exist. The system
provides the /etc/skel directory that can be
used for this purpose.
-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.
-o This option allows a UID to be non-unique.
It is used only with the -u option.
-s shell Login shell for name. It should be the full
pathname of the program that will be exe-
cuted 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
SunOS 5.11 Last change: 27 Aug 2007 2
System Administration Commands passmgmt(1M)
interpreted as /usr/bin/sh.
-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.
FILES
/etc/passwd
/etc/shadow
/etc/opasswd
/etc/oshadow
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
Interface Stability Evolving
SEE ALSO
passwd(1), rolemod(1M), useradd(1M), userdel(1M),
usermod(1M), authattr(4), passwd(4), profattr(4), sha-
dow(4), userattr(4), attributes(5)
EXIT STATUS
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 is displayed.
SunOS 5.11 Last change: 27 Aug 2007 3
System Administration Commands passmgmt(1M)
3 Invalid argument provided to option.
4 UID in use.
5 Inconsistent password files (for example, 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
Do not use a colon (:) or RETURN as part of an argument. It
is interpreted as a field separator in the password file.
The passmgmt command will be removed in a future release.
Its functionality has been replaced and enhanced by useradd,
userdel, and usermod. These commands are currently avail-
able.
This command only modifies password definitions in the local
/etc/passwd and /etc/shadow files. If a network nameservice
such as NIS or NIS] is being used to supplement the local
files with additional entries, passmgmt cannot change infor-
mation supplied by the network nameservice.
SunOS 5.11 Last change: 27 Aug 2007 4
|
