1 kumpf 1.3 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man8.Z/cimuser.8,v 1.2 2004/12/08 08:38:46 a.arora 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 kumpf 1.3 WARNING: Passwords should not be specified on the command line on a multi-user
50 system, since command-line options are typically world-readable for a short
51 window of time. If no password is provided on the command line,
52 .B cimuser
53 will prompt for one.
|
54 alagaraja 1.1 .TP
55 .B \-r
56 Remove the specified CIM user.
57 .TP
58 .B \-u
59 Specify a CIM user name.
60 .TP
61 .B \-\-version
62 Display CIM Server version number.
63 .TP
64 .B \-w
65 Supply a password for the specified user name.
|
66 kumpf 1.3 WARNING: Passwords should not be specified on the command line on a multi-user
67 system, since command-line options are typically world-readable for a short
68 window of time. If no password is provided on the command line,
69 .B cimuser
70 will prompt for one.
|
71 alagaraja 1.1 .RE
72 .SH "EXIT STATUS"
73 .PP
74 When an error occurs, an
75 error message is written to stderr and an error value of 1 is returned. The
76 following return values are returned:
77 .RS
78 .TP
79 .B 0
80 Successful completion
81 .PD 0
82 .TP
83 .B 1
84 Error
85 .PD
86 .RE
87 .SH "USAGE NOTE"
88 .PP
89 The
90 .B cimuser
91 command requires that the CIM Server is running.
92 alagaraja 1.1 .SH "EXAMPLES"
93 .PP
94 The following command adds user "guest", a new CIM user. The password for this user is "guest".
95 .IP
96 .B "cimuser \-a \-u guest \-w guest"
97 .PP
98 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.
99 .IP
100 .B "cimuser \-a \-u guest "
101
102 Please enter your password:
103
104 Please re\-enter your password:
105
106 .PP
107 The following command modifies the password for user "guest", with the new password "bar".
108 .IP
109 .B "cimuser \-m \-u guest \-w foo \-n bar"
110 .PP
111 The following command removes the CIM user "guest".
112 .IP
113 alagaraja 1.1 .B "cimuser \-r \-u guest"
114 .PP
115 The following command displays the list of CIM user names.
116 .IP
117 .B "cimuser \-l"
118 .SH "SEE ALSO"
119 .PP
120 cimserver(8), cimconfig(8).
|