1 kumpf 1.5 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/wbemexec.1,v 1.4 2005/05/02 05:35:42 joyce.j Exp $
|
2 alagaraja 1.3 .\" .TA w \" lowercase initial letter of .TH name
3 .TH "wbemexec" "1" "" "" ""
4 .SH "NAME"
|
5 kumpf 1.2 wbemexec \- submit a CIM operation request to a CIM Server
|
6 alagaraja 1.3 .SH "SYNOPSIS"
7 \fBwbemexec\fP [ \fB\-h\fP hostname ] [ \fB\-p\fP portnumber ] [ \fB\-v\fP httpversion ]
8 [ \fB\-m\fP httpmethod ] [ \fB\-t\fP timeout ] [ \fB\-u\fP username ]
9 [ \fB\-w\fP password ] [ \fB\-s\fP ] [ \fB\-\-help\fP ] [ \fB\-\-version\fP ]
|
10 joyce.j 1.4 [ inputfilepath ]
|
11 alagaraja 1.3 .SH "DESCRIPTION"
|
12 kumpf 1.2 The
13 .B wbemexec
14 command provides a command line interface to a CIM Server.
15 The input to the command consists of a CIM request encoded in XML.
16 The request is submitted to the CIM Server for execution.
17 If the HTTP response from the CIM Server contains a status code of 200 (OK),
18 the result returned to stdout is the CIM response encoded in XML.
19 Otherwise, the result returned to stdout is the HTTP response.
20 Some types of invalid XML requests (e.g. missing PROTOCOLVERSION attribute or
21 missing NAME attribute) are detected by
22 .B wbemexec,
23 and result in an error message from
24 .B wbemexec.
25 Other invalid XML requests (e.g. invalid CIMVERSION attribute value
26 or missing XML version), are detected by the CIM Server,
|
27 alagaraja 1.3 and result in an HTTP response, containing a non\-Success status code,
|
28 kumpf 1.2 such as 501 (Not Implemented) or 400 (Bad Request).
|
29 alagaraja 1.3 .PP
|
30 kumpf 1.2 By default, the request is sent as an HTTP/1.1 request,
|
31 alagaraja 1.3 using the HTTP M\-POST method, and
|
32 kumpf 1.2 .B wbemexec
33 waits 20000 milliseconds (20 seconds),
34 then times out if a response hasn't been received.
35 Input is read from stdin, if no input file is specified.
|
36 alagaraja 1.3 .PP
|
37 kumpf 1.2 By default,
38 the operation is executed on the local host.
39 .B wbemexec
40 first attempts to connect to the CIM Server on the default port for the
|
41 alagaraja 1.3 wbem\-http service,
|
42 kumpf 1.2 and if that fails, another attempt is made on the default port for the
|
43 alagaraja 1.3 wbem\-https service.
|
44 kumpf 1.2 .SS Options
45 .B wbemexec
46 recognizes the following options:
47 .RS
48 .TP 15
|
49 alagaraja 1.3 \fB\-h\fP hostname
|
50 kumpf 1.2 Connect to the CIM Server on the specified host.
51 If this option is not specified,
52 .B wbemexec
53 connects to the local host.
|
54 alagaraja 1.3 .TP
55 .B \-\-help
56 Display command usage information.
57 .TP
58 \fB\-m\fP httpmethod
59 Use the specified HTTP method
60 for the request. The method must be "POST" or "M\-POST".
61 .TP
62 \fB\-p\fP portnumber
|
63 kumpf 1.2 Connect to the CIM Server on the specified port number.
64 If this option is not specified,
65 .B wbemexec
|
66 alagaraja 1.3 connects to the default port for the wbem\-http service, or if the
67 .B \-s
68 option is specified, to the default port for the wbem\-https service.
69 .TP
70 .B \-s
71 Enable the use of the SSL protocol between
72 .C wbemexec
73 and the CIM server.
74 The
75 .B \-s
76 option should be specified if the CIM Server
77 on the specified hostname/portnumber expects clients to connect using HTTPS.
78 .TP
79 \fB\-t\fP timeout
|
80 kumpf 1.2 Wait the specified number of milliseconds on sending a request, before timing out if no response has been received. The
81 .I timeout
82 value must be an integer value greater than 0.
|
83 alagaraja 1.3 .TP
84 \fB\-u\fP username
|
85 kumpf 1.2 Connect as the specified
|
86 alagaraja 1.3 .I R username .
|
87 kumpf 1.2 If
88 .I username
89 is not specified, the current logged in user is used for authentication.
90 This option is ignored if neither
91 .I hostname
92 nor
93 .I portnumber
94 is specified.
|
95 alagaraja 1.3 .TP
96 \fB\-v\fP httpversion
97 Use the specified HTTP version
98 for the request. The version must be "1.0" or "1.1". The 1.0 version may not be specified if the M\-POST method is specified.
99 .TP
100 \fB\-\-version\fP
101 Display CIM Server version.
102 .TP
103 \fB\-w\fP password
|
104 kumpf 1.2 Authenticate the connection using the specified
|
105 kumpf 1.5 .I password .
|
106 kumpf 1.2 This option is ignored if neither
107 .I hostname
108 nor
109 .I portnumber
110 is specified.
|
111 kumpf 1.5 WARNING: A password should not be specified on the command line on a
112 multi-user system, since command-line options are typically world-readable
113 for a short window of time. If the remote host requests authentication and
114 this option is not specified,
115 .B wbemexec
116 will prompt for the password.
|
117 kumpf 1.2 (See
|
118 alagaraja 1.3 .B "cimconfig (1)"
|
119 kumpf 1.2 for information on configuring the CIM Server.)
120 .PD
121 .RE
122
|
123 alagaraja 1.3 .SH "EXIT STATUS"
124 .PP
|
125 kumpf 1.2 When an error occurs, an explanatory error message is written to stderr and an
126 appropriate value is returned. The following exit values are returned:
127 .RS
|
128 alagaraja 1.3 .TP
|
129 kumpf 1.2 .B 0
130 Success
131 .PD 0
|
132 alagaraja 1.3 .TP
|
133 kumpf 1.2 .B 1
134 Error
135 .PD
136 .RE
|
137 alagaraja 1.3 .SH "USAGE NOTE"
138 .PP
139 The
140 .B wbemexec
141 command requires that the CIM Server is running.
142 .SH "EXAMPLES"
143 .PP
|
144 kumpf 1.2 Submit an XML request contained in the file cimrequest.xml to the CIM Server
145 running on the local host on the default port:
|
146 alagaraja 1.3 .IP
|
147 kumpf 1.2 .B wbemexec cimrequest.xml
|
148 alagaraja 1.3 .PP
|
149 kumpf 1.2 Submit an XML request contained in the file cimrequest.xml to the CIM Server
150 running on the host hpserver on port 49152, using the
151 .I username
152 guest and
153 .I password
154 guest for authentication:
|
155 alagaraja 1.3 .IP
156 .B wbemexec \-h hpserver \-p 49152 \-u guest \-w guest cimrequest.xml
157 .PP
158 .SH "SEE ALSO"
159 .PP
160 cimserver(1), cimconfig(1).
161 .SH "STANDARDS CONFORMANCE"
162 .PP
|
163 kumpf 1.2 \fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0
|