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 $level = $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 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

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

Sys::Virt::Error::ERR_NO_NETWORK_METADATA

The requested metadata does not exist

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