### cimauth

#### Name

> cimauth

> - add, modify, remove or list CIM user authorizations.

#### Synopsis

> `

> cimauth

> -a -u username -n namespace [ -R ] [ -W ]

> cimauth

> -m -u username -n namespace [ -R ] [ -W ]

> cimauth

> -r -u username [ -n namespace ]

> cimauth

> -l

> cimauth

> -h

> cimauth

> --help

> cimauth

> --version`

#### Remarks

> This command does not configure or list CIM user password information (see cimuser (1M)).

#### Description

> The cimauth command provides a command line interface to manage CIM user authorizations.

> The first form of cimauth allows addition of authorizations to a specified user on a specified namespace. This forms of the command can only be used to add authorizations to one user on one namespace at a time.

> The second form of cimauth allows modification of existing authorizations for the specified user on a specified namespace. This forms of the command can only be used to modify authorizations to one user on one namespace at a time.

> If there are no authorizations specified with add and modify options, read authorization is assumed by default.

> The third form of cimauth allows removal of authorizations for the specified user on a specified namespace. This forms of the command can be used to remove authorizations of one user on one namespace or all the namespaces on which the user has authorizations. If no namespace is specified, then authorizations on all the namespaces for the specified user will be removed.

> The last form of this command allows listing of the user name, namespace and authorizations.

> Specifying no options with the cimauth will show the usage of the command.

#### Options

> The cimauth command recognizes the following options:

> `

> -a

> ` Indicates that authorizations to be added for a user on a namespace. `

> -m

> ` Indicates that authorizations to be modified for a user on a namespace. `

> -r

> ` Indicates that authorizations to be removed for a user on a namespace. `

> -l

> ` Displays the authorizations of all the authorized users. `

> -u

> ` `username` Indicates a specific user name. `

> -n

> ` `namespace` Indicates a specific namespace. `

> -R

> ` Indicates read authorization. `

> -W

> ` Indicates write authorization. `

> -h, --help

> ` Display the help message `

> --version

> ` Display CIM Server version number

#### Return Values

> cimauth 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 read and write authorizations to user "guest" on namespace "/root/system".

> `

> cimauth

> -a -u guest -n root/system -R -W`

> The following command adds read authorizations to user "guest" on namespace "/root/cimv2".

> `

> cimauth

> -a -u guest -n root/cimv2`

> The following command modifies authorizations of the user "guest" on namespace "/root/system" to read only.

> `

> cimauth

> -m -u guest -n root/system -R`

> The following command removes the authorizations for user "guest" on namespace "root/system".

> `

> cimauth

> -r -u guest -n root/system`

> The following command displays the list of authorized user names, namespaces and authorizations.

> `

> cimauth

> -l`

#### Author

> cimauth

> was developed by the Hewlett-Packard Company.

#### See Also

> cimuser (1M)