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

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.

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)