1 a.arora 1.2 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man8.Z/cimuser.8,v 1.1 2004/11/23 11:44:16 alagaraja Exp $

  2 alagaraja 1.1 .\" .TA c \" lowercase initial letter of .TH name
  3               .TH "cimuser" "8" "" "" ""
  4               .SH "NAME"
  5               cimuser \- add, modify, remove, or list CIM users
  6               .SH "SYNOPSIS"

  7 a.arora   1.2 \fBcimuser\fP \fB\-a\fP \fB\-u\fP username [ \fB\-w\fP password ] 
  8               
  9               \fBcimuser\fP \fB\-m\fP \fB\-u\fP username [ \fB\-w\fP old password ] [ \fB\-n\fP new password ]
 10               
 11               \fBcimuser\fP \fB\-r\fP \fB\-u\fP username 
 12               
 13               \fBcimuser\fP \fB\-l\fP
 14               
 15               \fBcimuser\fP \fB\-h\fP
 16               
 17               \fBcimuser\fP \fB\-\-help\fP
 18               
 19               \fBcimuser\fP \fB\-\-version\fP
 20               

 21 alagaraja 1.1 .SH "REMARKS"
 22               This command can be executed only by privileged user(s).
 23               .SH "DESCRIPTION"
 24               .PP 
 25               The 
 26               .B cimuser 
 27               command command provides a command line interface to manage CIM users. If the password is not specified at the command line, the user will be prompted for it. If more than 8 characters are entered for the password, then the first eight characters will be used. There is no default authorization permissions set for newly added users. For more information on adding authorization information see cimauth(8).
 28               .SS Options
 29               .PP 
 30               The 
 31               .B cimuser
 32               command recognizes the following options:
 33               .RS
 34               .TP 15
 35               .B  \-a
 36               Add a new CIM user.
 37               .TP 
 38               .B \-h, \-\-help
 39               Display command usage information.
 40               .TP 
 41               .B \-l
 42 alagaraja 1.1 List the names of CIM users.
 43               .TP 
 44               .B \-m
 45               Modify a CIM user password.
 46               .TP 
 47               .B \-n
 48               Supply a new password for the specified user name.
 49               .TP 
 50               .B \-r
 51               Remove the specified CIM user.
 52               .TP 
 53               .B \-u
 54               Specify a CIM user name.
 55               .TP 
 56               .B \-\-version
 57               Display CIM Server version number.
 58               .TP 
 59               .B \-w
 60               Supply a password for the specified user name.
 61               .RE
 62               .SH "EXIT STATUS"
 63 alagaraja 1.1 .PP 
 64               When an error occurs, an
 65               error message is written to stderr and an error value of 1 is returned. The
 66               following return values are returned:
 67               .RS
 68               .TP 
 69               .B 0
 70               Successful completion
 71               .PD 0
 72               .TP 
 73               .B 1
 74               Error
 75               .PD
 76               .RE
 77               .SH "USAGE NOTE"
 78               .PP 
 79               The 
 80               .B cimuser 
 81               command requires that the CIM Server is running.
 82               .SH "EXAMPLES"
 83               .PP 
 84 alagaraja 1.1 The following command adds user "guest", a new CIM user. The password for this user is "guest".
 85               .IP 
 86               .B "cimuser \-a \-u guest \-w guest"
 87               .PP 
 88               The following command adds user "guest", a new CIM user. Since the password is not specified on the command line, the user will be prompted for it.
 89               .IP 
 90               .B "cimuser \-a \-u guest "
 91               
 92               Please enter your password:
 93               
 94               Please re\-enter your password:
 95               
 96               .PP 
 97               The following command modifies the password  for user "guest", with the new password "bar".
 98               .IP 
 99               .B "cimuser \-m \-u guest \-w foo \-n bar"
100               .PP 
101               The following command removes the CIM user "guest".
102               .IP 
103               .B "cimuser \-r \-u guest"
104               .PP 
105 alagaraja 1.1 The following command displays the list of CIM user names.
106               .IP 
107               .B "cimuser \-l"
108               .SH "SEE ALSO"
109               .PP 
110               cimserver(8), cimconfig(8).