GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SYS::VIRT::ERROR (3)

.ds Aq ’

NAME

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

CONTENTS

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
Sys::Virt::Error::FROM_DEVICE The device handling code
Sys::Virt::Error::FROM_SSH The libSSH2 socket client
Sys::Virt::Error::FROM_PARALLELS The Parallels virtualization driver
Sys::Virt::Error::FROM_LOCKSPACE The lockspace handling code
Sys::Virt::Error::FROM_INITCTL The initctl client code
Sys::Virt::Error::FROM_CGROUP The cgroups code
Sys::Virt::Error::FROM_IDENTITY The identity management code
Sys::Virt::Error::FROM_ACCESS The access control code
Sys::Virt::Error::FROM_SYSTEMD The systemd init service

    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
Sys::Virt::Error::ERR_AGENT_UNRESPONSIVE The guest agent is not responding
Sys::Virt::Error::ERR_OPERATION_UNSUPPORTED The operation is not supported on this host
Sys::Virt::Error::ERR_SSH The SSH operation failed
Sys::Virt::Error::ERR_RESOURCE_BUSY The resource requested is already in use
Sys::Virt::Error::ERR_ACCESS_DENIED Not authorized to perform the operation
Sys::Virt::Error::ERR_DBUS_SERVICE An error from a DBus service API

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
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 SYS::VIRT::ERROR (3) 2013-07-30

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.