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).