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