.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Sys::Virt::Error 3pm"
.TH Sys::Virt::Error 3pm 2024-01-21 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Sys::Virt::Error \- Error object for libvirt APIs
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \f(CW\*(C`Sys::Virt::Error\*(C'\fR class provides an encoding of the
libvirt errors. Instances of this object can be thrown by
pretty much any of the Sys::Virt APIs.
.SH METHODS
.IX Header "METHODS"
.ie n .IP $err\->stringify 4
.el .IP \f(CW$err\fR\->stringify 4
.IX Item "$err->stringify"
Convert the object into string format suitable for printing on a
console to inform a user of the error.
.ie n .IP "my $level = $err\->level" 4
.el .IP "my \f(CW$level\fR = \f(CW$err\fR\->level" 4
.IX Item "my $level = $err->level"
Return the raw error level represented by this error. One of the
ERROR LEVEL CONSTANTS
.ie n .IP "my $code = $err\->code" 4
.el .IP "my \f(CW$code\fR = \f(CW$err\fR\->code" 4
.IX Item "my $code = $err->code"
Return the raw error code represented by this error. One of the
ERROR CODE CONSTANTS
.ie n .IP "my $from = $err\->domain" 4
.el .IP "my \f(CW$from\fR = \f(CW$err\fR\->domain" 4
.IX Item "my $from = $err->domain"
Return the error domain raising this error. One of the ERROR
DOMAIN CONSTANTS
.ie n .IP "my $msg = $err\->message" 4
.el .IP "my \f(CW$msg\fR = \f(CW$err\fR\->message" 4
.IX Item "my $msg = $err->message"
Return an informative message describing the error condition.
.SH CONSTANTS
.IX Header "CONSTANTS"
.SS "ERROR LEVEL CONSTANTS"
.IX Subsection "ERROR LEVEL CONSTANTS"
.IP Sys::Virt::Error::LEVEL_NONE 4
.IX Item "Sys::Virt::Error::LEVEL_NONE"
Undefined error level
.IP Sys::Virt::Error::LEVEL_WARNING 4
.IX Item "Sys::Virt::Error::LEVEL_WARNING"
Warning error level
.IP Sys::Virt::Error::LEVEL_ERROR 4
.IX Item "Sys::Virt::Error::LEVEL_ERROR"
Fatal error level
.SS "ERROR DOMAIN CONSTANTS"
.IX Subsection "ERROR DOMAIN CONSTANTS"
The error domain indicates which internal part of libvirt the error
report was raised from.
.IP Sys::Virt::Error::FROM_CONF 4
.IX Item "Sys::Virt::Error::FROM_CONF"
Configuration file handling
.IP Sys::Virt::Error::FROM_DOM 4
.IX Item "Sys::Virt::Error::FROM_DOM"
Error while operating on a domain
.IP Sys::Virt::Error::FROM_DOMAIN 4
.IX Item "Sys::Virt::Error::FROM_DOMAIN"
Domain configuration handling
.IP Sys::Virt::Error::FROM_LXC 4
.IX Item "Sys::Virt::Error::FROM_LXC"
LXC virtualization driver
.IP Sys::Virt::Error::FROM_NET 4
.IX Item "Sys::Virt::Error::FROM_NET"
Error while operating on a network
.IP Sys::Virt::Error::FROM_NETWORK 4
.IX Item "Sys::Virt::Error::FROM_NETWORK"
Network configuration handling
.IP Sys::Virt::Error::FROM_NODEDEV 4
.IX Item "Sys::Virt::Error::FROM_NODEDEV"
Node device configuration handling
.IP Sys::Virt::Error::FROM_NONE 4
.IX Item "Sys::Virt::Error::FROM_NONE"
No specific error domain.
.IP Sys::Virt::Error::FROM_OPENVZ 4
.IX Item "Sys::Virt::Error::FROM_OPENVZ"
OpenVZ virtualization driver
.IP Sys::Virt::Error::FROM_PROXY 4
.IX Item "Sys::Virt::Error::FROM_PROXY"
Xen proxy virtualization driver
.IP Sys::Virt::Error::FROM_QEMU 4
.IX Item "Sys::Virt::Error::FROM_QEMU"
QEMU virtualization driver
.IP Sys::Virt::Error::FROM_REMOTE 4
.IX Item "Sys::Virt::Error::FROM_REMOTE"
Remote client virtualization driver
.IP Sys::Virt::Error::FROM_RPC 4
.IX Item "Sys::Virt::Error::FROM_RPC"
XML-RPC handling code
.IP Sys::Virt::Error::FROM_SECURITY 4
.IX Item "Sys::Virt::Error::FROM_SECURITY"
Security services driver
.IP Sys::Virt::Error::FROM_SEXPR 4
.IX Item "Sys::Virt::Error::FROM_SEXPR"
SEXPR parsing code
.IP Sys::Virt::Error::FROM_STATS_LINUX 4
.IX Item "Sys::Virt::Error::FROM_STATS_LINUX"
Device statistics code
.IP Sys::Virt::Error::FROM_STORAGE 4
.IX Item "Sys::Virt::Error::FROM_STORAGE"
Storage configuration handling
.IP Sys::Virt::Error::FROM_TEST 4
.IX Item "Sys::Virt::Error::FROM_TEST"
Test virtualization driver
.IP Sys::Virt::Error::FROM_UML 4
.IX Item "Sys::Virt::Error::FROM_UML"
UML virtualization driver
.IP Sys::Virt::Error::FROM_XEN 4
.IX Item "Sys::Virt::Error::FROM_XEN"
Xen hypervisor driver
.IP Sys::Virt::Error::FROM_XEND 4
.IX Item "Sys::Virt::Error::FROM_XEND"
XenD daemon driver
.IP Sys::Virt::Error::FROM_XENSTORE 4
.IX Item "Sys::Virt::Error::FROM_XENSTORE"
XenStore driver
.IP Sys::Virt::Error::FROM_XENXM 4
.IX Item "Sys::Virt::Error::FROM_XENXM"
Xen XM configuration file driver
.IP Sys::Virt::Error::FROM_XEN_INOTIFY 4
.IX Item "Sys::Virt::Error::FROM_XEN_INOTIFY"
Xen Inotify events driver
.IP Sys::Virt::Error::FROM_XML 4
.IX Item "Sys::Virt::Error::FROM_XML"
Low level XML parser
.IP Sys::Virt::Error::FROM_ESX 4
.IX Item "Sys::Virt::Error::FROM_ESX"
The VMWare ESX driver
.IP Sys::Virt::Error::FROM_INTERFACE 4
.IX Item "Sys::Virt::Error::FROM_INTERFACE"
The host network interface driver
.IP Sys::Virt::Error::FROM_ONE 4
.IX Item "Sys::Virt::Error::FROM_ONE"
The Open Nebula driver. This constant is no longer
used and retained only for backwards compatibility
.IP Sys::Virt::Error::FROM_PHYP 4
.IX Item "Sys::Virt::Error::FROM_PHYP"
The IBM Power Hypervisor driver
.IP Sys::Virt::Error::FROM_SECRET 4
.IX Item "Sys::Virt::Error::FROM_SECRET"
The secret management driver
.IP Sys::Virt::Error::FROM_VBOX 4
.IX Item "Sys::Virt::Error::FROM_VBOX"
The VirtualBox driver
.IP Sys::Virt::Error::FROM_AUDIT 4
.IX Item "Sys::Virt::Error::FROM_AUDIT"
The audit driver
.IP Sys::Virt::Error::FROM_CPU 4
.IX Item "Sys::Virt::Error::FROM_CPU"
The CPU information driver
.IP Sys::Virt::Error::FROM_DOMAIN_SNAPSHOT 4
.IX Item "Sys::Virt::Error::FROM_DOMAIN_SNAPSHOT"
The domain snapshot driver
.IP Sys::Virt::Error::FROM_HOOK 4
.IX Item "Sys::Virt::Error::FROM_HOOK"
The daemon hook driver
.IP Sys::Virt::Error::FROM_NWFILTER 4
.IX Item "Sys::Virt::Error::FROM_NWFILTER"
The network filter driver
.IP Sys::Virt::Error::FROM_STREAMS 4
.IX Item "Sys::Virt::Error::FROM_STREAMS"
The data streams driver
.IP Sys::Virt::Error::FROM_SYSINFO 4
.IX Item "Sys::Virt::Error::FROM_SYSINFO"
The system information driver
.IP Sys::Virt::Error::FROM_VMWARE 4
.IX Item "Sys::Virt::Error::FROM_VMWARE"
The VMWare driver
.IP Sys::Virt::Error::FROM_XENAPI 4
.IX Item "Sys::Virt::Error::FROM_XENAPI"
The XenAPI driver
.IP Sys::Virt::Error::FROM_EVENT 4
.IX Item "Sys::Virt::Error::FROM_EVENT"
The event driver
.IP Sys::Virt::Error::FROM_LIBXL 4
.IX Item "Sys::Virt::Error::FROM_LIBXL"
The libxl Xen driver
.IP Sys::Virt::Error::FROM_LOCKING 4
.IX Item "Sys::Virt::Error::FROM_LOCKING"
The lock manager drivers
.IP Sys::Virt::Error::FROM_HYPERV 4
.IX Item "Sys::Virt::Error::FROM_HYPERV"
The Hyper-V driver
.IP Sys::Virt::Error::FROM_CAPABILITIES 4
.IX Item "Sys::Virt::Error::FROM_CAPABILITIES"
The capabilities driver
.IP Sys::Virt::Error::FROM_AUTH 4
.IX Item "Sys::Virt::Error::FROM_AUTH"
The authentication handling code
.IP Sys::Virt::Error::FROM_URI 4
.IX Item "Sys::Virt::Error::FROM_URI"
The URI handling code
.IP Sys::Virt::Error::FROM_DBUS 4
.IX Item "Sys::Virt::Error::FROM_DBUS"
The DBus handling code
.IP Sys::Virt::Error::FROM_DEVICE 4
.IX Item "Sys::Virt::Error::FROM_DEVICE"
The device handling code
.IP Sys::Virt::Error::FROM_SSH 4
.IX Item "Sys::Virt::Error::FROM_SSH"
The libSSH2 socket client
.IP Sys::Virt::Error::FROM_PARALLELS 4
.IX Item "Sys::Virt::Error::FROM_PARALLELS"
The Parallels virtualization driver
.IP Sys::Virt::Error::FROM_LOCKSPACE 4
.IX Item "Sys::Virt::Error::FROM_LOCKSPACE"
The lockspace handling code
.IP Sys::Virt::Error::FROM_INITCTL 4
.IX Item "Sys::Virt::Error::FROM_INITCTL"
The initctl client code
.IP Sys::Virt::Error::FROM_CGROUP 4
.IX Item "Sys::Virt::Error::FROM_CGROUP"
The cgroups code
.IP Sys::Virt::Error::FROM_IDENTITY 4
.IX Item "Sys::Virt::Error::FROM_IDENTITY"
The identity management code
.IP Sys::Virt::Error::FROM_ACCESS 4
.IX Item "Sys::Virt::Error::FROM_ACCESS"
The access control code
.IP Sys::Virt::Error::FROM_SYSTEMD 4
.IX Item "Sys::Virt::Error::FROM_SYSTEMD"
The systemd init service
.IP Sys::Virt::Error::FROM_BHYVE 4
.IX Item "Sys::Virt::Error::FROM_BHYVE"
The FreeBSD BHyve driver
.IP Sys::Virt::Error::FROM_CRYPTO 4
.IX Item "Sys::Virt::Error::FROM_CRYPTO"
The cryptographic helper APIs.
.IP Sys::Virt::Error::FROM_FIREWALL 4
.IX Item "Sys::Virt::Error::FROM_FIREWALL"
The firewall helper APIs.
.IP Sys::Virt::Error::FROM_POLKIT 4
.IX Item "Sys::Virt::Error::FROM_POLKIT"
The polkit authentication / authorization APIs
.IP Sys::Virt::Error::FROM_THREAD 4
.IX Item "Sys::Virt::Error::FROM_THREAD"
The thread helper utils
.IP Sys::Virt::Error::FROM_ADMIN 4
.IX Item "Sys::Virt::Error::FROM_ADMIN"
The administrative service
.IP Sys::Virt::Error::FROM_LOGGING 4
.IX Item "Sys::Virt::Error::FROM_LOGGING"
The logging service
.IP Sys::Virt::Error::FROM_XENXL 4
.IX Item "Sys::Virt::Error::FROM_XENXL"
The Xen XL driver
.IP Sys::Virt::Error::FROM_PERF 4
.IX Item "Sys::Virt::Error::FROM_PERF"
The performance events subsystem
.IP Sys::Virt::Error::FROM_LIBSSH 4
.IX Item "Sys::Virt::Error::FROM_LIBSSH"
The libSSH socket client
.IP Sys::Virt::Error::FROM_RESCTRL 4
.IX Item "Sys::Virt::Error::FROM_RESCTRL"
The resource control subsystem
.IP Sys::Virt::Error::FROM_FIREWALLD 4
.IX Item "Sys::Virt::Error::FROM_FIREWALLD"
The firewalld service
.IP Sys::Virt::Error::FROM_DOMAIN_CHECKPOINT 4
.IX Item "Sys::Virt::Error::FROM_DOMAIN_CHECKPOINT"
The domain checkpoint
.IP Sys::Virt::Error::FROM_TPM 4
.IX Item "Sys::Virt::Error::FROM_TPM"
The TPM subsystem
.IP Sys::Virt::Error::FROM_BPF 4
.IX Item "Sys::Virt::Error::FROM_BPF"
The BPF subsystem
.IP Sys::Virt::Error::FROM_CH 4
.IX Item "Sys::Virt::Error::FROM_CH"
The Cloud Hypervisor driver
.SS "ERROR CODE CONSTANTS"
.IX Subsection "ERROR CODE CONSTANTS"
The error codes allow for specific problems to be identified and
handled separately from generic error handling.
.IP Sys::Virt::Error::ERR_AUTH_FAILED 4
.IX Item "Sys::Virt::Error::ERR_AUTH_FAILED"
Authentication failure when connecting to a driver
.IP Sys::Virt::Error::ERR_CALL_FAILED 4
.IX Item "Sys::Virt::Error::ERR_CALL_FAILED"
Operation not supported by driver (DEPRECATED & unused)
.IP Sys::Virt::Error::ERR_CONF_SYNTAX 4
.IX Item "Sys::Virt::Error::ERR_CONF_SYNTAX"
Configuration file syntax error
.IP Sys::Virt::Error::ERR_DOM_EXIST 4
.IX Item "Sys::Virt::Error::ERR_DOM_EXIST"
The domain already exists
.IP Sys::Virt::Error::ERR_DRIVER_FULL 4
.IX Item "Sys::Virt::Error::ERR_DRIVER_FULL"
Too many hypervisor drivers have been registered
.IP Sys::Virt::Error::ERR_GET_FAILED 4
.IX Item "Sys::Virt::Error::ERR_GET_FAILED"
HTTP GET command failed talking to XenD
.IP Sys::Virt::Error::ERR_GNUTLS_ERROR 4
.IX Item "Sys::Virt::Error::ERR_GNUTLS_ERROR"
GNUTLS encryption error in RPC driver
.IP Sys::Virt::Error::ERR_HTTP_ERROR 4
.IX Item "Sys::Virt::Error::ERR_HTTP_ERROR"
Unexpected HTTP error code from XenD
.IP Sys::Virt::Error::ERR_INTERNAL_ERROR 4
.IX Item "Sys::Virt::Error::ERR_INTERNAL_ERROR"
Generic internal error
.IP Sys::Virt::Error::ERR_INVALID_ARG 4
.IX Item "Sys::Virt::Error::ERR_INVALID_ARG"
Invalid argument supplied to function
.IP Sys::Virt::Error::ERR_INVALID_CONN 4
.IX Item "Sys::Virt::Error::ERR_INVALID_CONN"
Invalid connection object
.IP Sys::Virt::Error::ERR_INVALID_DOMAIN 4
.IX Item "Sys::Virt::Error::ERR_INVALID_DOMAIN"
Invalid domain object
.IP Sys::Virt::Error::ERR_INVALID_MAC 4
.IX Item "Sys::Virt::Error::ERR_INVALID_MAC"
Invalid MAC address string
.IP Sys::Virt::Error::ERR_INVALID_NETWORK 4
.IX Item "Sys::Virt::Error::ERR_INVALID_NETWORK"
Invalid network object
.IP Sys::Virt::Error::ERR_INVALID_NODE_DEVICE 4
.IX Item "Sys::Virt::Error::ERR_INVALID_NODE_DEVICE"
Invalid node device object
.IP Sys::Virt::Error::ERR_INVALID_STORAGE_POOL 4
.IX Item "Sys::Virt::Error::ERR_INVALID_STORAGE_POOL"
Invalid storage pool object
.IP Sys::Virt::Error::ERR_INVALID_STORAGE_VOL 4
.IX Item "Sys::Virt::Error::ERR_INVALID_STORAGE_VOL"
Invalid storage vol object
.IP Sys::Virt::Error::ERR_NETWORK_EXIST 4
.IX Item "Sys::Virt::Error::ERR_NETWORK_EXIST"
Network with this name/uuid already exists
.IP Sys::Virt::Error::ERR_NO_CONNECT 4
.IX Item "Sys::Virt::Error::ERR_NO_CONNECT"
Unable to connect to requested hypervisor driver
.IP Sys::Virt::Error::ERR_NO_DEVICE 4
.IX Item "Sys::Virt::Error::ERR_NO_DEVICE"
Missing device information
.IP Sys::Virt::Error::ERR_NO_DOMAIN 4
.IX Item "Sys::Virt::Error::ERR_NO_DOMAIN"
No such domain with that name/uuid/id
.IP Sys::Virt::Error::ERR_NO_KERNEL 4
.IX Item "Sys::Virt::Error::ERR_NO_KERNEL"
Missing kernel information in domain configuration
.IP Sys::Virt::Error::ERR_NO_MEMORY 4
.IX Item "Sys::Virt::Error::ERR_NO_MEMORY"
Missing memory information in domain configuration
.IP Sys::Virt::Error::ERR_NO_NAME 4
.IX Item "Sys::Virt::Error::ERR_NO_NAME"
Missing name in object configuration
.IP Sys::Virt::Error::ERR_NO_NETWORK 4
.IX Item "Sys::Virt::Error::ERR_NO_NETWORK"
No such network with that name/uuid
.IP Sys::Virt::Error::ERR_NO_NODE_DEVICE 4
.IX Item "Sys::Virt::Error::ERR_NO_NODE_DEVICE"
No such node device with that name
.IP Sys::Virt::Error::ERR_NO_OS 4
.IX Item "Sys::Virt::Error::ERR_NO_OS"
Missing OS information in domain configuration
.IP Sys::Virt::Error::ERR_NO_ROOT 4
.IX Item "Sys::Virt::Error::ERR_NO_ROOT"
Missing root device information in domain configuration
.IP Sys::Virt::Error::ERR_NO_SECURITY_MODEL 4
.IX Item "Sys::Virt::Error::ERR_NO_SECURITY_MODEL"
Missing security model information in domain configuration
.IP Sys::Virt::Error::ERR_NO_SOURCE 4
.IX Item "Sys::Virt::Error::ERR_NO_SOURCE"
Missing source device information in domain configuration
.IP Sys::Virt::Error::ERR_NO_STORAGE_POOL 4
.IX Item "Sys::Virt::Error::ERR_NO_STORAGE_POOL"
No such storage pool with that name/uuid
.IP Sys::Virt::Error::ERR_NO_STORAGE_VOL 4
.IX Item "Sys::Virt::Error::ERR_NO_STORAGE_VOL"
No such storage volume with that name/path/key
.IP Sys::Virt::Error::ERR_NO_SUPPORT 4
.IX Item "Sys::Virt::Error::ERR_NO_SUPPORT"
This operation is not supported by the active driver
.IP Sys::Virt::Error::ERR_NO_TARGET 4
.IX Item "Sys::Virt::Error::ERR_NO_TARGET"
Missing target device information in domain configuration
.IP Sys::Virt::Error::ERR_NO_XEN 4
.IX Item "Sys::Virt::Error::ERR_NO_XEN"
Unable to connect to Xen hypervisor
.IP Sys::Virt::Error::ERR_NO_XENSTORE 4
.IX Item "Sys::Virt::Error::ERR_NO_XENSTORE"
Unable to connect to XenStorage daemon
.IP Sys::Virt::Error::ERR_OK 4
.IX Item "Sys::Virt::Error::ERR_OK"
No error code. This should never be see
.IP Sys::Virt::Error::ERR_OPEN_FAILED 4
.IX Item "Sys::Virt::Error::ERR_OPEN_FAILED"
Unable to open a configuration file
.IP Sys::Virt::Error::ERR_OPERATIONED_DENIED 4
.IX Item "Sys::Virt::Error::ERR_OPERATIONED_DENIED"
The operation is forbidden for the current connection
.IP Sys::Virt::Error::ERR_OPERATION_FAILED 4
.IX Item "Sys::Virt::Error::ERR_OPERATION_FAILED"
The operation failed to complete
.IP Sys::Virt::Error::ERR_OS_TYPE 4
.IX Item "Sys::Virt::Error::ERR_OS_TYPE"
Missing/incorrect OS type in domain configuration
.IP Sys::Virt::Error::ERR_PARSE_FAILED 4
.IX Item "Sys::Virt::Error::ERR_PARSE_FAILED"
Failed to parse configuration file
.IP Sys::Virt::Error::ERR_POST_FAILED 4
.IX Item "Sys::Virt::Error::ERR_POST_FAILED"
HTTP POST failure talking to XenD
.IP Sys::Virt::Error::ERR_READ_FAILED 4
.IX Item "Sys::Virt::Error::ERR_READ_FAILED"
Unable to read from configuration file
.IP Sys::Virt::Error::ERR_RPC 4
.IX Item "Sys::Virt::Error::ERR_RPC"
Generic RPC error talking to XenD
.IP Sys::Virt::Error::ERR_SEXPR_SERIAL 4
.IX Item "Sys::Virt::Error::ERR_SEXPR_SERIAL"
Failed to generic SEXPR for XenD
.IP Sys::Virt::Error::ERR_SYSTEM_ERROR 4
.IX Item "Sys::Virt::Error::ERR_SYSTEM_ERROR"
Generic operating system error
.IP Sys::Virt::Error::ERR_UNKNOWN_HOST 4
.IX Item "Sys::Virt::Error::ERR_UNKNOWN_HOST"
Unknown hostname
.IP Sys::Virt::Error::ERR_WRITE_FAILED 4
.IX Item "Sys::Virt::Error::ERR_WRITE_FAILED"
Failed to write to configuration file
.IP Sys::Virt::Error::ERR_XEN_CALL 4
.IX Item "Sys::Virt::Error::ERR_XEN_CALL"
Failure while talking to Xen hypervisor
.IP Sys::Virt::Error::ERR_XML_DETAIL 4
.IX Item "Sys::Virt::Error::ERR_XML_DETAIL"
Detailed XML parsing error
.IP Sys::Virt::Error::ERR_XML_ERROR 4
.IX Item "Sys::Virt::Error::ERR_XML_ERROR"
Generic XML parsing error
.IP Sys::Virt::Error::WAR_NO_NETWORK 4
.IX Item "Sys::Virt::Error::WAR_NO_NETWORK"
Warning that no network driver is activated
.IP Sys::Virt::Error::WAR_NO_NODE 4
.IX Item "Sys::Virt::Error::WAR_NO_NODE"
Warning that no node device driver is activated
.IP Sys::Virt::Error::WAR_NO_STORAGE 4
.IX Item "Sys::Virt::Error::WAR_NO_STORAGE"
Warning that no storage driver is activated
.IP Sys::Virt::Error::ERR_INVALID_INTERFACE 4
.IX Item "Sys::Virt::Error::ERR_INVALID_INTERFACE"
Invalid network interface object
.IP Sys::Virt::Error::ERR_NO_INTERFACE 4
.IX Item "Sys::Virt::Error::ERR_NO_INTERFACE"
No interface with the matching name / mac address
.IP Sys::Virt::Error::ERR_OPERATION_INVALID 4
.IX Item "Sys::Virt::Error::ERR_OPERATION_INVALID"
The requested operation is not valid for the current object state
.IP Sys::Virt::Error::WAR_NO_INTERFACE 4
.IX Item "Sys::Virt::Error::WAR_NO_INTERFACE"
The network interface driver is not available
.IP Sys::Virt::Error::ERR_MULTIPLE_INTERFACES 4
.IX Item "Sys::Virt::Error::ERR_MULTIPLE_INTERFACES"
There are multiple interfaces with the requested MAC address
.IP Sys::Virt::Error::ERR_BUILD_FIREWALL 4
.IX Item "Sys::Virt::Error::ERR_BUILD_FIREWALL"
The firewall could not be constructed
.IP Sys::Virt::Error::WAR_NO_NWFILTER 4
.IX Item "Sys::Virt::Error::WAR_NO_NWFILTER"
The network filter driver could not be activated
.IP Sys::Virt::Error::ERR_NO_NWFILTER 4
.IX Item "Sys::Virt::Error::ERR_NO_NWFILTER"
There is no network filter driver available
.IP Sys::Virt::Error::ERR_INVALID_NWFILTER 4
.IX Item "Sys::Virt::Error::ERR_INVALID_NWFILTER"
The network filter object was invalid
.IP Sys::Virt::Error::WAR_NO_SECRET 4
.IX Item "Sys::Virt::Error::WAR_NO_SECRET"
There secret management driver is not available
.IP Sys::Virt::Error::ERR_NO_SECRET 4
.IX Item "Sys::Virt::Error::ERR_NO_SECRET"
No secret with the matching uuid / usage ID
.IP Sys::Virt::Error::ERR_INVALID_SECRET 4
.IX Item "Sys::Virt::Error::ERR_INVALID_SECRET"
Invalid secret object
.IP Sys::Virt::Error::ERR_CONFIG_UNSUPPORTED 4
.IX Item "Sys::Virt::Error::ERR_CONFIG_UNSUPPORTED"
The requested XML configuration is not supported by the hypervisor
.IP Sys::Virt::Error::ERR_OPERATION_TIMEOUT 4
.IX Item "Sys::Virt::Error::ERR_OPERATION_TIMEOUT"
The operation could not be completed in a satisfactory time
.IP Sys::Virt::Error::ERR_MIGRATE_PERSIST_FAILED 4
.IX Item "Sys::Virt::Error::ERR_MIGRATE_PERSIST_FAILED"
Unable to persistent the domain configuration after migration
successfully completed
.IP Sys::Virt::Error::ERR_HOOK_SCRIPT_FAILED 4
.IX Item "Sys::Virt::Error::ERR_HOOK_SCRIPT_FAILED"
Execution of a daemon hook script failed
.IP Sys::Virt::Error::ERR_INVALID_DOMAIN_SNAPSHOT 4
.IX Item "Sys::Virt::Error::ERR_INVALID_DOMAIN_SNAPSHOT"
The domain snapshot object pointer was invalid
.IP Sys::Virt::Error::ERR_NO_DOMAIN_SNAPSHOT 4
.IX Item "Sys::Virt::Error::ERR_NO_DOMAIN_SNAPSHOT"
No matching domain snapshot was found
.IP Sys::Virt::Error::ERR_INVALID_STREAM 4
.IX Item "Sys::Virt::Error::ERR_INVALID_STREAM"
The stream object pointer was invalid
.IP Sys::Virt::Error::ERR_ARGUMENT_UNSUPPORTED 4
.IX Item "Sys::Virt::Error::ERR_ARGUMENT_UNSUPPORTED"
The argument value was not supported by the driver
.IP Sys::Virt::Error::ERR_STORAGE_POOL_BUILT 4
.IX Item "Sys::Virt::Error::ERR_STORAGE_POOL_BUILT"
The storage pool has already been built
.IP Sys::Virt::Error::ERR_STORAGE_PROBE_FAILED 4
.IX Item "Sys::Virt::Error::ERR_STORAGE_PROBE_FAILED"
Probing the storage pool failed
.IP Sys::Virt::Error::ERR_SNAPSHOT_REVERT_RISKY 4
.IX Item "Sys::Virt::Error::ERR_SNAPSHOT_REVERT_RISKY"
Reverting the snapshot could cause data loss
.IP Sys::Virt::Error::ERR_OPERATION_ABORTED 4
.IX Item "Sys::Virt::Error::ERR_OPERATION_ABORTED"
The asynchronous operation was aborted at admin request
.IP Sys::Virt::Error::ERR_AUTH_CANCELLED 4
.IX Item "Sys::Virt::Error::ERR_AUTH_CANCELLED"
The user cancelled the authentication process
.IP Sys::Virt::Error::ERR_NO_DOMAIN_METADATA 4
.IX Item "Sys::Virt::Error::ERR_NO_DOMAIN_METADATA"
The requested metadata does not exist
.IP Sys::Virt::Error::ERR_MIGRATE_UNSAFE 4
.IX Item "Sys::Virt::Error::ERR_MIGRATE_UNSAFE"
The migration operation would be unsafe to perform
.IP Sys::Virt::Error::ERR_OVERFLOW 4
.IX Item "Sys::Virt::Error::ERR_OVERFLOW"
The calculation would overflow
.IP Sys::Virt::Error::ERR_BLOCK_COPY_ACTIVE 4
.IX Item "Sys::Virt::Error::ERR_BLOCK_COPY_ACTIVE"
Action prevented by block copy job
.IP Sys::Virt::Error::ERR_AGENT_UNRESPONSIVE 4
.IX Item "Sys::Virt::Error::ERR_AGENT_UNRESPONSIVE"
The guest agent is not responding
.IP Sys::Virt::Error::ERR_OPERATION_UNSUPPORTED 4
.IX Item "Sys::Virt::Error::ERR_OPERATION_UNSUPPORTED"
The operation is not supported on this host
.IP Sys::Virt::Error::ERR_SSH 4
.IX Item "Sys::Virt::Error::ERR_SSH"
The SSH operation failed
.IP Sys::Virt::Error::ERR_RESOURCE_BUSY 4
.IX Item "Sys::Virt::Error::ERR_RESOURCE_BUSY"
The resource requested is already in use
.IP Sys::Virt::Error::ERR_ACCESS_DENIED 4
.IX Item "Sys::Virt::Error::ERR_ACCESS_DENIED"
Not authorized to perform the operation
.IP Sys::Virt::Error::ERR_DBUS_SERVICE 4
.IX Item "Sys::Virt::Error::ERR_DBUS_SERVICE"
An error from a DBus service API
.IP Sys::Virt::Error::ERR_STORAGE_VOL_EXIST 4
.IX Item "Sys::Virt::Error::ERR_STORAGE_VOL_EXIST"
The storage volume already exists
.IP Sys::Virt::Error::ERR_CPU_INCOMPATIBLE 4
.IX Item "Sys::Virt::Error::ERR_CPU_INCOMPATIBLE"
The CPUs are not compatible
.IP Sys::Virt::Error::ERR_INVALID_SCHEMA 4
.IX Item "Sys::Virt::Error::ERR_INVALID_SCHEMA"
The XML document does not comply with the XML schema
.IP Sys::Virt::Error::ERR_MIGRATE_FINISH_OK 4
.IX Item "Sys::Virt::Error::ERR_MIGRATE_FINISH_OK"
Migration finished but expected to return NULL domain.
.IP Sys::Virt::Error::ERR_AUTH_UNAVAILABLE 4
.IX Item "Sys::Virt::Error::ERR_AUTH_UNAVAILABLE"
Authentication services were not available
.IP Sys::Virt::Error::ERR_NO_SERVER 4
.IX Item "Sys::Virt::Error::ERR_NO_SERVER"
Libvirt server was not found
.IP Sys::Virt::Error::ERR_NO_CLIENT 4
.IX Item "Sys::Virt::Error::ERR_NO_CLIENT"
Libvirt client was not found
.IP Sys::Virt::Error::ERR_AGENT_UNSYNCED 4
.IX Item "Sys::Virt::Error::ERR_AGENT_UNSYNCED"
Libvirt guest agent replies with wrong id to guest-sync command
.IP Sys::Virt::Error::ERR_LIBSSH 4
.IX Item "Sys::Virt::Error::ERR_LIBSSH"
The libSSH operation failed
.IP Sys::Virt::Error::ERR_DEVICE_MISSING 4
.IX Item "Sys::Virt::Error::ERR_DEVICE_MISSING"
Libvirt fail to find the desired device.
.IP Sys::Virt::Error::ERR_INVALID_NWFILTER_BINDING 4
.IX Item "Sys::Virt::Error::ERR_INVALID_NWFILTER_BINDING"
Invalid nwfilter binding
.IP Sys::Virt::Error::ERR_NO_NWFILTER_BINDING 4
.IX Item "Sys::Virt::Error::ERR_NO_NWFILTER_BINDING"
No nwfilter binding
.IP Sys::Virt::Error::ERR_INVALID_DOMAIN_CHECKPOINT 4
.IX Item "Sys::Virt::Error::ERR_INVALID_DOMAIN_CHECKPOINT"
Invalid domain checkpoint
.IP Sys::Virt::Error::ERR_NO_DOMAIN_BACKUP 4
.IX Item "Sys::Virt::Error::ERR_NO_DOMAIN_BACKUP"
Domain checkpoint not found
.IP Sys::Virt::Error::ERR_NO_DOMAIN_CHECKPOINT 4
.IX Item "Sys::Virt::Error::ERR_NO_DOMAIN_CHECKPOINT"
Domain backup job id not found
.IP Sys::Virt::Error::ERR_NO_NETWORK_PORT 4
.IX Item "Sys::Virt::Error::ERR_NO_NETWORK_PORT"
No matching network port
.IP Sys::Virt::Error::ERR_INVALID_NETWORK_PORT 4
.IX Item "Sys::Virt::Error::ERR_INVALID_NETWORK_PORT"
Invalid network port object
.IP Sys::Virt::Error::ERR_NETWORK_PORT_EXIST 4
.IX Item "Sys::Virt::Error::ERR_NETWORK_PORT_EXIST"
Network port already exists
.IP Sys::Virt::Error::ERR_NO_HOSTNAME 4
.IX Item "Sys::Virt::Error::ERR_NO_HOSTNAME"
No domain hostname found
.IP Sys::Virt::Error::ERR_CHECKPOINT_INCONSISTENT 4
.IX Item "Sys::Virt::Error::ERR_CHECKPOINT_INCONSISTENT"
The checkpoint is inconsistent
.IP Sys::Virt::Error::ERR_MULTIPLE_DOMAINS 4
.IX Item "Sys::Virt::Error::ERR_MULTIPLE_DOMAINS"
More than one matching domain found
.IP Sys::Virt::Error::ERR_NO_NETWORK_METADATA 4
.IX Item "Sys::Virt::Error::ERR_NO_NETWORK_METADATA"
The requested metadata does not exist
.SH AUTHORS
.IX Header "AUTHORS"
Daniel P. Berrange <berrange@redhat.com>
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2006 Red Hat
Copyright (C) 2006\-2007 Daniel P. Berrange
.SH LICENSE
.IX Header "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.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Sys::Virt::Domain, Sys::Virt, \f(CW\*(C`http://libvirt.org\*(C'\fR