Sys::Virt::Error(3pm)

1Sys::Virt::Error(3)   User Contributed Perl Documentation  Sys::Virt::Error(3)
2
3
4

NAME

6       Sys::Virt::Error - error object for libvirt APIs
7

DESCRIPTION

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

METHODS

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

CONSTANTS

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

AUTHORS

329       Daniel P. Berrange <berrange@redhat.com>
330

COPYRIGHT

332       Copyright (C) 2006 Red Hat Copyright (C) 2006-2007 Daniel P. Berrange
333

LICENSE

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