1 kumpf 1.2 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1m.Z/Attic/cimauth.1m,v 1.1.2.1 2002/12/19 00:56:51 kumpf Exp $
2 .TA c \" lowercase initial letter of .TH name
3 .TH cimauth 1M
4 .SH NAME
5 cimauth \- add, modify, remove, or list CIM namespace authorizations of users
6 .SH SYNOPSIS
7 \fBcimauth -a -u\fP username \fB-n\fP namespace [ \fB-R\fP ] [ \fB-W\fP ]
8
9 \fBcimauth -m -u\fP username \fB-n\fP namespace [ \fB-R\fP ] [ \fB-W\fP ]
10
11 \fBcimauth -r -u\fP username [ \fB-n\fP namespace ]
12
13 .B cimauth -l
14 .SH DESCRIPTION
15 .PP
16 The
17 .B cimauth
18 command manages
19 read and write CIM namespace authorizations of users. The operations are
20 executed on the local host by submitting requests to the CIM Server.
21 If the value of the configuration property
22 kumpf 1.2 .B enableNamespaceAuthorization
23 is
24 .B True ,
25 the CIM Server restricts access to namespaces based on user
26 authorizations configured via
27 .B cimauth .
28 (See
29 .B "cimconfig (1M)"
30 for information on configuring the CIM Server.)
31 .SS Options
32 .PP
33 The
34 .B cimauth
35 command recognizes the following options:
36 .RS
37 .TP 15
38 .B -a
39 Adds read and/or write authorizations to the specified user on the specified
40 namespace. If neither the
41 .B -R
42 nor the
43 kumpf 1.2 .B -W
44 option is specified, adds a read authorization by default.
45 .TP
46 .B -m
47 Modifies authorizations of the specified user on the specified namespace.
48 If neither the
49 .B -R
50 nor the
51 .B -W
52 option is specified, modifies the authorization to be
53 a read authorization by default.
54 .TP
55 .B -r
56 Removes authorizations of the specified user on the specified namespace.
57 If no namespaces are specified, removes authorizations on all namespaces
58 for the specified user.
59 .TP
60 .B -l
61 Lists all the authorizations configured in the CIM Server.
62 .TP
63 \fB-u\fP username
64 kumpf 1.2 Specifies the user for the operation. The specified
65 .IR username
66 must represent a valid HP-UX user on the local host.
67 .TP
68 \fB-n\fP namespace
69 Specifies the
70 .IR namespace
71 for the operation.
72 .TP
73 .B -R
74 Specifies read authorization on the namespace.
75 .TP
76 .B -W
77 Specifies write authorization on the namespace.
78 .RE
79 .SH EXIT STATUS
80 .PP
81 When an error occurs, an
82 error message is written to stderr and an error value of 1 is returned. The
83 following return values are returned:
84 .RS
85 kumpf 1.2 .TP
86 .B 0
87 Successful completion
88 .PD 0
89 .TP
90 .B 1
91 Error
92 .PD
93 .RE
94 .SH EXAMPLES
95 .PP
96 Add read authorizations to user "guest" on namespace "root/cimv2".
97 .IP
98 .B "cimauth -a -u guest -n root/cimv2 -R"
99 .PP
100 Add read and write authorizations to user "guest" on namespace "root/system".
101 .IP
102 .B "cimauth -a -u guest -n root/system -R -W"
103 .PP
104 Modify authorizations of the user "guest" on namespace "root/system" to
105 read only.
106 kumpf 1.2 .IP
107 .B "cimauth -m -u guest -n root/system -R"
108 .PP
109 Remove the authorizations of the user "guest" on namespace "root/system".
110 .IP
111 .B "cimauth -r -u guest -n root/system"
112 .PP
113 List all the authorizations configured in the CIM Server.
114 .IP
115 .B "cimauth -l"
116 .SH SEE ALSO
117 .PP
118 cimserver (1M), cimconfig (1M).
|