|
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 |
Return to
wbemexec.1
CVS log
Up to [Pegasus] / pegasus / rpm / manLinux / man1.Z