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.  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 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(1M) command 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 maximum 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. 

−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 INTER­ACTIVE SDS Guide and Programmer’s Reference Manual. 

DIAGNOSTICS

The passmgmt command exits with one of the following values:

0SUCCESS. 

1Permission denied. 

2Invalid command syntax.  Usage message of the passmgmt command will be displayed. 

3Invalid argument provided to option. 

4UID in use. 

5Inconsistent password files (e.g., name is in the /etc/passwd file and not in the /etc/shadow file, or vice versa). 

6Unexpected failure.  Password files unchanged. 

7Unexpected failure.  Password file(s) missing. 

8Password file(s) busy.  Try again later. 

9name does not exist (if −m or −d is specified), 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 interpreted as a field separator. 

ADDED VALUE

This entry, supplied by INTERACTIVE Systems Corporation, contains enhancements to UNIX System V. 

\*U  —  Version 1.0