Linux Certif

Toute la documentation sur la certification Linux LPI

Sys::Virt::Error.3pm

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->code

Return the raw error code represented by this error.

my $from = $err->domain

Return the error domain raising this error.

my $msg = $err->message

Return an informative message describing the error condition.

CONSTANTS

ERROR DOMAINS

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

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

ERROR CODES

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::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

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"