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->code: Return the raw error code represented by this error.
my $from = $err->domain: Return the error domain raising this error.
my $msg = $err->message: Return an informative message describing the error condition.

CONSTANTS

ERROR DOMAINS: 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; 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
ERROR CODES: 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::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

AUTHORS

Daniel P. Berrange <berrange@redhat.com>

COPYRIGHT

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.

docs.sk

comprehensive documentation repository

Most Viewed