1 kumpf 1.2 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/Attic/wbemexec.1,v 1.1.2.1 2002/12/19 00:56:51 kumpf Exp $
2 .TA w \" lowercase initial letter of .TH name
3 .TH wbemexec 1
4 .ds )H Hewlett-Packard Company
5 .SH NAME
6 wbemexec \- submit a CIM operation request to a CIM Server
7 .SH SYNOPSIS
8
9 \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 ]
10
11 .SH DESCRIPTION
12 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 kumpf 1.2 .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 and result in an HTTP response, containing a non-Success status code,
28 such as 501 (Not Implemented) or 400 (Bad Request).
29 .PP
30 By default, the request is sent as an HTTP/1.1 request,
31 using the HTTP M-POST method, and
32 .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 .PP
37 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 wbem-http service,
42 and if that fails, another attempt is made on the default port for the
43 kumpf 1.2 wbem-https service.
44 .SS Options
45 .B wbemexec
46 recognizes the following options:
47 .RS
48 .TP 15
49 \fB-h\fP hostname
50 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 .TP
55 \fB-p\fP portnumber
56 Connect to the CIM Server on the specified port number.
57 If this option is not specified,
58 .B wbemexec
59 connects to the default port for the wbem-http service, or if the
60 .B -s
61 option is specified, to the default port for the wbem-https service.
62 .TP
63 \fB-v\fP httpversion
64 kumpf 1.2 Use the specified HTTP version
65 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.
66 .TP
67 \fB-m\fP httpmethod
68 Use the specified HTTP method
69 for the request. The method must be "POST" or "M-POST".
70 .TP
71 \fB-t\fP timeout
72 Wait the specified number of milliseconds on sending a request, before timing out if no response has been received. The
73 .I timeout
74 value must be an integer value greater than 0.
75 .TP
76 \fB-u\fP username
77 Connect as the specified
78 .IR username .
79 If
80 .I username
81 is not specified, the current logged in user is used for authentication.
82 This option is ignored if neither
83 .I hostname
84 nor
85 kumpf 1.2 .I portnumber
86 is specified.
87 .TP
88 \fB-w\fP password
89 Authenticate the connection using the specified
90 .IR password .
91 If the
92 .I password
93 is not specified and the remote host requests authentication, the user is
94 prompted for a password.
95 This option is ignored if neither
96 .I hostname
97 nor
98 .I portnumber
99 is specified.
100 .TP
101 .B -s
102 Enable the use of the SSL protocol between
103 .C wbemexec
104 and the CIM server.
105 The
106 kumpf 1.2 .B -s
107 option should be specified if the CIM Server
108 on the specified hostname/portnumber expects clients to connect using HTTPS.
109 (See
110 .B "cimconfig (1M)"
111 for information on configuring the CIM Server.)
112 This option is ignored if neither
113 .I hostname
114 nor
115 .I portnumber
116 is specified.
117 .PD
118 .RE
119
120 .SH EXIT STATUS
121 .PP
122 When an error occurs, an explanatory error message is written to stderr and an
123 appropriate value is returned. The following exit values are returned:
124 .RS
125 .TP
126 .B 0
127 kumpf 1.2 Success
128 .PD 0
129 .TP
130 .B 1
131 Error
132 .PD
133 .RE
134 .SH EXAMPLES
135 .PP
136 Submit an XML request contained in the file cimrequest.xml to the CIM Server
137 running on the local host on the default port:
138 .IP
139 .B wbemexec cimrequest.xml
140 .PP
141 Submit an XML request contained in the file cimrequest.xml to the CIM Server
142 running on the host hpserver on port 49152, using the
143 .I username
144 guest and
145 .I password
146 guest for authentication:
147 .IP
148 kumpf 1.2 .B wbemexec -h hpserver -p 49152 -u guest -w guest cimrequest.xml
149 .PP
150 .SH SEE ALSO
151 .PP
152 cimserver(1M), cimconfig(1M).
153 .SH STANDARDS CONFORMANCE
154 .PP
155 \fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0
|