version 1.1, 2002/12/19 00:56:51
|
version 1.2, 2003/03/13 17:25:16
|
|
|
|
.\" $Header$ |
|
.TA w \" lowercase initial letter of .TH name |
|
.TH wbemexec 1 |
|
.ds )H Hewlett-Packard Company |
|
.SH NAME |
|
wbemexec \- submit a CIM operation request to a CIM Server |
|
.SH SYNOPSIS |
|
|
|
\fBwbemexec\fP [ \fB-h\fP hostname ] [ \fB-p\fP portnumber ] [ \fB-v\fP httpversion ] [ \fB-m\fP httpmethod ] [ \fB-t\fP timeout ] [ \fB-u\fP username ] [ \fB-w\fP password ] [ \fB-s\fP ] [ inputfilepath ] |
|
|
|
.SH DESCRIPTION |
|
The |
|
.B wbemexec |
|
command provides a command line interface to a CIM Server. |
|
The input to the command consists of a CIM request encoded in XML. |
|
The request is submitted to the CIM Server for execution. |
|
If the HTTP response from the CIM Server contains a status code of 200 (OK), |
|
the result returned to stdout is the CIM response encoded in XML. |
|
Otherwise, the result returned to stdout is the HTTP response. |
|
Some types of invalid XML requests (e.g. missing PROTOCOLVERSION attribute or |
|
missing NAME attribute) are detected by |
|
.B wbemexec, |
|
and result in an error message from |
|
.B wbemexec. |
|
Other invalid XML requests (e.g. invalid CIMVERSION attribute value |
|
or missing XML version), are detected by the CIM Server, |
|
and result in an HTTP response, containing a non-Success status code, |
|
such as 501 (Not Implemented) or 400 (Bad Request). |
|
.PP |
|
By default, the request is sent as an HTTP/1.1 request, |
|
using the HTTP M-POST method, and |
|
.B wbemexec |
|
waits 20000 milliseconds (20 seconds), |
|
then times out if a response hasn't been received. |
|
Input is read from stdin, if no input file is specified. |
|
.PP |
|
By default, |
|
the operation is executed on the local host. |
|
.B wbemexec |
|
first attempts to connect to the CIM Server on the default port for the |
|
wbem-http service, |
|
and if that fails, another attempt is made on the default port for the |
|
wbem-https service. |
|
.SS Options |
|
.B wbemexec |
|
recognizes the following options: |
|
.RS |
|
.TP 15 |
|
\fB-h\fP hostname |
|
Connect to the CIM Server on the specified host. |
|
If this option is not specified, |
|
.B wbemexec |
|
connects to the local host. |
|
.TP |
|
\fB-p\fP portnumber |
|
Connect to the CIM Server on the specified port number. |
|
If this option is not specified, |
|
.B wbemexec |
|
connects to the default port for the wbem-http service, or if the |
|
.B -s |
|
option is specified, to the default port for the wbem-https service. |
|
.TP |
|
\fB-v\fP httpversion |
|
Use the specified HTTP version |
|
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. |
|
.TP |
|
\fB-m\fP httpmethod |
|
Use the specified HTTP method |
|
for the request. The method must be "POST" or "M-POST". |
|
.TP |
|
\fB-t\fP timeout |
|
Wait the specified number of milliseconds on sending a request, before timing out if no response has been received. The |
|
.I timeout |
|
value must be an integer value greater than 0. |
|
.TP |
|
\fB-u\fP username |
|
Connect as the specified |
|
.IR username . |
|
If |
|
.I username |
|
is not specified, the current logged in user is used for authentication. |
|
This option is ignored if neither |
|
.I hostname |
|
nor |
|
.I portnumber |
|
is specified. |
|
.TP |
|
\fB-w\fP password |
|
Authenticate the connection using the specified |
|
.IR password . |
|
If the |
|
.I password |
|
is not specified and the remote host requests authentication, the user is |
|
prompted for a password. |
|
This option is ignored if neither |
|
.I hostname |
|
nor |
|
.I portnumber |
|
is specified. |
|
.TP |
|
.B -s |
|
Enable the use of the SSL protocol between |
|
.C wbemexec |
|
and the CIM server. |
|
The |
|
.B -s |
|
option should be specified if the CIM Server |
|
on the specified hostname/portnumber expects clients to connect using HTTPS. |
|
(See |
|
.B "cimconfig (1M)" |
|
for information on configuring the CIM Server.) |
|
This option is ignored if neither |
|
.I hostname |
|
nor |
|
.I portnumber |
|
is specified. |
|
.PD |
|
.RE |
|
|
|
.SH EXIT STATUS |
|
.PP |
|
When an error occurs, an explanatory error message is written to stderr and an |
|
appropriate value is returned. The following exit values are returned: |
|
.RS |
|
.TP |
|
.B 0 |
|
Success |
|
.PD 0 |
|
.TP |
|
.B 1 |
|
Error |
|
.PD |
|
.RE |
|
.SH EXAMPLES |
|
.PP |
|
Submit an XML request contained in the file cimrequest.xml to the CIM Server |
|
running on the local host on the default port: |
|
.IP |
|
.B wbemexec cimrequest.xml |
|
.PP |
|
Submit an XML request contained in the file cimrequest.xml to the CIM Server |
|
running on the host hpserver on port 49152, using the |
|
.I username |
|
guest and |
|
.I password |
|
guest for authentication: |
|
.IP |
|
.B wbemexec -h hpserver -p 49152 -u guest -w guest cimrequest.xml |
|
.PP |
|
.SH SEE ALSO |
|
.PP |
|
cimserver(1M), cimconfig(1M). |
|
.SH STANDARDS CONFORMANCE |
|
.PP |
|
\fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0 |