1 joyce.j 1.4 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/wbemexec.1,v 1.3 2004/11/23 11:36:42 alagaraja 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 alagaraja 1.3 .I R password .
|
106 kumpf 1.2 If the
107 .I password
108 is not specified and the remote host requests authentication, the user is
109 prompted for a password.
110 This option is ignored if neither
111 .I hostname
112 nor
113 .I portnumber
114 is specified.
115 (See
|
116 alagaraja 1.3 .B "cimconfig (1)"
|
117 kumpf 1.2 for information on configuring the CIM Server.)
118 This option is ignored if neither
119 .I hostname
120 nor
121 .I portnumber
122 is specified.
123 .PD
124 .RE
125
|
126 alagaraja 1.3 .SH "EXIT STATUS"
127 .PP
|
128 kumpf 1.2 When an error occurs, an explanatory error message is written to stderr and an
129 appropriate value is returned. The following exit values are returned:
130 .RS
|
131 alagaraja 1.3 .TP
|
132 kumpf 1.2 .B 0
133 Success
134 .PD 0
|
135 alagaraja 1.3 .TP
|
136 kumpf 1.2 .B 1
137 Error
138 .PD
139 .RE
|
140 alagaraja 1.3 .SH "USAGE NOTE"
141 .PP
142 The
143 .B wbemexec
144 command requires that the CIM Server is running.
145 .SH "EXAMPLES"
146 .PP
|
147 kumpf 1.2 Submit an XML request contained in the file cimrequest.xml to the CIM Server
148 running on the local host on the default port:
|
149 alagaraja 1.3 .IP
|
150 kumpf 1.2 .B wbemexec cimrequest.xml
|
151 alagaraja 1.3 .PP
|
152 kumpf 1.2 Submit an XML request contained in the file cimrequest.xml to the CIM Server
153 running on the host hpserver on port 49152, using the
154 .I username
155 guest and
156 .I password
157 guest for authentication:
|
158 alagaraja 1.3 .IP
159 .B wbemexec \-h hpserver \-p 49152 \-u guest \-w guest cimrequest.xml
160 .PP
161 .SH "SEE ALSO"
162 .PP
163 cimserver(1), cimconfig(1).
164 .SH "STANDARDS CONFORMANCE"
165 .PP
|
166 kumpf 1.2 \fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0
|