Sys::Virt::Error(3pm)

📦
version 12.4.0 · 12 versions
, in epel 10

💖 Sys::Virt::Error 💖

okay bestie, welcome to the Sys::Virt::Error(3pm) page from User Contributed Perl Documentation. This is the libvirt error-object page, and it is highkey useful whenever something goes sideways and you need the receipts. 🧾✨

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

So yeah — if your code catches an exception from this corner of the world, this is the class holding the details. main character energy, honestly. 💜

🛠️ METHODS 🛠️

  • $err->stringify — Convert the object into string format suitable for printing on a console to inform a user of the error. It's the "tell the human what happened" pipeline. 💬
  • my $level = $err->level — Return the raw error level represented by this error. One of the ERROR LEVEL CONSTANTS. Check the list below, bestie. 👇
  • my $code = $err->code — Return the raw error code represented by this error. One of the ERROR CODE CONSTANTS. Yep, there's a whole menu of them. 🍓
  • my $from = $err->domain — Return the error domain raising this error. One of the ERROR DOMAIN CONSTANTS. It's the error's origin story. 🗺️
  • my $msg = $err->message — Return an informative message describing the error condition. The actual "what went wrong" text. 🫶

🌈 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. Basically, it tells you which little department sent the SOS. 🚨

  • 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. So you can catch the specific little gremlin instead of just "oops." 🐛✨

  • Sys::Virt::Error::ERR_AUTH_FAILED — Authentication failure 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 — heads up bestie, no node device driver is activated 🫶
  • Sys::Virt::Error::WAR_NO_STORAGE — same vibe but for storage: no storage driver is activated
  • Sys::Virt::Error::ERR_INVALID_INTERFACE — that network interface object is invalid, not cute 💀
  • Sys::Virt::Error::ERR_NO_INTERFACE — literally no interface with the matching name / mac address
  • Sys::Virt::Error::ERR_OPERATION_INVALID — the requested operation is just not valid for the current object state, sorry babe
  • 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, pick one 😭
  • Sys::Virt::Error::ERR_BUILD_FIREWALL — the firewall could not be constructed, we tried
  • 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 at all
  • Sys::Virt::Error::ERR_INVALID_NWFILTER — the network filter object was invalid
  • Sys::Virt::Error::WAR_NO_SECRET — the 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 (yes, migration popped off but the config didn't save 😬)
  • 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, it's giving done ✅
  • 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, so like… be careful 🚨
  • 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, fair enough
  • 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, don't do it bestie
  • 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… hello?? 📞
  • 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, it's booked
  • Sys::Virt::Error::ERR_ACCESS_DENIED — not authorized to perform the operation, bestie you do not have the pass 💅
  • 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. lowkey iconic
  • 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. gone. vanished.
  • 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, now which one of y'all
  • Sys::Virt::Error::ERR_NO_NETWORK_METADATA — the requested metadata does not exist
  • Sys::Virt::Error::ERR_AGENT_COMMAND_TIMEOUT — guest agent didn't respond to a non-sync command within timeout
  • Sys::Virt::Error::ERR_AGENT_COMMAND_FAILED — guest agent responded with failure to a command
  • Sys::Virt::Error::ERR_INVALID_ENCR_KEY_SECRET — secret encryption key is invalid 🔑

🧚 AUTHORS

  • Daniel P. Berrange <berrange@redhat.com> — the main character who wrote all this, we stan 💖

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.

Like, go wild, remix it, redistribute it — just read the licenses, periodt.

👀 SEE ALSO

okay that's the whole page bestie, you're caught up ✨ go forth and catch those errors 🦋

That was Sys::Virt::Error(3pm) from the User Contributed Perl Documentation, perl v5.40.2, dated 2026-06-08 — a whole read, but you ate it 💅👑

📦 where this page comes from