passmgmt(1M)						  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 password 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
		       argument is a date entered using one of the date formats included in the template file /etc/datemsk. See getdate(3C).

       -f inactive     The maximum number of days allowed between uses of a login ID before that ID is declared invalid. Normal values	are  posi-
		       tive integers. A value of  0 defeats the status.

       -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  user_attr(4),  auth_attr(4),  and  prof_attr(4).	 The  valid key=value pairs are defined in
		       user_attr(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 skel_dir     A directory that contains skeleton information (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 executed when the user logs in. The maxi-
		       mum size of shell is 256 characters. The default is for this field to be empty and to be 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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       passwd(1),   rolemod(1M),   useradd(1M),   userdel(1M),	 usermod(1M),  auth_attr(4),  passwd(4),  prof_attr(4),  shadow(4),  user_attr(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.

       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 speci-
		fied).

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

       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 information supplied by the network  name-
       service.

SunOS 5.10							    9 Mar 2004							      passmgmt(1M)