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