### 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`

> `cimuser -h`

> `cimuser --help`

> `cimuser --version`

#### 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` new`password` Indicates the new password for the specified user name.

> -h, --help Display this help message.

> --version Display CIM Server version number.

#### 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)