1 a.arora 1.3 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man8.Z/cimauth.8,v 1.2 2004/11/23 11:46:35 alagaraja Exp $
|
2 alagaraja 1.2 .\" .TA c \" lowercase initial letter of .TH name
3 .TH "cimauth" "8" "" "" ""
4 .SH "NAME"
|
5 denise.eckstein 1.1 cimauth \- add, modify, remove, or list CIM namespace authorizations of users
|
6 alagaraja 1.2 .SH "SYNOPSIS"
|
7 a.arora 1.3 \fBcimauth\fP \fB\-a\fP \fB\-u\fP username \fB\-n\fP namespace [ \fB\-R\fP ] [ \fB\-W\fP ]
8
9 \fBcimauth\fP \fB\-m\fP \fB\-u\fP username \fB\-n\fP namespace [ \fB\-R\fP ] [ \fB\-W\fP ]
10
11 \fBcimauth\fP \fB\-r\fP \fB\-u\fP username [ \fB\-n\fP namespace ]
12
13 \fBcimauth\fP \fB\-l\fP
14
15 \fBcimauth\fP \fB\-h\fP
16
17 \fBcimauth\fP \fB\-\-help\fP
18
19 \fBcimauth\fP \fB\-\-version\fP
20
|
21 alagaraja 1.2 .SH "DESCRIPTION"
22 .PP
|
23 denise.eckstein 1.1 The
24 .B cimauth
25 command manages
26 read and write CIM namespace authorizations of users. The operations are
27 executed on the local host by submitting requests to the CIM Server.
28 If the value of the configuration property
29 .B enableNamespaceAuthorization
30 is
31 .B True ,
32 the CIM Server restricts access to namespaces based on user
33 authorizations configured via
|
34 alagaraja 1.2 .B cimauth .
35 Changes to "Dynamic" authorization parameters does not require the CIM Server to be restarted. "Non Dynamic" configuration properties (E.g. \fBenableNamespaceAuthorization\fP
36 ) can only be set as planned configuration and the CIM Server needs to be restarted to realize the change.
|
37 denise.eckstein 1.1 (See
38 .B "cimconfig (8)"
39 for information on configuring the CIM Server.)
40 .SS Options
|
41 alagaraja 1.2 .PP
|
42 denise.eckstein 1.1 The
43 .B cimauth
44 command recognizes the following options:
45 .RS
46 .TP 15
|
47 alagaraja 1.2 .B \-a
|
48 denise.eckstein 1.1 Adds read and/or write authorizations to the specified user on the specified
49 namespace. If neither the
|
50 alagaraja 1.2 .B \-R
|
51 denise.eckstein 1.1 nor the
|
52 alagaraja 1.2 .B \-W
|
53 denise.eckstein 1.1 option is specified, adds a read authorization by default.
|
54 alagaraja 1.2 .TP
55 .B \-h, \-\-help
56 Display command usage information.
57 .TP
58 .B \-l
59 Lists all the authorizations configured in the CIM Server.
60 .TP
61 .B \-m
|
62 denise.eckstein 1.1 Modifies authorizations of the specified user on the specified namespace.
63 If neither the
|
64 alagaraja 1.2 .B \-R
|
65 denise.eckstein 1.1 nor the
|
66 alagaraja 1.2 .B \-W
|
67 denise.eckstein 1.1 option is specified, modifies the authorization to be
68 a read authorization by default.
|
69 alagaraja 1.2 .TP
70 \fB\-n\fP namespace
71 Specifies the
72 .I R namespace
73 for the operation.
74 .TP
75 .B \-r
|
76 denise.eckstein 1.1 Removes authorizations of the specified user on the specified namespace.
77 If no namespaces are specified, removes authorizations on all namespaces
78 for the specified user.
|
79 alagaraja 1.2 .TP
80 .B \-R
81 Specifies read authorization on the namespace.
82 .TP
83 \fB\-u\fP username
|
84 denise.eckstein 1.1 Specifies the user for the operation. The specified
|
85 alagaraja 1.2 .I R username
|
86 denise.eckstein 1.1 must represent a valid user on the local host.
|
87 alagaraja 1.2 .TP
88 .B \-\-version
89 Display CIM Server version number.
90 .TP
91 .B \-W
|
92 denise.eckstein 1.1 Specifies write authorization on the namespace.
93 .RE
|
94 alagaraja 1.2 .SH "EXIT STATUS"
95 .PP
|
96 denise.eckstein 1.1 When an error occurs, an
97 error message is written to stderr and an error value of 1 is returned. The
98 following return values are returned:
99 .RS
|
100 alagaraja 1.2 .TP
|
101 denise.eckstein 1.1 .B 0
102 Successful completion
103 .PD 0
|
104 alagaraja 1.2 .TP
|
105 denise.eckstein 1.1 .B 1
106 Error
107 .PD
108 .RE
|
109 alagaraja 1.2 .SH "USAGE NOTE"
110 .PP
111 The
112 .B cimauth
113 command requires that the CIM Server is running.
114 .SH "EXAMPLES"
115 .PP
|
116 denise.eckstein 1.1 Add read authorizations to user "guest" on namespace "root/cimv2".
|
117 alagaraja 1.2 .IP
118 .B "cimauth \-a \-u guest \-n root/cimv2 \-R"
119 .PP
|
120 denise.eckstein 1.1 Add read and write authorizations to user "guest" on namespace "root/system".
|
121 alagaraja 1.2 .IP
122 .B "cimauth \-a \-u guest \-n root/system \-R \-W"
123 .PP
|
124 denise.eckstein 1.1 Modify authorizations of the user "guest" on namespace "root/system" to
125 read only.
|
126 alagaraja 1.2 .IP
127 .B "cimauth \-m \-u guest \-n root/system \-R"
128 .PP
|
129 denise.eckstein 1.1 Remove the authorizations of the user "guest" on namespace "root/system".
|
130 alagaraja 1.2 .IP
131 .B "cimauth \-r \-u guest \-n root/system"
132 .PP
|
133 denise.eckstein 1.1 List all the authorizations configured in the CIM Server.
|
134 alagaraja 1.2 .IP
135 .B "cimauth \-l"
136 .SH "SEE ALSO"
137 .PP
138 cimserver(8), cimconfig(8).
|