Sys::Virt::Error(3) | User Contributed Perl Documentation | Sys::Virt::Error(3) |
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 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
- 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 <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"
2023-10-06 | perl v5.26.3 |