Sys::Virt::Error(3pm) User Contributed Perl Documentation 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->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 Sys::Virt::Error::FROM_BHYVE The FreeBSD BHyve driver Sys::Virt::Error::FROM_CRYPTO The cryptographic helper APIs. Sys::Virt::Error::FROM_FIREWALL The firewall helper APIs. Sys::Virt::Error::FROM_POLKIT The polkit authentication / authorization APIs Sys::Virt::Error::FROM_THREAD The thread helper utils Sys::Virt::Error::FROM_ADMIN The administrative service Sys::Virt::Error::FROM_LOGGING The logging service Sys::Virt::Error::FROM_XENXL The Xen XL driver Sys::Virt::Error::FROM_PERF The performance events subsystem Sys::Virt::Error::FROM_LIBSSH The libSSH socket client Sys::Virt::Error::FROM_RESCTRL The resource control subsystem Sys::Virt::Error::FROM_FIREWALLD The firewalld service Sys::Virt::Error::FROM_DOMAIN_CHECKPOINT The domain checkpoint Sys::Virt::Error::FROM_TPM The TPM subsystem Sys::Virt::Error::FROM_BPF The BPF subsystem Sys::Virt::Error::FROM_CH The Cloud Hypervisor driver 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 configuration 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 firewall 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 Sys::Virt::Error::ERR_STORAGE_VOL_EXIST The storage volume already exists Sys::Virt::Error::ERR_CPU_INCOMPATIBLE The CPUs are not compatible Sys::Virt::Error::ERR_INVALID_SCHEMA The XML document does not comply with the XML schema Sys::Virt::Error::ERR_MIGRATE_FINISH_OK Migration finished but expected to return NULL domain. Sys::Virt::Error::ERR_AUTH_UNAVAILABLE Authentication services were not available Sys::Virt::Error::ERR_NO_SERVER Libvirt server was not found Sys::Virt::Error::ERR_NO_CLIENT Libvirt client was not found Sys::Virt::Error::ERR_AGENT_UNSYNCED Libvirt guest agent replies with wrong id to guest-sync command Sys::Virt::Error::ERR_LIBSSH The libSSH operation failed Sys::Virt::Error::ERR_DEVICE_MISSING Libvirt fail to find the desired device. Sys::Virt::Error::ERR_INVALID_NWFILTER_BINDING Invalid nwfilter binding Sys::Virt::Error::ERR_NO_NWFILTER_BINDING No nwfilter binding Sys::Virt::Error::ERR_INVALID_DOMAIN_CHECKPOINT Invalid domain checkpoint Sys::Virt::Error::ERR_NO_DOMAIN_BACKUP Domain checkpoint not found Sys::Virt::Error::ERR_NO_DOMAIN_CHECKPOINT Domain backup job id not found Sys::Virt::Error::ERR_NO_NETWORK_PORT No matching network port Sys::Virt::Error::ERR_INVALID_NETWORK_PORT Invalid network port object Sys::Virt::Error::ERR_NETWORK_PORT_EXIST Network port already exists Sys::Virt::Error::ERR_NO_HOSTNAME No domain hostname found Sys::Virt::Error::ERR_CHECKPOINT_INCONSISTENT The checkpoint is inconsistent Sys::Virt::Error::ERR_MULTIPLE_DOMAINS More than one matching domain found AUTHORS Daniel P. Berrange 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" perl v5.38.0 2023-07-26 Sys::Virt::Error(3pm)