<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <!-- This file is autogenerated from html/libvirt-virterror.html.in Do not edit this file. Changes will be lost. --> <!-- This page was generated at Sun Jun 30 20:35:18 UTC 2019. --> <head> <meta charset="UTF-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <link rel="stylesheet" type="text/css" href="../main.css"/> <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png"/> <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png"/> <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png"/> <link rel="manifest" href="/manifest.json"/> <meta name="theme-color" content="#ffffff"/> <title>libvirt: Module virterror from libvirt</title> <meta name="description" content="libvirt, virtualization, virtualization API"/> <script type="text/javascript" src="../js/main.js"> <!--// forces non-empty element--> </script> </head> <body onload="pageload()"> <div id="body"> <div id="content"> <h1>Module virterror from libvirt</h1> <p>Provides the interfaces of the libvirt library to handle errors raised while using the library. Copyright (C) 2006-2019 Red Hat, Inc. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library. If not, see <a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.</p> <h2>Table of Contents</h2> <h3> <a href="#types">Types</a> </h3> <pre class="api"><span class="keyword">typedef</span> <span class="type">struct _virError</span> <a href="#virError">virError</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virErrorDomain">virErrorDomain</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virErrorLevel">virErrorLevel</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virErrorNumber">virErrorNumber</a> <span class="keyword">typedef</span> <span class="type"><a href="libvirt-virterror.html#virError">virError</a> *</span> <a name="virErrorPtr">virErrorPtr</a> </pre> <h3> <a href="#functions">Functions</a> </h3> <pre class="api"><span class="type">int</span> <a href="#virConnCopyLastError">virConnCopyLastError</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <br/> <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> to) <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> <a href="#virConnGetLastError">virConnGetLastError</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn) <span class="type">void</span> <a href="#virConnResetLastError">virConnResetLastError</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn) <span class="type">void</span> <a href="#virConnSetErrorFunc">virConnSetErrorFunc</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <br/> <span class="type">void *</span> userData, <br/> <span class="type"><a href="libvirt-virterror.html#virErrorFunc">virErrorFunc</a></span> handler) <span class="type">int</span> <a href="#virCopyLastError">virCopyLastError</a> (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> to) <span class="type">void</span> <a href="#virDefaultErrorFunc">virDefaultErrorFunc</a> (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> err) <span class="keyword">typedef</span> <a href="#virErrorFunc">virErrorFunc</a> <span class="type">void</span> <a href="#virErrorFunc">virErrorFunc</a> (<span class="type">void *</span> userData, <br/> <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> error) <span class="type">void</span> <a href="#virFreeError">virFreeError</a> (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> err) <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> <a href="#virGetLastError">virGetLastError</a> (<span class="type">void</span>) <span class="type">int</span> <a href="#virGetLastErrorCode">virGetLastErrorCode</a> (<span class="type">void</span>) <span class="type">int</span> <a href="#virGetLastErrorDomain">virGetLastErrorDomain</a> (<span class="type">void</span>) <span class="type">const char *</span> <a href="#virGetLastErrorMessage">virGetLastErrorMessage</a> (<span class="type">void</span>) <span class="type">void</span> <a href="#virResetError">virResetError</a> (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> err) <span class="type">void</span> <a href="#virResetLastError">virResetLastError</a> (<span class="type">void</span>) <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> <a href="#virSaveLastError">virSaveLastError</a> (<span class="type">void</span>) <span class="type">void</span> <a href="#virSetErrorFunc">virSetErrorFunc</a> (<span class="type">void *</span> userData, <br/> <span class="type"><a href="libvirt-virterror.html#virErrorFunc">virErrorFunc</a></span> handler) </pre> <h2>Description</h2> <h3> <a name="types">Types</a> </h3> <h3> <a name="virError"> <code>virError</code> </a> </h3> <div class="api"> <pre><span class="keyword">struct </span>virError { </pre> <table> <tr> <td> <span class="type">int</span> </td> <td>code</td> <td> <div class="comment">The error code, a <a href="libvirt-virterror.html#virErrorNumber">virErrorNumber</a></div> </td> </tr> <tr> <td> <span class="type">int</span> </td> <td>domain</td> <td> <div class="comment">What part of the library raised this error</div> </td> </tr> <tr> <td> <span class="type">char *</span> </td> <td>message</td> <td> <div class="comment">human-readable informative error message</div> </td> </tr> <tr> <td> <span class="type"> <a href="libvirt-virterror.html#virErrorLevel">virErrorLevel</a> </span> </td> <td>level</td> <td> <div class="comment">how consequent is the error</div> </td> </tr> <tr> <td> <span class="type"> <a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a> </span> </td> <td>conn</td> <td> <div class="comment">connection if available, deprecated see note above</div> </td> </tr> <tr> <td> <span class="type"> <a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a> </span> </td> <td>dom</td> <td> <div class="comment">domain if available, deprecated see note above</div> </td> </tr> <tr> <td> <span class="type">char *</span> </td> <td>str1</td> <td> <div class="comment">extra string information</div> </td> </tr> <tr> <td> <span class="type">char *</span> </td> <td>str2</td> <td> <div class="comment">extra string information</div> </td> </tr> <tr> <td> <span class="type">char *</span> </td> <td>str3</td> <td> <div class="comment">extra string information</div> </td> </tr> <tr> <td> <span class="type">int</span> </td> <td>int1</td> <td> <div class="comment">extra number information</div> </td> </tr> <tr> <td> <span class="type">int</span> </td> <td>int2</td> <td> <div class="comment">extra number information</div> </td> </tr> <tr> <td> <span class="type"> <a href="libvirt-libvirt-network.html#virNetworkPtr">virNetworkPtr</a> </span> </td> <td>net</td> <td> <div class="comment">network if available, deprecated see note above</div> </td> </tr> </table> <pre> } </pre> </div> <h3> <a name="virErrorDomain"> <code>virErrorDomain</code> </a> </h3> <div class="api"> <pre><span class="keyword">enum</span> virErrorDomain { </pre> <table> <tr> <td> <a name="VIR_FROM_NONE">VIR_FROM_NONE</a> </td> <td> = </td> <td colspan="2" class="enumvalue">0 (0x0)</td> </tr> <tr> <td> <a name="VIR_FROM_XEN">VIR_FROM_XEN</a> </td> <td> = </td> <td class="enumvalue">1 (0x1)</td> <td> <div class="comment">Error at Xen hypervisor layer</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XEND">VIR_FROM_XEND</a> </td> <td> = </td> <td class="enumvalue">2 (0x2)</td> <td> <div class="comment">Error at connection with xend daemon</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XENSTORE">VIR_FROM_XENSTORE</a> </td> <td> = </td> <td class="enumvalue">3 (0x3)</td> <td> <div class="comment">Error at connection with xen store</div> </td> </tr> <tr> <td> <a name="VIR_FROM_SEXPR">VIR_FROM_SEXPR</a> </td> <td> = </td> <td class="enumvalue">4 (0x4)</td> <td> <div class="comment">Error in the S-Expression code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XML">VIR_FROM_XML</a> </td> <td> = </td> <td class="enumvalue">5 (0x5)</td> <td> <div class="comment">Error in the XML code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_DOM">VIR_FROM_DOM</a> </td> <td> = </td> <td class="enumvalue">6 (0x6)</td> <td> <div class="comment">Error when operating on a domain</div> </td> </tr> <tr> <td> <a name="VIR_FROM_RPC">VIR_FROM_RPC</a> </td> <td> = </td> <td class="enumvalue">7 (0x7)</td> <td> <div class="comment">Error in the XML-RPC code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_PROXY">VIR_FROM_PROXY</a> </td> <td> = </td> <td class="enumvalue">8 (0x8)</td> <td> <div class="comment">Error in the proxy code; unused since 0.8.6</div> </td> </tr> <tr> <td> <a name="VIR_FROM_CONF">VIR_FROM_CONF</a> </td> <td> = </td> <td class="enumvalue">9 (0x9)</td> <td> <div class="comment">Error in the configuration file handling</div> </td> </tr> <tr> <td> <a name="VIR_FROM_QEMU">VIR_FROM_QEMU</a> </td> <td> = </td> <td class="enumvalue">10 (0xa)</td> <td> <div class="comment">Error at the QEMU daemon</div> </td> </tr> <tr> <td> <a name="VIR_FROM_NET">VIR_FROM_NET</a> </td> <td> = </td> <td class="enumvalue">11 (0xb)</td> <td> <div class="comment">Error when operating on a network</div> </td> </tr> <tr> <td> <a name="VIR_FROM_TEST">VIR_FROM_TEST</a> </td> <td> = </td> <td class="enumvalue">12 (0xc)</td> <td> <div class="comment">Error from test driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_REMOTE">VIR_FROM_REMOTE</a> </td> <td> = </td> <td class="enumvalue">13 (0xd)</td> <td> <div class="comment">Error from remote driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_OPENVZ">VIR_FROM_OPENVZ</a> </td> <td> = </td> <td class="enumvalue">14 (0xe)</td> <td> <div class="comment">Error from OpenVZ driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XENXM">VIR_FROM_XENXM</a> </td> <td> = </td> <td class="enumvalue">15 (0xf)</td> <td> <div class="comment">Error at Xen XM layer</div> </td> </tr> <tr> <td> <a name="VIR_FROM_STATS_LINUX">VIR_FROM_STATS_LINUX</a> </td> <td> = </td> <td class="enumvalue">16 (0x10)</td> <td> <div class="comment">Error in the Linux Stats code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_LXC">VIR_FROM_LXC</a> </td> <td> = </td> <td class="enumvalue">17 (0x11)</td> <td> <div class="comment">Error from Linux Container driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_STORAGE">VIR_FROM_STORAGE</a> </td> <td> = </td> <td class="enumvalue">18 (0x12)</td> <td> <div class="comment">Error from storage driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_NETWORK">VIR_FROM_NETWORK</a> </td> <td> = </td> <td class="enumvalue">19 (0x13)</td> <td> <div class="comment">Error from network config</div> </td> </tr> <tr> <td> <a name="VIR_FROM_DOMAIN">VIR_FROM_DOMAIN</a> </td> <td> = </td> <td class="enumvalue">20 (0x14)</td> <td> <div class="comment">Error from domain config</div> </td> </tr> <tr> <td> <a name="VIR_FROM_UML">VIR_FROM_UML</a> </td> <td> = </td> <td class="enumvalue">21 (0x15)</td> <td> <div class="comment">Error at the UML driver; unused since 5.0.0</div> </td> </tr> <tr> <td> <a name="VIR_FROM_NODEDEV">VIR_FROM_NODEDEV</a> </td> <td> = </td> <td class="enumvalue">22 (0x16)</td> <td> <div class="comment">Error from node device monitor</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XEN_INOTIFY">VIR_FROM_XEN_INOTIFY</a> </td> <td> = </td> <td class="enumvalue">23 (0x17)</td> <td> <div class="comment">Error from xen inotify layer</div> </td> </tr> <tr> <td> <a name="VIR_FROM_SECURITY">VIR_FROM_SECURITY</a> </td> <td> = </td> <td class="enumvalue">24 (0x18)</td> <td> <div class="comment">Error from security framework</div> </td> </tr> <tr> <td> <a name="VIR_FROM_VBOX">VIR_FROM_VBOX</a> </td> <td> = </td> <td class="enumvalue">25 (0x19)</td> <td> <div class="comment">Error from VirtualBox driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_INTERFACE">VIR_FROM_INTERFACE</a> </td> <td> = </td> <td class="enumvalue">26 (0x1a)</td> <td> <div class="comment">Error when operating on an interface</div> </td> </tr> <tr> <td> <a name="VIR_FROM_ONE">VIR_FROM_ONE</a> </td> <td> = </td> <td class="enumvalue">27 (0x1b)</td> <td> <div class="comment">The OpenNebula driver no longer exists. Retained for ABI/API compat only</div> </td> </tr> <tr> <td> <a name="VIR_FROM_ESX">VIR_FROM_ESX</a> </td> <td> = </td> <td class="enumvalue">28 (0x1c)</td> <td> <div class="comment">Error from ESX driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_PHYP">VIR_FROM_PHYP</a> </td> <td> = </td> <td class="enumvalue">29 (0x1d)</td> <td> <div class="comment">Error from IBM power hypervisor</div> </td> </tr> <tr> <td> <a name="VIR_FROM_SECRET">VIR_FROM_SECRET</a> </td> <td> = </td> <td class="enumvalue">30 (0x1e)</td> <td> <div class="comment">Error from secret storage</div> </td> </tr> <tr> <td> <a name="VIR_FROM_CPU">VIR_FROM_CPU</a> </td> <td> = </td> <td class="enumvalue">31 (0x1f)</td> <td> <div class="comment">Error from CPU driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XENAPI">VIR_FROM_XENAPI</a> </td> <td> = </td> <td class="enumvalue">32 (0x20)</td> <td> <div class="comment">Error from XenAPI</div> </td> </tr> <tr> <td> <a name="VIR_FROM_NWFILTER">VIR_FROM_NWFILTER</a> </td> <td> = </td> <td class="enumvalue">33 (0x21)</td> <td> <div class="comment">Error from network filter driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_HOOK">VIR_FROM_HOOK</a> </td> <td> = </td> <td class="enumvalue">34 (0x22)</td> <td> <div class="comment">Error from Synchronous hooks</div> </td> </tr> <tr> <td> <a name="VIR_FROM_DOMAIN_SNAPSHOT">VIR_FROM_DOMAIN_SNAPSHOT</a> </td> <td> = </td> <td class="enumvalue">35 (0x23)</td> <td> <div class="comment">Error from domain snapshot</div> </td> </tr> <tr> <td> <a name="VIR_FROM_AUDIT">VIR_FROM_AUDIT</a> </td> <td> = </td> <td class="enumvalue">36 (0x24)</td> <td> <div class="comment">Error from auditing subsystem</div> </td> </tr> <tr> <td> <a name="VIR_FROM_SYSINFO">VIR_FROM_SYSINFO</a> </td> <td> = </td> <td class="enumvalue">37 (0x25)</td> <td> <div class="comment">Error from sysinfo/SMBIOS</div> </td> </tr> <tr> <td> <a name="VIR_FROM_STREAMS">VIR_FROM_STREAMS</a> </td> <td> = </td> <td class="enumvalue">38 (0x26)</td> <td> <div class="comment">Error from I/O streams</div> </td> </tr> <tr> <td> <a name="VIR_FROM_VMWARE">VIR_FROM_VMWARE</a> </td> <td> = </td> <td class="enumvalue">39 (0x27)</td> <td> <div class="comment">Error from VMware driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_EVENT">VIR_FROM_EVENT</a> </td> <td> = </td> <td class="enumvalue">40 (0x28)</td> <td> <div class="comment">Error from event loop impl</div> </td> </tr> <tr> <td> <a name="VIR_FROM_LIBXL">VIR_FROM_LIBXL</a> </td> <td> = </td> <td class="enumvalue">41 (0x29)</td> <td> <div class="comment">Error from libxenlight driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_LOCKING">VIR_FROM_LOCKING</a> </td> <td> = </td> <td class="enumvalue">42 (0x2a)</td> <td> <div class="comment">Error from lock manager</div> </td> </tr> <tr> <td> <a name="VIR_FROM_HYPERV">VIR_FROM_HYPERV</a> </td> <td> = </td> <td class="enumvalue">43 (0x2b)</td> <td> <div class="comment">Error from Hyper-V driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_CAPABILITIES">VIR_FROM_CAPABILITIES</a> </td> <td> = </td> <td class="enumvalue">44 (0x2c)</td> <td> <div class="comment">Error from capabilities</div> </td> </tr> <tr> <td> <a name="VIR_FROM_URI">VIR_FROM_URI</a> </td> <td> = </td> <td class="enumvalue">45 (0x2d)</td> <td> <div class="comment">Error from URI handling</div> </td> </tr> <tr> <td> <a name="VIR_FROM_AUTH">VIR_FROM_AUTH</a> </td> <td> = </td> <td class="enumvalue">46 (0x2e)</td> <td> <div class="comment">Error from auth handling</div> </td> </tr> <tr> <td> <a name="VIR_FROM_DBUS">VIR_FROM_DBUS</a> </td> <td> = </td> <td class="enumvalue">47 (0x2f)</td> <td> <div class="comment">Error from DBus</div> </td> </tr> <tr> <td> <a name="VIR_FROM_PARALLELS">VIR_FROM_PARALLELS</a> </td> <td> = </td> <td class="enumvalue">48 (0x30)</td> <td> <div class="comment">Error from Parallels</div> </td> </tr> <tr> <td> <a name="VIR_FROM_DEVICE">VIR_FROM_DEVICE</a> </td> <td> = </td> <td class="enumvalue">49 (0x31)</td> <td> <div class="comment">Error from Device</div> </td> </tr> <tr> <td> <a name="VIR_FROM_SSH">VIR_FROM_SSH</a> </td> <td> = </td> <td class="enumvalue">50 (0x32)</td> <td> <div class="comment">Error from libssh2 connection transport</div> </td> </tr> <tr> <td> <a name="VIR_FROM_LOCKSPACE">VIR_FROM_LOCKSPACE</a> </td> <td> = </td> <td class="enumvalue">51 (0x33)</td> <td> <div class="comment">Error from lockspace</div> </td> </tr> <tr> <td> <a name="VIR_FROM_INITCTL">VIR_FROM_INITCTL</a> </td> <td> = </td> <td class="enumvalue">52 (0x34)</td> <td> <div class="comment">Error from initctl device communication</div> </td> </tr> <tr> <td> <a name="VIR_FROM_IDENTITY">VIR_FROM_IDENTITY</a> </td> <td> = </td> <td class="enumvalue">53 (0x35)</td> <td> <div class="comment">Error from identity code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_CGROUP">VIR_FROM_CGROUP</a> </td> <td> = </td> <td class="enumvalue">54 (0x36)</td> <td> <div class="comment">Error from cgroups</div> </td> </tr> <tr> <td> <a name="VIR_FROM_ACCESS">VIR_FROM_ACCESS</a> </td> <td> = </td> <td class="enumvalue">55 (0x37)</td> <td> <div class="comment">Error from access control manager</div> </td> </tr> <tr> <td> <a name="VIR_FROM_SYSTEMD">VIR_FROM_SYSTEMD</a> </td> <td> = </td> <td class="enumvalue">56 (0x38)</td> <td> <div class="comment">Error from systemd code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_BHYVE">VIR_FROM_BHYVE</a> </td> <td> = </td> <td class="enumvalue">57 (0x39)</td> <td> <div class="comment">Error from bhyve driver</div> </td> </tr> <tr> <td> <a name="VIR_FROM_CRYPTO">VIR_FROM_CRYPTO</a> </td> <td> = </td> <td class="enumvalue">58 (0x3a)</td> <td> <div class="comment">Error from crypto code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_FIREWALL">VIR_FROM_FIREWALL</a> </td> <td> = </td> <td class="enumvalue">59 (0x3b)</td> <td> <div class="comment">Error from firewall</div> </td> </tr> <tr> <td> <a name="VIR_FROM_POLKIT">VIR_FROM_POLKIT</a> </td> <td> = </td> <td class="enumvalue">60 (0x3c)</td> <td> <div class="comment">Error from polkit code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_THREAD">VIR_FROM_THREAD</a> </td> <td> = </td> <td class="enumvalue">61 (0x3d)</td> <td> <div class="comment">Error from thread utils</div> </td> </tr> <tr> <td> <a name="VIR_FROM_ADMIN">VIR_FROM_ADMIN</a> </td> <td> = </td> <td class="enumvalue">62 (0x3e)</td> <td> <div class="comment">Error from admin backend</div> </td> </tr> <tr> <td> <a name="VIR_FROM_LOGGING">VIR_FROM_LOGGING</a> </td> <td> = </td> <td class="enumvalue">63 (0x3f)</td> <td> <div class="comment">Error from log manager</div> </td> </tr> <tr> <td> <a name="VIR_FROM_XENXL">VIR_FROM_XENXL</a> </td> <td> = </td> <td class="enumvalue">64 (0x40)</td> <td> <div class="comment">Error from Xen xl config code</div> </td> </tr> <tr> <td> <a name="VIR_FROM_PERF">VIR_FROM_PERF</a> </td> <td> = </td> <td class="enumvalue">65 (0x41)</td> <td> <div class="comment">Error from perf</div> </td> </tr> <tr> <td> <a name="VIR_FROM_LIBSSH">VIR_FROM_LIBSSH</a> </td> <td> = </td> <td class="enumvalue">66 (0x42)</td> <td> <div class="comment">Error from libssh connection transport</div> </td> </tr> <tr> <td> <a name="VIR_FROM_RESCTRL">VIR_FROM_RESCTRL</a> </td> <td> = </td> <td class="enumvalue">67 (0x43)</td> <td> <div class="comment">Error from resource control</div> </td> </tr> <tr> <td> <a name="VIR_FROM_FIREWALLD">VIR_FROM_FIREWALLD</a> </td> <td> = </td> <td class="enumvalue">68 (0x44)</td> <td> <div class="comment">Error from firewalld</div> </td> </tr> <tr> <td> <a name="VIR_FROM_DOMAIN_CHECKPOINT">VIR_FROM_DOMAIN_CHECKPOINT</a> </td> <td> = </td> <td class="enumvalue">69 (0x45)</td> <td> <div class="comment">Error from domain checkpoint</div> </td> </tr> <tr> <td> <a name="VIR_ERR_DOMAIN_LAST">VIR_ERR_DOMAIN_LAST</a> </td> <td> = </td> <td colspan="2" class="enumvalue">70 (0x46)</td> </tr> </table> <pre>} </pre> </div> <h3> <a name="virErrorLevel"> <code>virErrorLevel</code> </a> </h3> <div class="api"> <pre><span class="keyword">enum</span> virErrorLevel { </pre> <table> <tr> <td> <a name="VIR_ERR_NONE">VIR_ERR_NONE</a> </td> <td> = </td> <td colspan="2" class="enumvalue">0 (0x0)</td> </tr> <tr> <td> <a name="VIR_ERR_WARNING">VIR_ERR_WARNING</a> </td> <td> = </td> <td class="enumvalue">1 (0x1)</td> <td> <div class="comment">A simple warning</div> </td> </tr> <tr> <td> <a name="VIR_ERR_ERROR">VIR_ERR_ERROR</a> </td> <td> = </td> <td class="enumvalue">2 (0x2)</td> <td> <div class="comment">An error</div> </td> </tr> </table> <pre>} </pre> </div> <h3> <a name="virErrorNumber"> <code>virErrorNumber</code> </a> </h3> <div class="api"> <pre><span class="keyword">enum</span> virErrorNumber { </pre> <table> <tr> <td> <a name="VIR_ERR_OK">VIR_ERR_OK</a> </td> <td> = </td> <td colspan="2" class="enumvalue">0 (0x0)</td> </tr> <tr> <td> <a name="VIR_ERR_INTERNAL_ERROR">VIR_ERR_INTERNAL_ERROR</a> </td> <td> = </td> <td class="enumvalue">1 (0x1)</td> <td> <div class="comment">internal error</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_MEMORY">VIR_ERR_NO_MEMORY</a> </td> <td> = </td> <td class="enumvalue">2 (0x2)</td> <td> <div class="comment">memory allocation failure</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_SUPPORT">VIR_ERR_NO_SUPPORT</a> </td> <td> = </td> <td class="enumvalue">3 (0x3)</td> <td> <div class="comment">no support for this function</div> </td> </tr> <tr> <td> <a name="VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a> </td> <td> = </td> <td class="enumvalue">4 (0x4)</td> <td> <div class="comment">could not resolve hostname</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_CONNECT">VIR_ERR_NO_CONNECT</a> </td> <td> = </td> <td class="enumvalue">5 (0x5)</td> <td> <div class="comment">can't connect to hypervisor</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_CONN">VIR_ERR_INVALID_CONN</a> </td> <td> = </td> <td class="enumvalue">6 (0x6)</td> <td> <div class="comment">invalid connection object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_DOMAIN">VIR_ERR_INVALID_DOMAIN</a> </td> <td> = </td> <td class="enumvalue">7 (0x7)</td> <td> <div class="comment">invalid domain object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_ARG">VIR_ERR_INVALID_ARG</a> </td> <td> = </td> <td class="enumvalue">8 (0x8)</td> <td> <div class="comment">invalid function argument</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPERATION_FAILED">VIR_ERR_OPERATION_FAILED</a> </td> <td> = </td> <td class="enumvalue">9 (0x9)</td> <td> <div class="comment">a command to hypervisor failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_GET_FAILED">VIR_ERR_GET_FAILED</a> </td> <td> = </td> <td class="enumvalue">10 (0xa)</td> <td> <div class="comment">a HTTP GET command to failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a> </td> <td> = </td> <td class="enumvalue">11 (0xb)</td> <td> <div class="comment">a HTTP POST command to failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_HTTP_ERROR">VIR_ERR_HTTP_ERROR</a> </td> <td> = </td> <td class="enumvalue">12 (0xc)</td> <td> <div class="comment">unexpected HTTP error code</div> </td> </tr> <tr> <td> <a name="VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a> </td> <td> = </td> <td class="enumvalue">13 (0xd)</td> <td> <div class="comment">failure to serialize an S-Expr</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_XEN">VIR_ERR_NO_XEN</a> </td> <td> = </td> <td class="enumvalue">14 (0xe)</td> <td> <div class="comment">could not open Xen hypervisor control</div> </td> </tr> <tr> <td> <a name="VIR_ERR_XEN_CALL">VIR_ERR_XEN_CALL</a> </td> <td> = </td> <td class="enumvalue">15 (0xf)</td> <td> <div class="comment">failure doing an hypervisor call</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OS_TYPE">VIR_ERR_OS_TYPE</a> </td> <td> = </td> <td class="enumvalue">16 (0x10)</td> <td> <div class="comment">unknown OS type</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_KERNEL">VIR_ERR_NO_KERNEL</a> </td> <td> = </td> <td class="enumvalue">17 (0x11)</td> <td> <div class="comment">missing kernel information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_ROOT">VIR_ERR_NO_ROOT</a> </td> <td> = </td> <td class="enumvalue">18 (0x12)</td> <td> <div class="comment">missing root device information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_SOURCE">VIR_ERR_NO_SOURCE</a> </td> <td> = </td> <td class="enumvalue">19 (0x13)</td> <td> <div class="comment">missing source device information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_TARGET">VIR_ERR_NO_TARGET</a> </td> <td> = </td> <td class="enumvalue">20 (0x14)</td> <td> <div class="comment">missing target device information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_NAME">VIR_ERR_NO_NAME</a> </td> <td> = </td> <td class="enumvalue">21 (0x15)</td> <td> <div class="comment">missing domain name information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_OS">VIR_ERR_NO_OS</a> </td> <td> = </td> <td class="enumvalue">22 (0x16)</td> <td> <div class="comment">missing domain OS information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_DEVICE">VIR_ERR_NO_DEVICE</a> </td> <td> = </td> <td class="enumvalue">23 (0x17)</td> <td> <div class="comment">missing domain devices information</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_XENSTORE">VIR_ERR_NO_XENSTORE</a> </td> <td> = </td> <td class="enumvalue">24 (0x18)</td> <td> <div class="comment">could not open Xen Store control</div> </td> </tr> <tr> <td> <a name="VIR_ERR_DRIVER_FULL">VIR_ERR_DRIVER_FULL</a> </td> <td> = </td> <td class="enumvalue">25 (0x19)</td> <td> <div class="comment">too many drivers registered</div> </td> </tr> <tr> <td> <a name="VIR_ERR_CALL_FAILED">VIR_ERR_CALL_FAILED</a> </td> <td> = </td> <td class="enumvalue">26 (0x1a)</td> <td> <div class="comment">not supported by the drivers (DEPRECATED)</div> </td> </tr> <tr> <td> <a name="VIR_ERR_XML_ERROR">VIR_ERR_XML_ERROR</a> </td> <td> = </td> <td class="enumvalue">27 (0x1b)</td> <td> <div class="comment">an XML description is not well formed or broken</div> </td> </tr> <tr> <td> <a name="VIR_ERR_DOM_EXIST">VIR_ERR_DOM_EXIST</a> </td> <td> = </td> <td class="enumvalue">28 (0x1c)</td> <td> <div class="comment">the domain already exist</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPERATION_DENIED">VIR_ERR_OPERATION_DENIED</a> </td> <td> = </td> <td class="enumvalue">29 (0x1d)</td> <td> <div class="comment">operation forbidden on read-only connections</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPEN_FAILED">VIR_ERR_OPEN_FAILED</a> </td> <td> = </td> <td class="enumvalue">30 (0x1e)</td> <td> <div class="comment">failed to open a conf file</div> </td> </tr> <tr> <td> <a name="VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a> </td> <td> = </td> <td class="enumvalue">31 (0x1f)</td> <td> <div class="comment">failed to read a conf file</div> </td> </tr> <tr> <td> <a name="VIR_ERR_PARSE_FAILED">VIR_ERR_PARSE_FAILED</a> </td> <td> = </td> <td class="enumvalue">32 (0x20)</td> <td> <div class="comment">failed to parse a conf file</div> </td> </tr> <tr> <td> <a name="VIR_ERR_CONF_SYNTAX">VIR_ERR_CONF_SYNTAX</a> </td> <td> = </td> <td class="enumvalue">33 (0x21)</td> <td> <div class="comment">failed to parse the syntax of a conf file</div> </td> </tr> <tr> <td> <a name="VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a> </td> <td> = </td> <td class="enumvalue">34 (0x22)</td> <td> <div class="comment">failed to write a conf file</div> </td> </tr> <tr> <td> <a name="VIR_ERR_XML_DETAIL">VIR_ERR_XML_DETAIL</a> </td> <td> = </td> <td class="enumvalue">35 (0x23)</td> <td> <div class="comment">detail of an XML error</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_NETWORK">VIR_ERR_INVALID_NETWORK</a> </td> <td> = </td> <td class="enumvalue">36 (0x24)</td> <td> <div class="comment">invalid network object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NETWORK_EXIST">VIR_ERR_NETWORK_EXIST</a> </td> <td> = </td> <td class="enumvalue">37 (0x25)</td> <td> <div class="comment">the network already exist</div> </td> </tr> <tr> <td> <a name="VIR_ERR_SYSTEM_ERROR">VIR_ERR_SYSTEM_ERROR</a> </td> <td> = </td> <td class="enumvalue">38 (0x26)</td> <td> <div class="comment">general system call failure</div> </td> </tr> <tr> <td> <a name="VIR_ERR_RPC">VIR_ERR_RPC</a> </td> <td> = </td> <td class="enumvalue">39 (0x27)</td> <td> <div class="comment">some sort of RPC error</div> </td> </tr> <tr> <td> <a name="VIR_ERR_GNUTLS_ERROR">VIR_ERR_GNUTLS_ERROR</a> </td> <td> = </td> <td class="enumvalue">40 (0x28)</td> <td> <div class="comment">error from a GNUTLS call</div> </td> </tr> <tr> <td> <a name="VIR_WAR_NO_NETWORK">VIR_WAR_NO_NETWORK</a> </td> <td> = </td> <td class="enumvalue">41 (0x29)</td> <td> <div class="comment">failed to start network</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_DOMAIN">VIR_ERR_NO_DOMAIN</a> </td> <td> = </td> <td class="enumvalue">42 (0x2a)</td> <td> <div class="comment">domain not found or unexpectedly disappeared</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_NETWORK">VIR_ERR_NO_NETWORK</a> </td> <td> = </td> <td class="enumvalue">43 (0x2b)</td> <td> <div class="comment">network not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_MAC">VIR_ERR_INVALID_MAC</a> </td> <td> = </td> <td class="enumvalue">44 (0x2c)</td> <td> <div class="comment">invalid MAC address</div> </td> </tr> <tr> <td> <a name="VIR_ERR_AUTH_FAILED">VIR_ERR_AUTH_FAILED</a> </td> <td> = </td> <td class="enumvalue">45 (0x2d)</td> <td> <div class="comment">authentication failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_STORAGE_POOL">VIR_ERR_INVALID_STORAGE_POOL</a> </td> <td> = </td> <td class="enumvalue">46 (0x2e)</td> <td> <div class="comment">invalid storage pool object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_STORAGE_VOL">VIR_ERR_INVALID_STORAGE_VOL</a> </td> <td> = </td> <td class="enumvalue">47 (0x2f)</td> <td> <div class="comment">invalid storage vol object</div> </td> </tr> <tr> <td> <a name="VIR_WAR_NO_STORAGE">VIR_WAR_NO_STORAGE</a> </td> <td> = </td> <td class="enumvalue">48 (0x30)</td> <td> <div class="comment">failed to start storage</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_STORAGE_POOL">VIR_ERR_NO_STORAGE_POOL</a> </td> <td> = </td> <td class="enumvalue">49 (0x31)</td> <td> <div class="comment">storage pool not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_STORAGE_VOL">VIR_ERR_NO_STORAGE_VOL</a> </td> <td> = </td> <td class="enumvalue">50 (0x32)</td> <td> <div class="comment">storage volume not found</div> </td> </tr> <tr> <td> <a name="VIR_WAR_NO_NODE">VIR_WAR_NO_NODE</a> </td> <td> = </td> <td class="enumvalue">51 (0x33)</td> <td> <div class="comment">failed to start node driver</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_NODE_DEVICE">VIR_ERR_INVALID_NODE_DEVICE</a> </td> <td> = </td> <td class="enumvalue">52 (0x34)</td> <td> <div class="comment">invalid node device object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_NODE_DEVICE">VIR_ERR_NO_NODE_DEVICE</a> </td> <td> = </td> <td class="enumvalue">53 (0x35)</td> <td> <div class="comment">node device not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_SECURITY_MODEL">VIR_ERR_NO_SECURITY_MODEL</a> </td> <td> = </td> <td class="enumvalue">54 (0x36)</td> <td> <div class="comment">security model not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPERATION_INVALID">VIR_ERR_OPERATION_INVALID</a> </td> <td> = </td> <td class="enumvalue">55 (0x37)</td> <td> <div class="comment">operation is not applicable at this time</div> </td> </tr> <tr> <td> <a name="VIR_WAR_NO_INTERFACE">VIR_WAR_NO_INTERFACE</a> </td> <td> = </td> <td class="enumvalue">56 (0x38)</td> <td> <div class="comment">failed to start interface driver</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_INTERFACE">VIR_ERR_NO_INTERFACE</a> </td> <td> = </td> <td class="enumvalue">57 (0x39)</td> <td> <div class="comment">interface driver not running</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_INTERFACE">VIR_ERR_INVALID_INTERFACE</a> </td> <td> = </td> <td class="enumvalue">58 (0x3a)</td> <td> <div class="comment">invalid interface object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_MULTIPLE_INTERFACES">VIR_ERR_MULTIPLE_INTERFACES</a> </td> <td> = </td> <td class="enumvalue">59 (0x3b)</td> <td> <div class="comment">more than one matching interface found</div> </td> </tr> <tr> <td> <a name="VIR_WAR_NO_NWFILTER">VIR_WAR_NO_NWFILTER</a> </td> <td> = </td> <td class="enumvalue">60 (0x3c)</td> <td> <div class="comment">failed to start nwfilter driver</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_NWFILTER">VIR_ERR_INVALID_NWFILTER</a> </td> <td> = </td> <td class="enumvalue">61 (0x3d)</td> <td> <div class="comment">invalid nwfilter object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_NWFILTER">VIR_ERR_NO_NWFILTER</a> </td> <td> = </td> <td class="enumvalue">62 (0x3e)</td> <td> <div class="comment">nw filter pool not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_BUILD_FIREWALL">VIR_ERR_BUILD_FIREWALL</a> </td> <td> = </td> <td class="enumvalue">63 (0x3f)</td> <td> <div class="comment">nw filter pool not found</div> </td> </tr> <tr> <td> <a name="VIR_WAR_NO_SECRET">VIR_WAR_NO_SECRET</a> </td> <td> = </td> <td class="enumvalue">64 (0x40)</td> <td> <div class="comment">failed to start secret storage</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_SECRET">VIR_ERR_INVALID_SECRET</a> </td> <td> = </td> <td class="enumvalue">65 (0x41)</td> <td> <div class="comment">invalid secret</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_SECRET">VIR_ERR_NO_SECRET</a> </td> <td> = </td> <td class="enumvalue">66 (0x42)</td> <td> <div class="comment">secret not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_CONFIG_UNSUPPORTED">VIR_ERR_CONFIG_UNSUPPORTED</a> </td> <td> = </td> <td class="enumvalue">67 (0x43)</td> <td> <div class="comment">unsupported configuration construct</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPERATION_TIMEOUT">VIR_ERR_OPERATION_TIMEOUT</a> </td> <td> = </td> <td class="enumvalue">68 (0x44)</td> <td> <div class="comment">timeout occurred during operation</div> </td> </tr> <tr> <td> <a name="VIR_ERR_MIGRATE_PERSIST_FAILED">VIR_ERR_MIGRATE_PERSIST_FAILED</a> </td> <td> = </td> <td class="enumvalue">69 (0x45)</td> <td> <div class="comment">a migration worked, but making the VM persist on the dest host failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_HOOK_SCRIPT_FAILED">VIR_ERR_HOOK_SCRIPT_FAILED</a> </td> <td> = </td> <td class="enumvalue">70 (0x46)</td> <td> <div class="comment">a synchronous hook script failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_DOMAIN_SNAPSHOT">VIR_ERR_INVALID_DOMAIN_SNAPSHOT</a> </td> <td> = </td> <td class="enumvalue">71 (0x47)</td> <td> <div class="comment">invalid domain snapshot</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_DOMAIN_SNAPSHOT">VIR_ERR_NO_DOMAIN_SNAPSHOT</a> </td> <td> = </td> <td class="enumvalue">72 (0x48)</td> <td> <div class="comment">domain snapshot not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_STREAM">VIR_ERR_INVALID_STREAM</a> </td> <td> = </td> <td class="enumvalue">73 (0x49)</td> <td> <div class="comment">stream pointer not valid</div> </td> </tr> <tr> <td> <a name="VIR_ERR_ARGUMENT_UNSUPPORTED">VIR_ERR_ARGUMENT_UNSUPPORTED</a> </td> <td> = </td> <td class="enumvalue">74 (0x4a)</td> <td> <div class="comment">valid API use but unsupported by the given driver</div> </td> </tr> <tr> <td> <a name="VIR_ERR_STORAGE_PROBE_FAILED">VIR_ERR_STORAGE_PROBE_FAILED</a> </td> <td> = </td> <td class="enumvalue">75 (0x4b)</td> <td> <div class="comment">storage pool probe failed</div> </td> </tr> <tr> <td> <a name="VIR_ERR_STORAGE_POOL_BUILT">VIR_ERR_STORAGE_POOL_BUILT</a> </td> <td> = </td> <td class="enumvalue">76 (0x4c)</td> <td> <div class="comment">storage pool already built</div> </td> </tr> <tr> <td> <a name="VIR_ERR_SNAPSHOT_REVERT_RISKY">VIR_ERR_SNAPSHOT_REVERT_RISKY</a> </td> <td> = </td> <td class="enumvalue">77 (0x4d)</td> <td> <div class="comment">force was not requested for a risky domain snapshot revert</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPERATION_ABORTED">VIR_ERR_OPERATION_ABORTED</a> </td> <td> = </td> <td class="enumvalue">78 (0x4e)</td> <td> <div class="comment">operation on a domain was canceled/aborted by user</div> </td> </tr> <tr> <td> <a name="VIR_ERR_AUTH_CANCELLED">VIR_ERR_AUTH_CANCELLED</a> </td> <td> = </td> <td class="enumvalue">79 (0x4f)</td> <td> <div class="comment">authentication cancelled</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_DOMAIN_METADATA">VIR_ERR_NO_DOMAIN_METADATA</a> </td> <td> = </td> <td class="enumvalue">80 (0x50)</td> <td> <div class="comment">The metadata is not present</div> </td> </tr> <tr> <td> <a name="VIR_ERR_MIGRATE_UNSAFE">VIR_ERR_MIGRATE_UNSAFE</a> </td> <td> = </td> <td class="enumvalue">81 (0x51)</td> <td> <div class="comment">Migration is not safe</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OVERFLOW">VIR_ERR_OVERFLOW</a> </td> <td> = </td> <td class="enumvalue">82 (0x52)</td> <td> <div class="comment">integer overflow</div> </td> </tr> <tr> <td> <a name="VIR_ERR_BLOCK_COPY_ACTIVE">VIR_ERR_BLOCK_COPY_ACTIVE</a> </td> <td> = </td> <td class="enumvalue">83 (0x53)</td> <td> <div class="comment">action prevented by block copy job</div> </td> </tr> <tr> <td> <a name="VIR_ERR_OPERATION_UNSUPPORTED">VIR_ERR_OPERATION_UNSUPPORTED</a> </td> <td> = </td> <td class="enumvalue">84 (0x54)</td> <td> <div class="comment">The requested operation is not supported</div> </td> </tr> <tr> <td> <a name="VIR_ERR_SSH">VIR_ERR_SSH</a> </td> <td> = </td> <td class="enumvalue">85 (0x55)</td> <td> <div class="comment">error in ssh transport driver</div> </td> </tr> <tr> <td> <a name="VIR_ERR_AGENT_UNRESPONSIVE">VIR_ERR_AGENT_UNRESPONSIVE</a> </td> <td> = </td> <td class="enumvalue">86 (0x56)</td> <td> <div class="comment">guest agent is unresponsive, not running or not usable</div> </td> </tr> <tr> <td> <a name="VIR_ERR_RESOURCE_BUSY">VIR_ERR_RESOURCE_BUSY</a> </td> <td> = </td> <td class="enumvalue">87 (0x57)</td> <td> <div class="comment">resource is already in use</div> </td> </tr> <tr> <td> <a name="VIR_ERR_ACCESS_DENIED">VIR_ERR_ACCESS_DENIED</a> </td> <td> = </td> <td class="enumvalue">88 (0x58)</td> <td> <div class="comment">operation on the object/resource was denied</div> </td> </tr> <tr> <td> <a name="VIR_ERR_DBUS_SERVICE">VIR_ERR_DBUS_SERVICE</a> </td> <td> = </td> <td class="enumvalue">89 (0x59)</td> <td> <div class="comment">error from a dbus service</div> </td> </tr> <tr> <td> <a name="VIR_ERR_STORAGE_VOL_EXIST">VIR_ERR_STORAGE_VOL_EXIST</a> </td> <td> = </td> <td class="enumvalue">90 (0x5a)</td> <td> <div class="comment">the storage vol already exists</div> </td> </tr> <tr> <td> <a name="VIR_ERR_CPU_INCOMPATIBLE">VIR_ERR_CPU_INCOMPATIBLE</a> </td> <td> = </td> <td class="enumvalue">91 (0x5b)</td> <td> <div class="comment">given CPU is incompatible with host CP</div> </td> </tr> <tr> <td> <a name="VIR_ERR_XML_INVALID_SCHEMA">VIR_ERR_XML_INVALID_SCHEMA</a> </td> <td> = </td> <td class="enumvalue">92 (0x5c)</td> <td> <div class="comment">XML document doesn't validate against schema</div> </td> </tr> <tr> <td> <a name="VIR_ERR_MIGRATE_FINISH_OK">VIR_ERR_MIGRATE_FINISH_OK</a> </td> <td> = </td> <td class="enumvalue">93 (0x5d)</td> <td> <div class="comment">Finish API succeeded but it is expected to return NULL</div> </td> </tr> <tr> <td> <a name="VIR_ERR_AUTH_UNAVAILABLE">VIR_ERR_AUTH_UNAVAILABLE</a> </td> <td> = </td> <td class="enumvalue">94 (0x5e)</td> <td> <div class="comment">authentication unavailable</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_SERVER">VIR_ERR_NO_SERVER</a> </td> <td> = </td> <td class="enumvalue">95 (0x5f)</td> <td> <div class="comment">Server was not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_CLIENT">VIR_ERR_NO_CLIENT</a> </td> <td> = </td> <td class="enumvalue">96 (0x60)</td> <td> <div class="comment">Client was not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_AGENT_UNSYNCED">VIR_ERR_AGENT_UNSYNCED</a> </td> <td> = </td> <td class="enumvalue">97 (0x61)</td> <td> <div class="comment">guest agent replies with wrong id to guest-sync command (DEPRECATED</div> </td> </tr> <tr> <td> <a name="VIR_ERR_LIBSSH">VIR_ERR_LIBSSH</a> </td> <td> = </td> <td class="enumvalue">98 (0x62)</td> <td> <div class="comment">error in libssh transport driver</div> </td> </tr> <tr> <td> <a name="VIR_ERR_DEVICE_MISSING">VIR_ERR_DEVICE_MISSING</a> </td> <td> = </td> <td class="enumvalue">99 (0x63)</td> <td> <div class="comment">fail to find the desired device</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_NWFILTER_BINDING">VIR_ERR_INVALID_NWFILTER_BINDING</a> </td> <td> = </td> <td class="enumvalue">100 (0x64)</td> <td> <div class="comment">invalid nwfilter binding</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_NWFILTER_BINDING">VIR_ERR_NO_NWFILTER_BINDING</a> </td> <td> = </td> <td class="enumvalue">101 (0x65)</td> <td> <div class="comment">no nwfilter binding</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_DOMAIN_CHECKPOINT">VIR_ERR_INVALID_DOMAIN_CHECKPOINT</a> </td> <td> = </td> <td class="enumvalue">102 (0x66)</td> <td> <div class="comment">invalid domain checkpoint</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_DOMAIN_CHECKPOINT">VIR_ERR_NO_DOMAIN_CHECKPOINT</a> </td> <td> = </td> <td class="enumvalue">103 (0x67)</td> <td> <div class="comment">domain checkpoint not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_DOMAIN_BACKUP">VIR_ERR_NO_DOMAIN_BACKUP</a> </td> <td> = </td> <td class="enumvalue">104 (0x68)</td> <td> <div class="comment">domain backup job id not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_INVALID_NETWORK_PORT">VIR_ERR_INVALID_NETWORK_PORT</a> </td> <td> = </td> <td class="enumvalue">105 (0x69)</td> <td> <div class="comment">invalid network port object</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NETWORK_PORT_EXIST">VIR_ERR_NETWORK_PORT_EXIST</a> </td> <td> = </td> <td class="enumvalue">106 (0x6a)</td> <td> <div class="comment">the network port already exist</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NO_NETWORK_PORT">VIR_ERR_NO_NETWORK_PORT</a> </td> <td> = </td> <td class="enumvalue">107 (0x6b)</td> <td> <div class="comment">network port not found</div> </td> </tr> <tr> <td> <a name="VIR_ERR_NUMBER_LAST">VIR_ERR_NUMBER_LAST</a> </td> <td> = </td> <td colspan="2" class="enumvalue">108 (0x6c)</td> </tr> </table> <pre>} </pre> </div> <h3> <a name="functions">Functions</a> </h3> <h3> <a name="virConnCopyLastError"> <code>virConnCopyLastError</code> </a> </h3> <pre class="api"><span class="type">int</span> virConnCopyLastError (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> to)</pre> <div class="description"> <p>Copy the content of the last error caught on that connection</p> <p>This method is not protected against access from multiple threads. In a multi-threaded application, always use the global <a href="libvirt-virterror.html#virGetLastError">virGetLastError</a>() API which is backed by thread local storage.</p> <p>If the connection object was discovered to be invalid by an API call, then the error will be reported against the global error object.</p> <p>Since 0.6.0, all errors reported in the per-connection object are also duplicated in the global error object. As such an application can always use <a href="libvirt-virterror.html#virGetLastError">virGetLastError</a>(). This method remains for backwards compatibility.</p> <p>One will need to free the result with <a href="libvirt-virterror.html#virResetError">virResetError</a>()</p> </div> <dl class="variablelist"> <dt>conn</dt> <dd>pointer to the hypervisor connection</dd> <dt>to</dt> <dd>target to receive the copy</dd> <dt>Returns</dt> <dd>0 if no error was found and the error code otherwise and -1 in case of parameter error.</dd> </dl> <div class="acl"/> <h3> <a name="virConnGetLastError"> <code>virConnGetLastError</code> </a> </h3> <pre class="api"><span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> virConnGetLastError (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn)</pre> <div class="description"> <p>Provide a pointer to the last error caught on that connection</p> <p>This method is not protected against access from multiple threads. In a multi-threaded application, always use the global <a href="libvirt-virterror.html#virGetLastError">virGetLastError</a>() API which is backed by thread local storage.</p> <p>If the connection object was discovered to be invalid by an API call, then the error will be reported against the global error object.</p> <p>Since 0.6.0, all errors reported in the per-connection object are also duplicated in the global error object. As such an application can always use <a href="libvirt-virterror.html#virGetLastError">virGetLastError</a>(). This method remains for backwards compatibility.</p> </div> <dl class="variablelist"> <dt>conn</dt> <dd>pointer to the hypervisor connection</dd> <dt>Returns</dt> <dd>a pointer to the last error or NULL if none occurred.</dd> </dl> <div class="acl"/> <h3> <a name="virConnResetLastError"> <code>virConnResetLastError</code> </a> </h3> <pre class="api"><span class="type">void</span> virConnResetLastError (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn)</pre> <div class="description"> <p>The error object is kept in thread local storage, so separate threads can safely access this concurrently.</p> <p>Reset the last error caught on that connection</p> </div> <dl class="variablelist"> <dt>conn</dt> <dd>pointer to the hypervisor connection</dd> </dl> <div class="acl"/> <h3> <a name="virConnSetErrorFunc"> <code>virConnSetErrorFunc</code> </a> </h3> <pre class="api"><span class="type">void</span> virConnSetErrorFunc (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <span class="type">void *</span> userData, <span class="type"><a href="libvirt-virterror.html#virErrorFunc">virErrorFunc</a></span> handler)</pre> <div class="description"> <p>Set a connection error handling function, if @handler is NULL it will reset to default which is to pass error back to the global library handler.</p> </div> <dl class="variablelist"> <dt>conn</dt> <dd>pointer to the hypervisor connection</dd> <dt>userData</dt> <dd>pointer to the user data provided in the handler callback</dd> <dt>handler</dt> <dd>the function to get called in case of error or NULL</dd> </dl> <div class="acl"/> <h3> <a name="virCopyLastError"> <code>virCopyLastError</code> </a> </h3> <pre class="api"><span class="type">int</span> virCopyLastError (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> to)</pre> <div class="description"> <p>Copy the content of the last error caught at the library level</p> <p>The error object is kept in thread local storage, so separate threads can safely access this concurrently.</p> <p>One will need to free the result with <a href="libvirt-virterror.html#virResetError">virResetError</a>()</p> </div> <dl class="variablelist"> <dt>to</dt> <dd>target to receive the copy</dd> <dt>Returns</dt> <dd>error code or -1 in case of parameter error.</dd> </dl> <div class="acl"/> <h3> <a name="virDefaultErrorFunc"> <code>virDefaultErrorFunc</code> </a> </h3> <pre class="api"><span class="type">void</span> virDefaultErrorFunc (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> err)</pre> <div class="description"> <p>Default routine reporting an error to stderr.</p> </div> <dl class="variablelist"> <dt>err</dt> <dd>pointer to the error.</dd> </dl> <div class="acl"/> <h3> <a name="virErrorFunc"> <code>virErrorFunc</code> </a> </h3> <pre class="api"><span class="keyword">typedef</span> <span class="type">void</span> (*virErrorFunc ) (<span class="type">void *</span> userData, <span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> error) </pre> <div class="description"> <p>Signature of a function to use when there is an error raised by the library.</p> </div> <dl class="variablelist"> <dt>userData</dt> <dd>user provided data for the error callback</dd> <dt>error</dt> <dd>the error being raised.</dd> </dl> <br/> <h3> <a name="virFreeError"> <code>virFreeError</code> </a> </h3> <pre class="api"><span class="type">void</span> virFreeError (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> err)</pre> <div class="description"> <p>Resets and frees the given error.</p> </div> <dl class="variablelist"> <dt>err</dt> <dd>error to free</dd> </dl> <div class="acl"/> <h3> <a name="virGetLastError"> <code>virGetLastError</code> </a> </h3> <pre class="api"><span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> virGetLastError (<span class="type">void</span>)</pre> <div class="description"> <p>Provide a pointer to the last error caught at the library level</p> <p>The error object is kept in thread local storage, so separate threads can safely access this concurrently.</p> </div> <dl class="variablelist"> <dt>Returns</dt> <dd>a pointer to the last error or NULL if none occurred.</dd> </dl> <div class="acl"/> <h3> <a name="virGetLastErrorCode"> <code>virGetLastErrorCode</code> </a> </h3> <pre class="api"><span class="type">int</span> virGetLastErrorCode (<span class="type">void</span>)</pre> <div class="description"> <p>Get the most recent error code (enum <a href="libvirt-virterror.html#virErrorNumber">virErrorNumber</a>).</p> </div> <dl class="variablelist"> <dt>Returns</dt> <dd>the most recent error code, or <a href="libvirt-virterror.html#VIR_ERR_OK">VIR_ERR_OK</a> if none is set.</dd> </dl> <div class="acl"/> <h3> <a name="virGetLastErrorDomain"> <code>virGetLastErrorDomain</code> </a> </h3> <pre class="api"><span class="type">int</span> virGetLastErrorDomain (<span class="type">void</span>)</pre> <div class="description"> <p>Get the most recent error domain (enum <a href="libvirt-virterror.html#virErrorDomain">virErrorDomain</a>).</p> </div> <dl class="variablelist"> <dt>Returns</dt> <dd>a numerical value of the most recent error's origin, or <a href="libvirt-virterror.html#VIR_FROM_NONE">VIR_FROM_NONE</a> if none is set.</dd> </dl> <div class="acl"/> <h3> <a name="virGetLastErrorMessage"> <code>virGetLastErrorMessage</code> </a> </h3> <pre class="api"><span class="type">const char *</span> virGetLastErrorMessage (<span class="type">void</span>)</pre> <div class="description"> <p>Get the most recent error message</p> </div> <dl class="variablelist"> <dt>Returns</dt> <dd>the most recent error message string in this thread, or a generic message if none is set</dd> </dl> <div class="acl"/> <h3> <a name="virResetError"> <code>virResetError</code> </a> </h3> <pre class="api"><span class="type">void</span> virResetError (<span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> err)</pre> <div class="description"> <p>Reset the error being pointed to</p> </div> <dl class="variablelist"> <dt>err</dt> <dd>pointer to the <a href="libvirt-virterror.html#virError">virError</a> to clean up</dd> </dl> <div class="acl"/> <h3> <a name="virResetLastError"> <code>virResetLastError</code> </a> </h3> <pre class="api"><span class="type">void</span> virResetLastError (<span class="type">void</span>)</pre> <div class="description"> <p>Reset the last error caught at the library level.</p> <p>The error object is kept in thread local storage, so separate threads can safely access this concurrently, only resetting their own error object.</p> </div> <div class="acl"/> <h3> <a name="virSaveLastError"> <code>virSaveLastError</code> </a> </h3> <pre class="api"><span class="type"><a href="libvirt-virterror.html#virErrorPtr">virErrorPtr</a></span> virSaveLastError (<span class="type">void</span>)</pre> <div class="description"> <p>Save the last error into a new error object. On success, errno is unchanged; on failure, errno is ENOMEM.</p> </div> <dl class="variablelist"> <dt>Returns</dt> <dd>a pointer to the copied error or NULL if allocation failed. It is the caller's responsibility to free the error with <a href="libvirt-virterror.html#virFreeError">virFreeError</a>().</dd> </dl> <div class="acl"/> <h3> <a name="virSetErrorFunc"> <code>virSetErrorFunc</code> </a> </h3> <pre class="api"><span class="type">void</span> virSetErrorFunc (<span class="type">void *</span> userData, <span class="type"><a href="libvirt-virterror.html#virErrorFunc">virErrorFunc</a></span> handler)</pre> <div class="description"> <p>Set a library global error handling function, if @handler is NULL, it will reset to default printing on stderr. The error raised there are those for which no handler at the connection level could caught.</p> </div> <dl class="variablelist"> <dt>userData</dt> <dd>pointer to the user data provided in the handler callback</dd> <dt>handler</dt> <dd>the function to get called in case of error or NULL</dd> </dl> <div class="acl"/> </div> </div> <div id="nav"> <div id="home"> <a href="../index.html">Home</a> </div> <div id="jumplinks"> <ul> <li> <a href="../downloads.html">Download</a> </li> <li> <a href="../contribute.html">Contribute</a> </li> <li> <a href="../docs.html">Docs</a> </li> </ul> </div> <div id="search"> <form id="simplesearch" action="https://www.google.com/search" enctype="application/x-www-form-urlencoded" method="get"> <div> <input id="searchsite" name="sitesearch" type="hidden" value="libvirt.org"/> <input id="searchq" name="q" type="text" size="12" value=""/> <input name="submit" type="submit" value="Go"/> </div> </form> <div id="advancedsearch"> <span> <input type="radio" name="what" id="whatwebsite" checked="checked" value="website"/> <label for="whatwebsite">Website</label> </span> <span> <input type="radio" name="what" id="whatwiki" value="wiki"/> <label for="whatwiki">Wiki</label> </span> <span> <input type="radio" name="what" id="whatdevs" value="devs"/> <label for="whatdevs">Developers list</label> </span> <span> <input type="radio" name="what" id="whatusers" value="users"/> <label for="whatusers">Users list</label> </span> </div> </div> </div> <div id="footer"> <div id="contact"> <h3>Contact</h3> <ul> <li> <a href="../contact.html#email">email</a> </li> <li> <a href="../contact.html#irc">irc</a> </li> </ul> </div> <div id="community"> <h3>Community</h3> <ul> <li> <a href="https://twitter.com/hashtag/libvirt">twitter</a> </li> <li> <a href="http://stackoverflow.com/questions/tagged/libvirt">stackoverflow</a> </li> <li> <a href="http://serverfault.com/questions/tagged/libvirt">serverfault</a> </li> </ul> </div> <div id="conduct"> Participants in the libvirt project agree to abide by <a href="../governance.html#codeofconduct">the project code of conduct</a></div> <br class="clear"/> </div> </body> </html>