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
Sys::Virt::Error(3) User Contributed Perl Documentation Sys::Virt::Error(3)

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

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.

$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.

Sys::Virt::Error::LEVEL_NONE
Undefined error level
Sys::Virt::Error::LEVEL_WARNING
Warning error level
Sys::Virt::Error::LEVEL_ERROR
Fatal error level

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

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

Daniel P. Berrange <berrange@redhat.com>

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

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.

Sys::Virt::Domain, Sys::Virt, "http://libvirt.org"
2013-07-30 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

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