cimauth

cimauth(8)							   cimauth(8)



NAME
       cimauth - add, modify, remove, or list CIM namespace authorizations of
       users

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


DESCRIPTION
       The cimauth command manages read and write  CIM	namespace  authoriza-
       tions  of users. The operations are executed on the local host by sub-
       mitting requests to the CIM Server.  If the value of the configuration
       property	  enableNamespaceAuthorization	is  True  ,  the  CIM  Server
       restricts access to namespaces based on user authorizations configured
       via  cimauth .  Changes to "Dynamic" authorization parameters does not
       require the CIM Server to be restarted.	"Non  Dynamic"	configuration
       properties  (E.g.  enableNamespaceAuthorization	)  can only be set as
       planned configuration and the CIM Server	 needs	to  be	restarted  to
       realize the change.  (See cimconfig (8) for information on configuring
       the CIM Server.)

   Options
       The cimauth command recognizes the following options:

	      -a	     Adds read and/or  write  authorizations  to  the
			     specified	user  on the specified namespace.  If
			     neither the -R nor the -W option  is  specified,
			     adds a read authorization by default.

	      -h, --help     Display command usage information.

	      -l	     Lists  all	 the authorizations configured in the
			     CIM Server.

	      -m	     Modifies authorizations of the specified user on
			     the  specified namespace.	If neither the -R nor
			     the -W option is specified, modifies the  autho-
			     rization  to be a read authorization by default.

	      -n namespace   Specifies the R namespace for the operation.

	      -r	     Removes authorizations of the specified user  on
			     the  specified  namespace.	 If no namespaces are
			     specified, removes authorizations on all  names-
			     paces for the specified user.

	      -R	     Specifies read authorization on the namespace.

	      -u username    Specifies the user for the operation.  The spec-
			     ified R username must represent a valid user  on
			     the local host.

	      --version	     Display CIM Server version number.

	      -W	     Specifies	write authorization on the namespace.

EXIT STATUS
       When an error occurs, an error message is written  to  stderr  and  an
       error  value  of	 1  is	returned.  The	following  return  values are
       returned:

	      0	     Successful completion
	      1	     Error

USAGE NOTE
       The cimauth command requires that the CIM Server is running.

EXAMPLES
       Add read authorizations to user "guest" on namespace "root/cimv2".

	      cimauth -a -u guest -n root/cimv2 -R

       Add read	 and  write  authorizations  to	 user  "guest"	on  namespace
       "root/system".

	      cimauth -a -u guest -n root/system -R -W

       Modify  authorizations  of the user "guest" on namespace "root/system"
       to read only.

	      cimauth -m -u guest -n root/system -R

       Remove the authorizations of the user "guest" on namespace  "root/sys-
       tem".

	      cimauth -r -u guest -n root/system

       List all the authorizations configured in the CIM Server.

	      cimauth -l

SEE ALSO
       cimserver(8), cimconfig(8).



								   cimauth(8)