1Sys::Virt::Error(3) User Contributed Perl Documentation Sys::Virt::Error(3)
2
3
4
6 Sys::Virt::Error - error object for libvirt APIs
7
9 The "Sys::Virt::Error" class provides an encoding of the libvirt
10 errors. Instances of this object can be thrown by pretty much any of
11 the Sys::Virt APIs.
12
14 $err->stringify
15 Convert the object into string format suitable for printing on a
16 console to inform a user of the error.
17
18 my $code = $err->code
19 Return the raw error code represented by this error.
20
21 my $from = $err->domain
22 Return the error domain raising this error.
23
24 my $msg = $err->message
25 Return an informative message describing the error condition.
26
28 ERROR DOMAINS
29 The error domain indicates which internal part of libvirt the error
30 report was raised from.
31
32 Sys::Virt::Error::FROM_CONF
33 Configuration file handling
34
35 Sys::Virt::Error::FROM_DOM
36 Error while operating on a domain
37
38 Sys::Virt::Error::FROM_DOMAIN
39 Domain configuration handling
40
41 Sys::Virt::Error::FROM_LXC
42 LXC virtualization driver
43
44 Sys::Virt::Error::FROM_NET
45 Error while operating on a network
46
47 Sys::Virt::Error::FROM_NETWORK
48 Network configuration handling
49
50 Sys::Virt::Error::FROM_NODEDEV
51 Node device configuration handling
52
53 Sys::Virt::Error::FROM_NONE
54 No specific error domain.
55
56 Sys::Virt::Error::FROM_OPENVZ
57 OpenVZ virtualization driver
58
59 Sys::Virt::Error::FROM_PROXY
60 Xen proxy virtualization driver
61
62 Sys::Virt::Error::FROM_QEMU
63 QEMU virtualization driver
64
65 Sys::Virt::Error::FROM_REMOTE
66 Remote client virtualization driver
67
68 Sys::Virt::Error::FROM_RPC
69 XML-RPC handling code
70
71 Sys::Virt::Error::FROM_SECURITY
72 Security services driver
73
74 Sys::Virt::Error::FROM_SEXPR
75 SEXPR parsing code
76
77 Sys::Virt::Error::FROM_STATS_LINUX
78 Device statistics code
79
80 Sys::Virt::Error::FROM_STORAGE
81 Storage configuration handling
82
83 Sys::Virt::Error::FROM_TEST
84 Test virtualization driver
85
86 Sys::Virt::Error::FROM_UML
87 UML virtualization driver
88
89 Sys::Virt::Error::FROM_XEN
90 Xen hypervisor driver
91
92 Sys::Virt::Error::FROM_XEND
93 XenD daemon driver
94
95 Sys::Virt::Error::FROM_XENSTORE
96 XenStore driver
97
98 Sys::Virt::Error::FROM_XENXM
99 Xen XM configuration file driver
100
101 Sys::Virt::Error::FROM_XEN_INOTIFY
102 Xen Inotify events driver
103
104 Sys::Virt::Error::FROM_XML
105 Low level XML parser
106
107 Sys::Virt::Error::FROM_ESX
108 The VMWare ESX driver
109
110 Sys::Virt::Error::FROM_INTERFACE
111 The host network interface driver
112
113 Sys::Virt::Error::FROM_ONE
114 The Open Nebula driver
115
116 Sys::Virt::Error::FROM_PHYP
117 The IBM Power Hypervisor driver
118
119 Sys::Virt::Error::FROM_SECRET
120 The secret management driver
121
122 Sys::Virt::Error::FROM_VBOX
123 The VirtualBox driver
124
125 ERROR CODES
126 The error codes allow for specific problems to be identified and
127 handled separately from generic error handling.
128
129 Sys::Virt::Error::ERR_AUTH_FAILED
130 Authentication falure when connecting to a driver
131
132 Sys::Virt::Error::ERR_CALL_FAILED
133 Operation not supported by driver (DEPRECATED & unused)
134
135 Sys::Virt::Error::ERR_CONF_SYNTAX
136 Configuration file syntax error
137
138 Sys::Virt::Error::ERR_DOM_EXIST
139 The domain already exists
140
141 Sys::Virt::Error::ERR_DRIVER_FULL
142 Too many hypervisor drivers have been registered
143
144 Sys::Virt::Error::ERR_GET_FAILED
145 HTTP GET command failed talking to XenD
146
147 Sys::Virt::Error::ERR_GNUTLS_ERROR
148 GNUTLS encryption error in RPC driver
149
150 Sys::Virt::Error::ERR_HTTP_ERROR
151 Unexpected HTTP error code from XenD
152
153 Sys::Virt::Error::ERR_INTERNAL_ERROR
154 Generic internal error
155
156 Sys::Virt::Error::ERR_INVALID_ARG
157 Invalid argument supplied to function
158
159 Sys::Virt::Error::ERR_INVALID_CONN
160 Invalid connection object
161
162 Sys::Virt::Error::ERR_INVALID_DOMAIN
163 Invalid domain object
164
165 Sys::Virt::Error::ERR_INVALID_MAC
166 Invalid MAC address string
167
168 Sys::Virt::Error::ERR_INVALID_NETWORK
169 Invalid network object
170
171 Sys::Virt::Error::ERR_INVALID_NODE_DEVICE
172 Invalid node device object
173
174 Sys::Virt::Error::ERR_INVALID_STORAGE_POOL
175 Invalid storage pool object
176
177 Sys::Virt::Error::ERR_INVALID_STORAGE_VOL
178 Invalid storage vol object
179
180 Sys::Virt::Error::ERR_NETWORK_EXIST
181 Network with this name/uuid already exists
182
183 Sys::Virt::Error::ERR_NO_CONNECT
184 Unable to connect to requested hypervisor driver
185
186 Sys::Virt::Error::ERR_NO_DEVICE
187 Missing device information
188
189 Sys::Virt::Error::ERR_NO_DOMAIN
190 No such domain with that name/uuid/id
191
192 Sys::Virt::Error::ERR_NO_KERNEL
193 Missing kernel information in domain configuration
194
195 Sys::Virt::Error::ERR_NO_MEMORY
196 Missing memory information in domain configuration
197
198 Sys::Virt::Error::ERR_NO_NAME
199 Missing name in object configuration
200
201 Sys::Virt::Error::ERR_NO_NETWORK
202 No such network with that name/uuid
203
204 Sys::Virt::Error::ERR_NO_NODE_DEVICE
205 No such node device with that name
206
207 Sys::Virt::Error::ERR_NO_OS
208 Missing OS information in domain configuration
209
210 Sys::Virt::Error::ERR_NO_ROOT
211 Missing root device information in domain configuration
212
213 Sys::Virt::Error::ERR_NO_SECURITY_MODEL
214 Missing security model information in domain configuratio
215
216 Sys::Virt::Error::ERR_NO_SOURCE
217 Missing source device information in domain configuration
218
219 Sys::Virt::Error::ERR_NO_STORAGE_POOL
220 No such storage pool with that name/uuid
221
222 Sys::Virt::Error::ERR_NO_STORAGE_VOL
223 No such storage volume with that name/path/key
224
225 Sys::Virt::Error::ERR_NO_SUPPORT
226 This operation is not supported by the active driver
227
228 Sys::Virt::Error::ERR_NO_TARGET
229 Missing target device information in domain configuration
230
231 Sys::Virt::Error::ERR_NO_XEN
232 Unable to connect to Xen hypervisor
233
234 Sys::Virt::Error::ERR_NO_XENSTORE
235 Unable to connect to XenStorage daemon
236
237 Sys::Virt::Error::ERR_OK
238 No error code. This should never be see
239
240 Sys::Virt::Error::ERR_OPEN_FAILED
241 Unable to open a configuration file
242
243 Sys::Virt::Error::ERR_OPERATIONED_DENIED
244 The operation is forbidden for the current connection
245
246 Sys::Virt::Error::ERR_OPERATION_FAILED
247 The operation failed to complete
248
249 Sys::Virt::Error::ERR_OS_TYPE
250 Missing/incorrect OS type in domain configuration
251
252 Sys::Virt::Error::ERR_PARSE_FAILED
253 Failed to parse configuration file
254
255 Sys::Virt::Error::ERR_POST_FAILED
256 HTTP POST failure talking to XenD
257
258 Sys::Virt::Error::ERR_READ_FAILED
259 Unable to read from configuration file
260
261 Sys::Virt::Error::ERR_RPC
262 Generic RPC error talking to XenD
263
264 Sys::Virt::Error::ERR_SEXPR_SERIAL
265 Failed to generic SEXPR for XenD
266
267 Sys::Virt::Error::ERR_SYSTEM_ERROR
268 Generic operating system error
269
270 Sys::Virt::Error::ERR_UNKNOWN_HOST
271 Unknown hostname
272
273 Sys::Virt::Error::ERR_WRITE_FAILED
274 Failed to write to configuration file
275
276 Sys::Virt::Error::ERR_XEN_CALL
277 Failure while talking to Xen hypervisor
278
279 Sys::Virt::Error::ERR_XML_DETAIL
280 Detailed XML parsing error
281
282 Sys::Virt::Error::ERR_XML_ERROR
283 Generic XML parsing error
284
285 Sys::Virt::Error::WAR_NO_NETWORK
286 Warning that no network driver is activated
287
288 Sys::Virt::Error::WAR_NO_NODE
289 Warning that no node device driver is activated
290
291 Sys::Virt::Error::WAR_NO_STORAGE
292 Warning that no storage driver is activated
293
294 Sys::Virt::Error::ERR_INVALID_INTERFACE
295 Invalid network interface object
296
297 Sys::Virt::Error::ERR_NO_INTERFACE
298 No interface with the matching name / mac address
299
300 Sys::Virt::Error::ERR_OPERATION_INVALID
301 The requested operation is not valid for the current object state
302
303 Sys::Virt::Error::WAR_NO_INTERFACE
304 The network interface driver is not available
305
306 Sys::Virt::Error::ERR_MULTIPLE_INTERFACES
307 There are multiple interfaces with the requested MAC address
308
309 Sys::Virt::Error::WAR_NO_SECRET
310 There secret management driver is not available
311
312 Sys::Virt::Error::ERR_NO_SECRET
313 No secret with the matching uuid / usage ID
314
315 Sys::Virt::Error::ERR_INVALID_SECRET
316 Invalid secret object
317
318 Sys::Virt::Error::ERR_CONFIG_UNSUPPORTED
319 The requested XML configuration is not supported by the hypervisor
320
321 Sys::Virt::Error::ERR_OPERATION_TIMEOUT
322 The operation could not be completed in a satisfactory time
323
324 Sys::Virt::Error::ERR_MIGRATE_PERSIST_FAILED
325 Unable to persistent the domain configuration after migration
326 successfully completed
327
329 Daniel P. Berrange <berrange@redhat.com>
330
332 Copyright (C) 2006 Red Hat Copyright (C) 2006-2007 Daniel P. Berrange
333
335 This program is free software; you can redistribute it and/or modify it
336 under the terms of either the GNU General Public License as published
337 by the Free Software Foundation (either version 2 of the License, or at
338 your option any later version), or, the Artistic License, as specified
339 in the Perl README file.
340
342 Sys::Virt::Domain, Sys::Virt, "http://libvirt.org"
343
344
345
346perl v5.12.3 2010-05-19 Sys::Virt::Error(3)