1cimauth(8)                                                          cimauth(8)
2
3
4

NAME

6       cimauth  - add, modify, remove, or list CIM namespace authorizations of
7       users
8

SYNOPSIS

10       cimauth -a -u username -n namespace [ -R ] [ -W ]
11
12       cimauth -m -u username -n namespace [ -R ] [ -W ]
13
14       cimauth -r -u username [ -n namespace ]
15
16       cimauth -l
17
18       cimauth -h
19
20       cimauth --help
21
22       cimauth --version
23
24

DESCRIPTION

26       The cimauth command manages read and write CIM namespace authorizations
27       of  users.  The operations are executed on the local host by submitting
28       requests to the CIM Server.  If the value of the configuration property
29       enableNamespaceAuthorization  is True , the CIM Server restricts access
30       to namespaces based on user authorizations  configured  via  cimauth  .
31       Changes  to "Dynamic" authorization parameters does not require the CIM
32       Server to be restarted. "Non Dynamic"  configuration  properties  (E.g.
33       enableNamespaceAuthorization ) can only be set as planned configuration
34       and the CIM Server needs to be restarted to realize the  change.   (See
35       cimconfig (8) for information on configuring the CIM Server.)
36
37   Options
38       The cimauth command recognizes the following options:
39
40              -a             Adds  read  and/or  write  authorizations  to the
41                             specified user on the  specified  namespace.   If
42                             neither  the  -R  nor the -W option is specified,
43                             adds a read authorization by default.
44
45              -h, --help     Display command usage information.
46
47              -l             Lists all the authorizations  configured  in  the
48                             CIM Server.
49
50              -m             Modifies  authorizations of the specified user on
51                             the specified namespace.  If neither the  -R  nor
52                             the  -W  option is specified, modifies the autho‐
53                             rization to be a read authorization by default.
54
55              -n namespace   Specifies the R namespace for the operation.
56
57              -r             Removes authorizations of the specified  user  on
58                             the  specified  namespace.   If no namespaces are
59                             specified, removes authorizations on  all  names‐
60                             paces for the specified user.
61
62              -R             Specifies read authorization on the namespace.
63
64              -u username    Specifies the user for the operation.  The speci‐
65                             fied R username must represent a  valid  user  on
66                             the local host.
67
68              --version      Display CIM Server version number.
69
70              -W             Specifies write authorization on the namespace.
71

EXIT STATUS

73       When  an  error  occurs,  an  error message is written to stderr and an
74       error value of 1 is returned. The following return values are returned:
75
76              0      Successful completion
77              1      Error
78

USAGE NOTE

80       The cimauth command requires that the CIM Server is running.
81

EXAMPLES

83       Add read authorizations to user "guest" on namespace "root/cimv2".
84
85              cimauth -a -u guest -n root/cimv2 -R
86
87       Add  read  and  write  authorizations  to  user  "guest"  on  namespace
88       "root/system".
89
90              cimauth -a -u guest -n root/system -R -W
91
92       Modify authorizations of the user "guest" on namespace "root/system" to
93       read only.
94
95              cimauth -m -u guest -n root/system -R
96
97       Remove the authorizations of the user "guest" on  namespace  "root/sys‐
98       tem".
99
100              cimauth -r -u guest -n root/system
101
102       List all the authorizations configured in the CIM Server.
103
104              cimauth -l
105

SEE ALSO

107       cimserver(8), cimconfig(8).
108
109
110
111                                                                    cimauth(8)
Impressum