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

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

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.

CPAN RT