Rechercher une page de manuel
Sys::Virt::Error.3pm
Langue: en
Version: 2010-05-19 (ubuntu - 24/10/10)
Section: 3 (Bibliothèques de fonctions)
NAME
Sys::Virt::Error - error object for libvirt APIsDESCRIPTION
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. BerrangeLICENSE
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"Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre