version 1.1, 2004/08/27 04:55:12
|
version 1.2, 2004/11/23 11:46:35
|
|
|
.\" $Header$ | .\" $Header$ |
.TA c \" lowercase initial letter of .TH name |
.\" .TA c \" lowercase initial letter of .TH name |
.TH cimauth 8 |
.TH "cimauth" "8" "" "" "" |
.SH NAME |
.SH "NAME" |
cimauth \- add, modify, remove, or list CIM namespace authorizations of users | cimauth \- add, modify, remove, or list CIM namespace authorizations of users |
.SH SYNOPSIS |
.SH "SYNOPSIS" |
\fBcimauth -a -u\fP username \fB-n\fP namespace [ \fB-R\fP ] [ \fB-W\fP ] |
\fBcimauth\fP [ \fB\-a \-u\fP username \fB\-n\fP namespace [\fB\-R\fP] [\fB\-W\fP] ] |
|
[ \fB\-m \-u\fP username \fB\-n\fP namespace [\fB\-R\fP] [\fB\-W\fP] ] |
\fBcimauth -m -u\fP username \fB-n\fP namespace [ \fB-R\fP ] [ \fB-W\fP ] |
[ \fB\-r \-u\fP username [ \fB\-n\fP namespace ] ] |
|
[ \fB\-l\fP ] [ \fB\-h\fP ] [ \fB\-\-help\fP ] [ \fB\-\-version\fP ] |
\fBcimauth -r -u\fP username [ \fB-n\fP namespace ] |
.SH "DESCRIPTION" |
|
|
.B cimauth -l |
|
.SH DESCRIPTION |
|
.PP | .PP |
The | The |
.B cimauth | .B cimauth |
|
|
the CIM Server restricts access to namespaces based on user | the CIM Server restricts access to namespaces based on user |
authorizations configured via | authorizations configured via |
.B cimauth . | .B cimauth . |
|
Changes to "Dynamic" authorization parameters does not require the CIM Server to be restarted. "Non Dynamic" configuration properties (E.g. \fBenableNamespaceAuthorization\fP |
|
) can only be set as planned configuration and the CIM Server needs to be restarted to realize the change. |
(See | (See |
.B "cimconfig (8)" | .B "cimconfig (8)" |
for information on configuring the CIM Server.) | for information on configuring the CIM Server.) |
|
|
command recognizes the following options: | command recognizes the following options: |
.RS | .RS |
.TP 15 | .TP 15 |
.B -a |
.B \-a |
Adds read and/or write authorizations to the specified user on the specified | Adds read and/or write authorizations to the specified user on the specified |
namespace. If neither the | namespace. If neither the |
.B -R |
.B \-R |
nor the | nor the |
.B -W |
.B \-W |
option is specified, adds a read authorization by default. | option is specified, adds a read authorization by default. |
.TP | .TP |
.B -m |
.B \-h, \-\-help |
|
Display command usage information. |
|
.TP |
|
.B \-l |
|
Lists all the authorizations configured in the CIM Server. |
|
.TP |
|
.B \-m |
Modifies authorizations of the specified user on the specified namespace. | Modifies authorizations of the specified user on the specified namespace. |
If neither the | If neither the |
.B -R |
.B \-R |
nor the | nor the |
.B -W |
.B \-W |
option is specified, modifies the authorization to be | option is specified, modifies the authorization to be |
a read authorization by default. | a read authorization by default. |
.TP | .TP |
.B -r |
\fB\-n\fP namespace |
|
Specifies the |
|
.I R namespace |
|
for the operation. |
|
.TP |
|
.B \-r |
Removes authorizations of the specified user on the specified namespace. | Removes authorizations of the specified user on the specified namespace. |
If no namespaces are specified, removes authorizations on all namespaces | If no namespaces are specified, removes authorizations on all namespaces |
for the specified user. | for the specified user. |
.TP | .TP |
.B -l |
.B \-R |
Lists all the authorizations configured in the CIM Server. |
Specifies read authorization on the namespace. |
.TP | .TP |
\fB-u\fP username |
\fB\-u\fP username |
Specifies the user for the operation. The specified | Specifies the user for the operation. The specified |
.IR username | .IR username |
must represent a valid user on the local host. | must represent a valid user on the local host. |
.TP | .TP |
\fB-n\fP namespace |
.B \-\-version |
Specifies the |
Display CIM Server version number. |
.IR namespace |
|
for the operation. |
|
.TP |
|
.B -R |
|
Specifies read authorization on the namespace. |
|
.TP | .TP |
.B -W |
.B \-W |
Specifies write authorization on the namespace. | Specifies write authorization on the namespace. |
.RE | .RE |
.SH EXIT STATUS |
.SH "EXIT STATUS" |
.PP | .PP |
When an error occurs, an | When an error occurs, an |
error message is written to stderr and an error value of 1 is returned. The | error message is written to stderr and an error value of 1 is returned. The |
|
|
Error | Error |
.PD | .PD |
.RE | .RE |
.SH EXAMPLES |
.SH "USAGE NOTE" |
|
.PP |
|
The |
|
.B cimauth |
|
command requires that the CIM Server is running. |
|
.SH "EXAMPLES" |
.PP | .PP |
Add read authorizations to user "guest" on namespace "root/cimv2". | Add read authorizations to user "guest" on namespace "root/cimv2". |
.IP | .IP |
.B "cimauth -a -u guest -n root/cimv2 -R" |
.B "cimauth \-a \-u guest \-n root/cimv2 \-R" |
.PP | .PP |
Add read and write authorizations to user "guest" on namespace "root/system". | Add read and write authorizations to user "guest" on namespace "root/system". |
.IP | .IP |
.B "cimauth -a -u guest -n root/system -R -W" |
.B "cimauth \-a \-u guest \-n root/system \-R \-W" |
.PP | .PP |
Modify authorizations of the user "guest" on namespace "root/system" to | Modify authorizations of the user "guest" on namespace "root/system" to |
read only. | read only. |
.IP | .IP |
.B "cimauth -m -u guest -n root/system -R" |
.B "cimauth \-m \-u guest \-n root/system \-R" |
.PP | .PP |
Remove the authorizations of the user "guest" on namespace "root/system". | Remove the authorizations of the user "guest" on namespace "root/system". |
.IP | .IP |
.B "cimauth -r -u guest -n root/system" |
.B "cimauth \-r \-u guest \-n root/system" |
.PP | .PP |
List all the authorizations configured in the CIM Server. | List all the authorizations configured in the CIM Server. |
.IP | .IP |
.B "cimauth -l" |
.B "cimauth \-l" |
.SH SEE ALSO |
.SH "SEE ALSO" |
.PP | .PP |
cimserver (8), cimconfig (8). | cimserver (8), cimconfig (8). |