Sys::Virt::Error(3pm) User Contributed Perl Documentation Sys::Virt::Error(3pm)
NAME
Sys::Virt::Error - error object for libvirt APIs
DESCRIPTION
The "Sys::Virt::Error" class provides an encoding of the libvirt errors. Instances of this object can be thrown by pretty much any of the
Sys::Virt APIs.
METHODS
$err->stringify
Convert the object into string format suitable for printing on a console to inform a user of the error.
my $code = $err->level
Return the raw error level represented by this error. One of the ERROR LEVEL CONSTANTS
my $code = $err->code
Return the raw error code represented by this error. One of the ERROR CODE CONSTANTS
my $from = $err->domain
Return the error domain raising this error. One of the ERROR DOMAIN CONSTANTS
my $msg = $err->message
Return an informative message describing the error condition.
CONSTANTS
ERROR LEVEL CONSTANTS
Sys::Virt::Error::LEVEL_NONE
Undefined error level
Sys::Virt::Error::LEVEL_WARNING
Warning error level
Sys::Virt::Error::LEVEL_ERROR
Fatal error level
ERROR DOMAIN CONSTANTS
The error domain indicates which internal part of libvirt the error report was raised from.
Sys::Virt::Error::FROM_CONF
Configuration file handling
Sys::Virt::Error::FROM_DOM
Error while operating on a domain
Sys::Virt::Error::FROM_DOMAIN
Domain configuration handling
Sys::Virt::Error::FROM_LXC
LXC virtualization driver
Sys::Virt::Error::FROM_NET
Error while operating on a network
Sys::Virt::Error::FROM_NETWORK
Network configuration handling
Sys::Virt::Error::FROM_NODEDEV
Node device configuration handling
Sys::Virt::Error::FROM_NONE
No specific error domain.
Sys::Virt::Error::FROM_OPENVZ
OpenVZ virtualization driver
Sys::Virt::Error::FROM_PROXY
Xen proxy virtualization driver
Sys::Virt::Error::FROM_QEMU
QEMU virtualization driver
Sys::Virt::Error::FROM_REMOTE
Remote client virtualization driver
Sys::Virt::Error::FROM_RPC
XML-RPC handling code
Sys::Virt::Error::FROM_SECURITY
Security services driver
Sys::Virt::Error::FROM_SEXPR
SEXPR parsing code
Sys::Virt::Error::FROM_STATS_LINUX
Device statistics code
Sys::Virt::Error::FROM_STORAGE
Storage configuration handling
Sys::Virt::Error::FROM_TEST
Test virtualization driver
Sys::Virt::Error::FROM_UML
UML virtualization driver
Sys::Virt::Error::FROM_XEN
Xen hypervisor driver
Sys::Virt::Error::FROM_XEND
XenD daemon driver
Sys::Virt::Error::FROM_XENSTORE
XenStore driver
Sys::Virt::Error::FROM_XENXM
Xen XM configuration file driver
Sys::Virt::Error::FROM_XEN_INOTIFY
Xen Inotify events driver
Sys::Virt::Error::FROM_XML
Low level XML parser
Sys::Virt::Error::FROM_ESX
The VMWare ESX driver
Sys::Virt::Error::FROM_INTERFACE
The host network interface driver
Sys::Virt::Error::FROM_ONE
The Open Nebula driver. This constant is no longer used and retained only for backwards compatibility
Sys::Virt::Error::FROM_PHYP
The IBM Power Hypervisor driver
Sys::Virt::Error::FROM_SECRET
The secret management driver
Sys::Virt::Error::FROM_VBOX
The VirtualBox driver
Sys::Virt::Error::FROM_AUDIT
The audit driver
Sys::Virt::Error::FROM_CPU
The CPU information driver
Sys::Virt::Error::FROM_DOMAIN_SNAPSHOT
The domain snapshot driver
Sys::Virt::Error::FROM_HOOK
The daemon hook driver
Sys::Virt::Error::FROM_NWFILTER
The network filter driver
Sys::Virt::Error::FROM_STREAMS
The data streams driver
Sys::Virt::Error::FROM_SYSINFO
The system information driver
Sys::Virt::Error::FROM_VMWARE
The VMWare driver
Sys::Virt::Error::FROM_XENAPI
The XenAPI driver
Sys::Virt::Error::FROM_EVENT
The event driver
Sys::Virt::Error::FROM_LIBXL
The libxl Xen driver
Sys::Virt::Error::FROM_LOCKING
The lock manager drivers
Sys::Virt::Error::FROM_HYPERV
The Hyper-V driver
Sys::Virt::Error::FROM_CAPABILITIES
The capabilities driver
Sys::Virt::Error::FROM_AUTH
The authentication handling code
Sys::Virt::Error::FROM_URI
The URI handling code
Sys::Virt::Error::FROM_DBUS
The DBus handling code
ERROR CODE CONSTANTS
The error codes allow for specific problems to be identified and handled separately from generic error handling.
Sys::Virt::Error::ERR_AUTH_FAILED
Authentication falure when connecting to a driver
Sys::Virt::Error::ERR_CALL_FAILED
Operation not supported by driver (DEPRECATED & unused)
Sys::Virt::Error::ERR_CONF_SYNTAX
Configuration file syntax error
Sys::Virt::Error::ERR_DOM_EXIST
The domain already exists
Sys::Virt::Error::ERR_DRIVER_FULL
Too many hypervisor drivers have been registered
Sys::Virt::Error::ERR_GET_FAILED
HTTP GET command failed talking to XenD
Sys::Virt::Error::ERR_GNUTLS_ERROR
GNUTLS encryption error in RPC driver
Sys::Virt::Error::ERR_HTTP_ERROR
Unexpected HTTP error code from XenD
Sys::Virt::Error::ERR_INTERNAL_ERROR
Generic internal error
Sys::Virt::Error::ERR_INVALID_ARG
Invalid argument supplied to function
Sys::Virt::Error::ERR_INVALID_CONN
Invalid connection object
Sys::Virt::Error::ERR_INVALID_DOMAIN
Invalid domain object
Sys::Virt::Error::ERR_INVALID_MAC
Invalid MAC address string
Sys::Virt::Error::ERR_INVALID_NETWORK
Invalid network object
Sys::Virt::Error::ERR_INVALID_NODE_DEVICE
Invalid node device object
Sys::Virt::Error::ERR_INVALID_STORAGE_POOL
Invalid storage pool object
Sys::Virt::Error::ERR_INVALID_STORAGE_VOL
Invalid storage vol object
Sys::Virt::Error::ERR_NETWORK_EXIST
Network with this name/uuid already exists
Sys::Virt::Error::ERR_NO_CONNECT
Unable to connect to requested hypervisor driver
Sys::Virt::Error::ERR_NO_DEVICE
Missing device information
Sys::Virt::Error::ERR_NO_DOMAIN
No such domain with that name/uuid/id
Sys::Virt::Error::ERR_NO_KERNEL
Missing kernel information in domain configuration
Sys::Virt::Error::ERR_NO_MEMORY
Missing memory information in domain configuration
Sys::Virt::Error::ERR_NO_NAME
Missing name in object configuration
Sys::Virt::Error::ERR_NO_NETWORK
No such network with that name/uuid
Sys::Virt::Error::ERR_NO_NODE_DEVICE
No such node device with that name
Sys::Virt::Error::ERR_NO_OS
Missing OS information in domain configuration
Sys::Virt::Error::ERR_NO_ROOT
Missing root device information in domain configuration
Sys::Virt::Error::ERR_NO_SECURITY_MODEL
Missing security model information in domain configuratio
Sys::Virt::Error::ERR_NO_SOURCE
Missing source device information in domain configuration
Sys::Virt::Error::ERR_NO_STORAGE_POOL
No such storage pool with that name/uuid
Sys::Virt::Error::ERR_NO_STORAGE_VOL
No such storage volume with that name/path/key
Sys::Virt::Error::ERR_NO_SUPPORT
This operation is not supported by the active driver
Sys::Virt::Error::ERR_NO_TARGET
Missing target device information in domain configuration
Sys::Virt::Error::ERR_NO_XEN
Unable to connect to Xen hypervisor
Sys::Virt::Error::ERR_NO_XENSTORE
Unable to connect to XenStorage daemon
Sys::Virt::Error::ERR_OK
No error code. This should never be see
Sys::Virt::Error::ERR_OPEN_FAILED
Unable to open a configuration file
Sys::Virt::Error::ERR_OPERATIONED_DENIED
The operation is forbidden for the current connection
Sys::Virt::Error::ERR_OPERATION_FAILED
The operation failed to complete
Sys::Virt::Error::ERR_OS_TYPE
Missing/incorrect OS type in domain configuration
Sys::Virt::Error::ERR_PARSE_FAILED
Failed to parse configuration file
Sys::Virt::Error::ERR_POST_FAILED
HTTP POST failure talking to XenD
Sys::Virt::Error::ERR_READ_FAILED
Unable to read from configuration file
Sys::Virt::Error::ERR_RPC
Generic RPC error talking to XenD
Sys::Virt::Error::ERR_SEXPR_SERIAL
Failed to generic SEXPR for XenD
Sys::Virt::Error::ERR_SYSTEM_ERROR
Generic operating system error
Sys::Virt::Error::ERR_UNKNOWN_HOST
Unknown hostname
Sys::Virt::Error::ERR_WRITE_FAILED
Failed to write to configuration file
Sys::Virt::Error::ERR_XEN_CALL
Failure while talking to Xen hypervisor
Sys::Virt::Error::ERR_XML_DETAIL
Detailed XML parsing error
Sys::Virt::Error::ERR_XML_ERROR
Generic XML parsing error
Sys::Virt::Error::WAR_NO_NETWORK
Warning that no network driver is activated
Sys::Virt::Error::WAR_NO_NODE
Warning that no node device driver is activated
Sys::Virt::Error::WAR_NO_STORAGE
Warning that no storage driver is activated
Sys::Virt::Error::ERR_INVALID_INTERFACE
Invalid network interface object
Sys::Virt::Error::ERR_NO_INTERFACE
No interface with the matching name / mac address
Sys::Virt::Error::ERR_OPERATION_INVALID
The requested operation is not valid for the current object state
Sys::Virt::Error::WAR_NO_INTERFACE
The network interface driver is not available
Sys::Virt::Error::ERR_MULTIPLE_INTERFACES
There are multiple interfaces with the requested MAC address
Sys::Virt::Error::ERR_BUILD_FIREWALL
The firwall could not be constructed
Sys::Virt::Error::WAR_NO_NWFILTER
The network filter driver could not be activated
Sys::Virt::Error::ERR_NO_NWFILTER
There is no network filter driver available
Sys::Virt::Error::ERR_INVALID_NWFILTER
The network filter object was invalid
Sys::Virt::Error::WAR_NO_SECRET
There secret management driver is not available
Sys::Virt::Error::ERR_NO_SECRET
No secret with the matching uuid / usage ID
Sys::Virt::Error::ERR_INVALID_SECRET
Invalid secret object
Sys::Virt::Error::ERR_CONFIG_UNSUPPORTED
The requested XML configuration is not supported by the hypervisor
Sys::Virt::Error::ERR_OPERATION_TIMEOUT
The operation could not be completed in a satisfactory time
Sys::Virt::Error::ERR_MIGRATE_PERSIST_FAILED
Unable to persistent the domain configuration after migration successfully completed
Sys::Virt::Error::ERR_HOOK_SCRIPT_FAILED
Execution of a daemon hook script failed
Sys::Virt::Error::ERR_INVALID_DOMAIN_SNAPSHOT
The domain snapshot object pointer was invalid
Sys::Virt::Error::ERR_NO_DOMAIN_SNAPSHOT
No matching domain snapshot was found
Sys::Virt::Error::ERR_INVALID_STREAM
The stream object pointer was invalid
Sys::Virt::Error::ERR_ARGUMENT_UNSUPPORTED
The argument value was not supported by the driver
Sys::Virt::Error::ERR_STORAGE_POOL_BUILT
The storage pool has already been built
Sys::Virt::Error::ERR_STORAGE_PROBE_FAILED
Probing the storage pool failed
Sys::Virt::Error::ERR_SNAPSHOT_REVERT_RISKY
Reverting the snapshot could cause data loss
Sys::Virt::Error::ERR_OPERATION_ABORTED
The asynchronous operation was aborted at admin request
Sys::Virt::Error::ERR_AUTH_CANCELLED
The user cancelled the authentication process
Sys::Virt::Error::ERR_NO_DOMAIN_METADATA
The requested metadata does not exist
Sys::Virt::Error::ERR_MIGRATE_UNSAFE
The migration operation would be unsafe to perform
Sys::Virt::Error::ERR_OVERFLOW
The calculation would overflow
Sys::Virt::Error::ERR_BLOCK_COPY_ACTIVE
Action prevented by block copy job
AUTHORS
Daniel P. Berrange <berrange@redhat.com>
COPYRIGHT
Copyright (C) 2006 Red Hat Copyright (C) 2006-2007 Daniel P. Berrange
LICENSE
This program is free software; you can redistribute it and/or modify it under the terms of either the GNU General Public License as
published by the Free Software Foundation (either version 2 of the License, or at your option any later version), or, the Artistic License,
as specified in the Perl README file.
SEE ALSO
Sys::Virt::Domain, Sys::Virt, "http://libvirt.org"
perl v5.14.2 2012-05-21 Sys::Virt::Error(3pm)