cimuser

Name

cimuser - add, modify, remove or list CIM users.

Synopsis

cimuser -a -u username [ -w password ]

cimuser -m -u username [ -w password ] [ -n newpassword ]

cimuser -r -u username

cimuser -l

Remarks

           This command can be executed by privileged user(s) only.
 
Limitations
This command can be executed to add/remove/modify one user at a time.

Description

The cimuser command provides a command line interface to manage CIM users. The default location of the CIM password file is, <$PEGASUS_HOME>/cimserver.passwd. The location of the password file can be configured by setting the passwordFilePath property.

The first form of cimuser allows addition of a new CIM user. CIM users must be valid users on the local system. If the password is not specified at the command line, the user will be prompted for it. If more than 8 characters are entered for the password, then the first eight characters will be used. There is no default authorization permissions set for newly added users. For more information on adding authorization information see cimauth (1M).

The second form allows modification of the specified CIM user's password.  If the old or new password is not specified at the command line, the user will be prompted for it. If more than 8 characters are entered for the password, then the first eight characters will be used.

The third form allows removal of the specified CIM user. Any authorizations for the specified user will be deleted.

The last form of this command allows CIM user names to be listed.

Specifying no options with the cimuser command will display the command usage.

Options

The cimuser command recognizes the following options:
-a                           Indicates that a CIM user is to be added.

-m                           Indicates that a CIM user's password  is to be modified.

-r                           Indicates that a CIM user is to be removed.

-l                           Displays the names of the CIM users.

-u username          Indicates a specific user name.

-w password          Indicates the password for the specified user name.

-n newpassword    Indicates the new password for the specified user name.

Return Values

cimuser returns one of the following values:
0         Successful completion.

1         Error

When an error occurs, an explanatory error message is written to stderr and an error value 1 is returned.

Examples

The following command adds user "guest", a new CIM user. The password for this user is "guest".
cimuser -a -u guest -w guest

The following command adds user "guest", a new CIM user. Since the password is not specified on the command line, the user will be prompted for it.

cimuser -a -u guest
Please enter your password:
Please re-enter your password:

The following command modifies the password  for user "guest", with the new password "bar".
cimuser -m -u guest -w foo -n bar
The following command removes the CIM user "guest".
cimuser -r -u guest
The following command displays the list of CIM user names.
cimuser -l

Author

cimuser was developed by the Hewlett-Packard Company.

See Also

cimauth (1M) cimconfig(1M)