diff options
| author | Guido Günther <agx@sigxcpu.org> | 2015-01-24 22:56:35 +0100 |
|---|---|---|
| committer | Guido Günther <agx@sigxcpu.org> | 2015-01-24 22:56:35 +0100 |
| commit | 67f2b22d25cf9ad9cff386a686edc6959c4d1457 (patch) | |
| tree | fcfc6517cfed692601880dae8b82e03cc00abb82 /docs | |
| parent | 7b59a26ddabc57815755a8a80e646ac388d94b0c (diff) | |
New upstream version 1.2.12~rc2
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/devhelp/libvirt-virterror.html | 1 | ||||
| -rw-r--r-- | docs/devhelp/libvirt.devhelp | 6 | ||||
| -rw-r--r-- | docs/html/libvirt-libvirt-domain.html | 16 | ||||
| -rw-r--r-- | docs/html/libvirt-libvirt-host.html | 4 | ||||
| -rw-r--r-- | docs/html/libvirt-virterror.html | 2 | ||||
| -rw-r--r-- | docs/schemas/basictypes.rng | 6 | ||||
| -rw-r--r-- | docs/schemas/domaincommon.rng | 10 | ||||
| -rw-r--r-- | docs/schemas/nodedev.rng | 6 |
8 files changed, 37 insertions, 14 deletions
diff --git a/docs/devhelp/libvirt-virterror.html b/docs/devhelp/libvirt-virterror.html index 3be09fee4..bbab1a605 100644 --- a/docs/devhelp/libvirt-virterror.html +++ b/docs/devhelp/libvirt-virterror.html @@ -250,6 +250,7 @@ void <a href="#virSetErrorFunc">virSetErrorFunc</a> (void * userData, <br/> <a name="VIR_ERR_DBUS_SERVICE">VIR_ERR_DBUS_SERVICE</a> = 89 /* error from a dbus service */ <a name="VIR_ERR_STORAGE_VOL_EXIST">VIR_ERR_STORAGE_VOL_EXIST</a> = 90 /* the storage vol already exists */ <a name="VIR_ERR_CPU_INCOMPATIBLE">VIR_ERR_CPU_INCOMPATIBLE</a> = 91 /* given CPU is incompatible with host CP */ + <a name="VIR_ERR_XML_INVALID_SCHEMA">VIR_ERR_XML_INVALID_SCHEMA</a> = 92 /* XML document doens't validate against schema */ }; </pre><p/> </div> diff --git a/docs/devhelp/libvirt.devhelp b/docs/devhelp/libvirt.devhelp index 99af540f4..dd403145e 100644 --- a/docs/devhelp/libvirt.devhelp +++ b/docs/devhelp/libvirt.devhelp @@ -184,6 +184,7 @@ <function name="VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTED" link="libvirt-libvirt-domain.html#VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTED"/> <function name="VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_LAST" link="libvirt-libvirt-domain.html#VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_LAST"/> <function name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE" link="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE"/> + <function name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING" link="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING"/> <function name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS" link="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS"/> <function name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE" link="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE"/> <function name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER" link="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER"/> @@ -325,6 +326,7 @@ <function name="VIR_DOMAIN_CRASHED_LAST" link="libvirt-libvirt-domain.html#VIR_DOMAIN_CRASHED_LAST"/> <function name="VIR_DOMAIN_CRASHED_PANICKED" link="libvirt-libvirt-domain.html#VIR_DOMAIN_CRASHED_PANICKED"/> <function name="VIR_DOMAIN_CRASHED_UNKNOWN" link="libvirt-libvirt-domain.html#VIR_DOMAIN_CRASHED_UNKNOWN"/> + <function name="VIR_DOMAIN_DEFINE_VALIDATE" link="libvirt-libvirt-domain.html#VIR_DOMAIN_DEFINE_VALIDATE"/> <function name="VIR_DOMAIN_DESTROY_DEFAULT" link="libvirt-libvirt-domain.html#VIR_DOMAIN_DESTROY_DEFAULT"/> <function name="VIR_DOMAIN_DESTROY_GRACEFUL" link="libvirt-libvirt-domain.html#VIR_DOMAIN_DESTROY_GRACEFUL"/> <function name="VIR_DOMAIN_DEVICE_MODIFY_CONFIG" link="libvirt-libvirt-domain.html#VIR_DOMAIN_DEVICE_MODIFY_CONFIG"/> @@ -631,6 +633,7 @@ <function name="VIR_DOMAIN_START_BYPASS_CACHE" link="libvirt-libvirt-domain.html#VIR_DOMAIN_START_BYPASS_CACHE"/> <function name="VIR_DOMAIN_START_FORCE_BOOT" link="libvirt-libvirt-domain.html#VIR_DOMAIN_START_FORCE_BOOT"/> <function name="VIR_DOMAIN_START_PAUSED" link="libvirt-libvirt-domain.html#VIR_DOMAIN_START_PAUSED"/> + <function name="VIR_DOMAIN_START_VALIDATE" link="libvirt-libvirt-domain.html#VIR_DOMAIN_START_VALIDATE"/> <function name="VIR_DOMAIN_STATS_BALLOON" link="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_BALLOON"/> <function name="VIR_DOMAIN_STATS_BLOCK" link="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_BLOCK"/> <function name="VIR_DOMAIN_STATS_CPU_TOTAL" link="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_CPU_TOTAL"/> @@ -745,6 +748,7 @@ <function name="VIR_ERR_XEN_CALL" link="libvirt-virterror.html#VIR_ERR_XEN_CALL"/> <function name="VIR_ERR_XML_DETAIL" link="libvirt-virterror.html#VIR_ERR_XML_DETAIL"/> <function name="VIR_ERR_XML_ERROR" link="libvirt-virterror.html#VIR_ERR_XML_ERROR"/> + <function name="VIR_ERR_XML_INVALID_SCHEMA" link="libvirt-virterror.html#VIR_ERR_XML_INVALID_SCHEMA"/> <function name="VIR_EVENT_HANDLE_ERROR" link="libvirt-libvirt-event.html#VIR_EVENT_HANDLE_ERROR"/> <function name="VIR_EVENT_HANDLE_HANGUP" link="libvirt-libvirt-event.html#VIR_EVENT_HANDLE_HANGUP"/> <function name="VIR_EVENT_HANDLE_READABLE" link="libvirt-libvirt-event.html#VIR_EVENT_HANDLE_READABLE"/> @@ -990,6 +994,7 @@ <function name="virDomainCoreDumpFormat" link="libvirt-libvirt-domain.html#virDomainCoreDumpFormat"/> <function name="virDomainCrashedReason" link="libvirt-libvirt-domain.html#virDomainCrashedReason"/> <function name="virDomainCreateFlags" link="libvirt-libvirt-domain.html#virDomainCreateFlags"/> + <function name="virDomainDefineFlags" link="libvirt-libvirt-domain.html#virDomainDefineFlags"/> <function name="virDomainDestroyFlagsValues" link="libvirt-libvirt-domain.html#virDomainDestroyFlagsValues"/> <function name="virDomainDeviceModifyFlags" link="libvirt-libvirt-domain.html#virDomainDeviceModifyFlags"/> <function name="virDomainDiskErrorCode" link="libvirt-libvirt-domain.html#virDomainDiskErrorCode"/> @@ -1271,6 +1276,7 @@ <function name="virDomainCreateXML ()" link="libvirt-libvirt-domain.html#virDomainCreateXML"/> <function name="virDomainCreateXMLWithFiles ()" link="libvirt-libvirt-domain.html#virDomainCreateXMLWithFiles"/> <function name="virDomainDefineXML ()" link="libvirt-libvirt-domain.html#virDomainDefineXML"/> + <function name="virDomainDefineXMLFlags ()" link="libvirt-libvirt-domain.html#virDomainDefineXMLFlags"/> <function name="virDomainDestroy ()" link="libvirt-libvirt-domain.html#virDomainDestroy"/> <function name="virDomainDestroyFlags ()" link="libvirt-libvirt-domain.html#virDomainDestroyFlags"/> <function name="virDomainDetachDevice ()" link="libvirt-libvirt-domain.html#virDomainDetachDevice"/> diff --git a/docs/html/libvirt-libvirt-domain.html b/docs/html/libvirt-libvirt-domain.html index 7ed59dadf..1ef152860 100644 --- a/docs/html/libvirt-libvirt-domain.html +++ b/docs/html/libvirt-libvirt-domain.html @@ -163,6 +163,7 @@ <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virDomainCoreDumpFormat">virDomainCoreDumpFormat</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virDomainCrashedReason">virDomainCrashedReason</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virDomainCreateFlags">virDomainCreateFlags</a> +<span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virDomainDefineFlags">virDomainDefineFlags</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virDomainDestroyFlagsValues">virDomainDestroyFlagsValues</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a href="#virDomainDeviceModifyFlags">virDomainDeviceModifyFlags</a> <span class="keyword">typedef</span> <span class="type">struct _virDomainDiskError</span> <a href="#virDomainDiskError">virDomainDiskError</a> @@ -326,6 +327,7 @@ <span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> <a href="#virDomainCreateXML">virDomainCreateXML</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <br /> <span class="type">const char *</span> xmlDesc, <br /> <span class="type">unsigned int</span> flags) <span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> <a href="#virDomainCreateXMLWithFiles">virDomainCreateXMLWithFiles</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <br /> <span class="type">const char *</span> xmlDesc, <br /> <span class="type">unsigned int</span> nfiles, <br /> <span class="type">int *</span> files, <br /> <span class="type">unsigned int</span> flags) <span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> <a href="#virDomainDefineXML">virDomainDefineXML</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <br /> <span class="type">const char *</span> xml) +<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> <a href="#virDomainDefineXMLFlags">virDomainDefineXMLFlags</a> (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <br /> <span class="type">const char *</span> xml, <br /> <span class="type">unsigned int</span> flags) <span class="type">int</span> <a href="#virDomainDestroy">virDomainDestroy</a> (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain) <span class="type">int</span> <a href="#virDomainDestroyFlags">virDomainDestroyFlags</a> (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain, <br /> <span class="type">unsigned int</span> flags) <span class="type">int</span> <a href="#virDomainDetachDevice">virDomainDetachDevice</a> (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain, <br /> <span class="type">const char *</span> xml) @@ -457,7 +459,7 @@ </pre></div><h3><a name="virConnectDomainEventDiskChangeReason" id="virConnectDomainEventDiskChangeReason"><code>virConnectDomainEventDiskChangeReason</code></a><a class="headerlink" href="#virConnectDomainEventDiskChangeReason" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virConnectDomainEventDiskChangeReason { </pre><table><tr><td><a name="VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START" id="VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START">VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START</a></td><td> = </td><td>0</td><td><div class="comment">oldSrcPath is set</div></td></tr><tr><td><a name="VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START" id="VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START">VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START</a></td><td> = </td><td>1</td></tr><tr><td><a name="VIR_DOMAIN_EVENT_DISK_CHANGE_LAST" id="VIR_DOMAIN_EVENT_DISK_CHANGE_LAST">VIR_DOMAIN_EVENT_DISK_CHANGE_LAST</a></td><td> = </td><td>2</td></tr></table><pre>} </pre></div><h3><a name="virConnectGetAllDomainStatsFlags" id="virConnectGetAllDomainStatsFlags"><code>virConnectGetAllDomainStatsFlags</code></a><a class="headerlink" href="#virConnectGetAllDomainStatsFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virConnectGetAllDomainStatsFlags { -</pre><table><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_ACTIVE</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_INACTIVE</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER">VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_OTHER</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_PAUSED</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_PERSISTENT</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING">VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_RUNNING</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF">VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_SHUTOFF</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_TRANSIENT</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS</a></td><td> = </td><td>2147483648</td><td><div class="comment">enforce requested stats</div></td></tr></table><pre>} +</pre><table><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_ACTIVE</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_INACTIVE</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER">VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_OTHER</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_PAUSED</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_PERSISTENT</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING">VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_RUNNING</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF">VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_SHUTOFF</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT</a></td><td> = </td><td>VIR_CONNECT_LIST_DOMAINS_TRANSIENT</td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING">VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING</a></td><td> = </td><td>1073741824</td><td><div class="comment">include backing chain for block stats</div></td></tr><tr><td><a name="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS" id="VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS</a></td><td> = </td><td>2147483648</td><td><div class="comment">enforce requested stats</div></td></tr></table><pre>} </pre></div><h3><a name="virConnectListAllDomainsFlags" id="virConnectListAllDomainsFlags"><code>virConnectListAllDomainsFlags</code></a><a class="headerlink" href="#virConnectListAllDomainsFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virConnectListAllDomainsFlags { </pre><table><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_ACTIVE" id="VIR_CONNECT_LIST_DOMAINS_ACTIVE">VIR_CONNECT_LIST_DOMAINS_ACTIVE</a></td><td> = </td><td>1</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_INACTIVE" id="VIR_CONNECT_LIST_DOMAINS_INACTIVE">VIR_CONNECT_LIST_DOMAINS_INACTIVE</a></td><td> = </td><td>2</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_PERSISTENT" id="VIR_CONNECT_LIST_DOMAINS_PERSISTENT">VIR_CONNECT_LIST_DOMAINS_PERSISTENT</a></td><td> = </td><td>4</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_TRANSIENT" id="VIR_CONNECT_LIST_DOMAINS_TRANSIENT">VIR_CONNECT_LIST_DOMAINS_TRANSIENT</a></td><td> = </td><td>8</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_RUNNING" id="VIR_CONNECT_LIST_DOMAINS_RUNNING">VIR_CONNECT_LIST_DOMAINS_RUNNING</a></td><td> = </td><td>16</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_PAUSED" id="VIR_CONNECT_LIST_DOMAINS_PAUSED">VIR_CONNECT_LIST_DOMAINS_PAUSED</a></td><td> = </td><td>32</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_SHUTOFF" id="VIR_CONNECT_LIST_DOMAINS_SHUTOFF">VIR_CONNECT_LIST_DOMAINS_SHUTOFF</a></td><td> = </td><td>64</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_OTHER" id="VIR_CONNECT_LIST_DOMAINS_OTHER">VIR_CONNECT_LIST_DOMAINS_OTHER</a></td><td> = </td><td>128</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE" id="VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE">VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE</a></td><td> = </td><td>256</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE" id="VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE">VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE</a></td><td> = </td><td>512</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_AUTOSTART" id="VIR_CONNECT_LIST_DOMAINS_AUTOSTART">VIR_CONNECT_LIST_DOMAINS_AUTOSTART</a></td><td> = </td><td>1024</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART" id="VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART">VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART</a></td><td> = </td><td>2048</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT" id="VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT">VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT</a></td><td> = </td><td>4096</td></tr><tr><td><a name="VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT" id="VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT">VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT</a></td><td> = </td><td>8192</td></tr></table><pre>} </pre></div><h3><a name="virDomain" id="virDomain"><code>virDomain</code></a><a class="headerlink" href="#virDomain" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">struct </span>virDomain { @@ -468,7 +470,7 @@ </pre></div><h3><a name="virDomainBlockCopyFlags" id="virDomainBlockCopyFlags"><code>virDomainBlockCopyFlags</code></a><a class="headerlink" href="#virDomainBlockCopyFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainBlockCopyFlags { </pre><table><tr><td><a name="VIR_DOMAIN_BLOCK_COPY_SHALLOW" id="VIR_DOMAIN_BLOCK_COPY_SHALLOW">VIR_DOMAIN_BLOCK_COPY_SHALLOW</a></td><td> = </td><td>1</td><td><div class="comment">Limit copy to top of source backing chain</div></td></tr><tr><td><a name="VIR_DOMAIN_BLOCK_COPY_REUSE_EXT" id="VIR_DOMAIN_BLOCK_COPY_REUSE_EXT">VIR_DOMAIN_BLOCK_COPY_REUSE_EXT</a></td><td> = </td><td>2</td><td><div class="comment">Reuse existing external file for a copy</div></td></tr></table><pre>} </pre></div><h3><a name="virDomainBlockInfo" id="virDomainBlockInfo"><code>virDomainBlockInfo</code></a><a class="headerlink" href="#virDomainBlockInfo" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">struct </span>virDomainBlockInfo { -</pre><table><tr><td><span class="type">unsigned long long</span></td><td>capacity</td><td><div class="comment">logical size in bytes of the block device backing image</div></td></tr><tr><td><span class="type">unsigned long long</span></td><td>allocation</td><td><div class="comment">highest allocated extent in bytes of the block device backing image</div></td></tr><tr><td><span class="type">unsigned long long</span></td><td>physical</td><td><div class="comment">physical size in bytes of the container of the backing image</div></td></tr></table><pre> +</pre><table><tr><td><span class="type">unsigned long long</span></td><td>capacity</td><td><div class="comment">logical size in bytes of the image (how much storage the guest will see)</div></td></tr><tr><td><span class="type">unsigned long long</span></td><td>allocation</td><td><div class="comment">host storage in bytes occupied by the image (such as highest allocated extent if there are no holes, similar to 'du')</div></td></tr><tr><td><span class="type">unsigned long long</span></td><td>physical</td><td><div class="comment">host physical size in bytes of the image container (last offset, similar to 'ls'</div></td></tr></table><pre> } </pre></div><h3><a name="virDomainBlockJobAbortFlags" id="virDomainBlockJobAbortFlags"><code>virDomainBlockJobAbortFlags</code></a><a class="headerlink" href="#virDomainBlockJobAbortFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainBlockJobAbortFlags { </pre><table><tr><td><a name="VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC" id="VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC">VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC</a></td><td> = </td><td>1</td></tr><tr><td><a name="VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT" id="VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT">VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT</a></td><td> = </td><td>2</td></tr></table><pre>} @@ -508,7 +510,9 @@ </pre></div><h3><a name="virDomainCrashedReason" id="virDomainCrashedReason"><code>virDomainCrashedReason</code></a><a class="headerlink" href="#virDomainCrashedReason" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainCrashedReason { </pre><table><tr><td><a name="VIR_DOMAIN_CRASHED_UNKNOWN" id="VIR_DOMAIN_CRASHED_UNKNOWN">VIR_DOMAIN_CRASHED_UNKNOWN</a></td><td> = </td><td>0</td><td><div class="comment">crashed for unknown reason</div></td></tr><tr><td><a name="VIR_DOMAIN_CRASHED_PANICKED" id="VIR_DOMAIN_CRASHED_PANICKED">VIR_DOMAIN_CRASHED_PANICKED</a></td><td> = </td><td>1</td><td><div class="comment">domain panicked</div></td></tr><tr><td><a name="VIR_DOMAIN_CRASHED_LAST" id="VIR_DOMAIN_CRASHED_LAST">VIR_DOMAIN_CRASHED_LAST</a></td><td> = </td><td>2</td></tr></table><pre>} </pre></div><h3><a name="virDomainCreateFlags" id="virDomainCreateFlags"><code>virDomainCreateFlags</code></a><a class="headerlink" href="#virDomainCreateFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainCreateFlags { -</pre><table><tr><td><a name="VIR_DOMAIN_NONE" id="VIR_DOMAIN_NONE">VIR_DOMAIN_NONE</a></td><td> = </td><td>0</td><td><div class="comment">Default behavior</div></td></tr><tr><td><a name="VIR_DOMAIN_START_PAUSED" id="VIR_DOMAIN_START_PAUSED">VIR_DOMAIN_START_PAUSED</a></td><td> = </td><td>1</td><td><div class="comment">Launch guest in paused state</div></td></tr><tr><td><a name="VIR_DOMAIN_START_AUTODESTROY" id="VIR_DOMAIN_START_AUTODESTROY">VIR_DOMAIN_START_AUTODESTROY</a></td><td> = </td><td>2</td><td><div class="comment">Automatically kill guest when <a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a> is closed</div></td></tr><tr><td><a name="VIR_DOMAIN_START_BYPASS_CACHE" id="VIR_DOMAIN_START_BYPASS_CACHE">VIR_DOMAIN_START_BYPASS_CACHE</a></td><td> = </td><td>4</td><td><div class="comment">Avoid file system cache pollution</div></td></tr><tr><td><a name="VIR_DOMAIN_START_FORCE_BOOT" id="VIR_DOMAIN_START_FORCE_BOOT">VIR_DOMAIN_START_FORCE_BOOT</a></td><td> = </td><td>8</td><td><div class="comment">Boot, discarding any managed save</div></td></tr></table><pre>} +</pre><table><tr><td><a name="VIR_DOMAIN_NONE" id="VIR_DOMAIN_NONE">VIR_DOMAIN_NONE</a></td><td> = </td><td>0</td><td><div class="comment">Default behavior</div></td></tr><tr><td><a name="VIR_DOMAIN_START_PAUSED" id="VIR_DOMAIN_START_PAUSED">VIR_DOMAIN_START_PAUSED</a></td><td> = </td><td>1</td><td><div class="comment">Launch guest in paused state</div></td></tr><tr><td><a name="VIR_DOMAIN_START_AUTODESTROY" id="VIR_DOMAIN_START_AUTODESTROY">VIR_DOMAIN_START_AUTODESTROY</a></td><td> = </td><td>2</td><td><div class="comment">Automatically kill guest when <a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a> is closed</div></td></tr><tr><td><a name="VIR_DOMAIN_START_BYPASS_CACHE" id="VIR_DOMAIN_START_BYPASS_CACHE">VIR_DOMAIN_START_BYPASS_CACHE</a></td><td> = </td><td>4</td><td><div class="comment">Avoid file system cache pollution</div></td></tr><tr><td><a name="VIR_DOMAIN_START_FORCE_BOOT" id="VIR_DOMAIN_START_FORCE_BOOT">VIR_DOMAIN_START_FORCE_BOOT</a></td><td> = </td><td>8</td><td><div class="comment">Boot, discarding any managed save</div></td></tr><tr><td><a name="VIR_DOMAIN_START_VALIDATE" id="VIR_DOMAIN_START_VALIDATE">VIR_DOMAIN_START_VALIDATE</a></td><td> = </td><td>16</td><td><div class="comment">Validate the XML document against schema</div></td></tr></table><pre>} +</pre></div><h3><a name="virDomainDefineFlags" id="virDomainDefineFlags"><code>virDomainDefineFlags</code></a><a class="headerlink" href="#virDomainDefineFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainDefineFlags { +</pre><table><tr><td><a name="VIR_DOMAIN_DEFINE_VALIDATE" id="VIR_DOMAIN_DEFINE_VALIDATE">VIR_DOMAIN_DEFINE_VALIDATE</a></td><td> = </td><td>1</td><td><div class="comment">Validate the XML document against schema</div></td></tr></table><pre>} </pre></div><h3><a name="virDomainDestroyFlagsValues" id="virDomainDestroyFlagsValues"><code>virDomainDestroyFlagsValues</code></a><a class="headerlink" href="#virDomainDestroyFlagsValues" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainDestroyFlagsValues { </pre><table><tr><td><a name="VIR_DOMAIN_DESTROY_DEFAULT" id="VIR_DOMAIN_DESTROY_DEFAULT">VIR_DOMAIN_DESTROY_DEFAULT</a></td><td> = </td><td>0</td><td><div class="comment">Default behavior - could lead to data loss!!</div></td></tr><tr><td><a name="VIR_DOMAIN_DESTROY_GRACEFUL" id="VIR_DOMAIN_DESTROY_GRACEFUL">VIR_DOMAIN_DESTROY_GRACEFUL</a></td><td> = </td><td>1</td><td><div class="comment">only SIGTERM, no SIGKILL</div></td></tr></table><pre>} </pre></div><h3><a name="virDomainDeviceModifyFlags" id="virDomainDeviceModifyFlags"><code>virDomainDeviceModifyFlags</code></a><a class="headerlink" href="#virDomainDeviceModifyFlags" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virDomainDeviceModifyFlags { @@ -752,7 +756,7 @@ <span class="type">unsigned int</span> flags)</pre><div class="description"><p>Reads a domain XML configuration document, and generates a native configuration file describing the domain. The format of the native data is hypervisor dependant.</p></div><dl class="variablelist"><dt>conn</dt><dd>a connection object</dd><dt>nativeFormat</dt><dd>configuration format exporting to</dd><dt>domainXml</dt><dd>the domain configuration to export</dd><dt>flags</dt><dd>extra flags; not used yet, so callers should always pass 0</dd><dt>Returns</dt><dd>a 0 terminated UTF-8 encoded native config datafile, or NULL in case of error. the caller must free() the returned value.</dd></dl><div class="acl"></div><h3><a name="virConnectGetAllDomainStats" id="virConnectGetAllDomainStats"><code>virConnectGetAllDomainStats</code></a><a class="headerlink" href="#virConnectGetAllDomainStats" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virConnectGetAllDomainStats (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <span class="type">unsigned int</span> stats, <span class="type"><a href="libvirt-libvirt-domain.html#virDomainStatsRecordPtr">virDomainStatsRecordPtr</a> **</span> retStats, - <span class="type">unsigned int</span> flags)</pre><div class="description"><p>Query statistics for all domains on a given connection.</p><p>Report statistics of various parameters for a running VM according to @stats field. The statistics are returned as an array of structures for each queried domain. The structure contains an array of typed parameters containing the individual statistics. The typed parameter name for each statistic field consists of a dot-separated string containing name of the requested group followed by a group specific description of the statistic value.</p><p>The statistic groups are enabled using the @stats parameter which is a binary-OR of enum <a href="libvirt-libvirt-domain.html#virDomainStatsTypes">virDomainStatsTypes</a>. The following groups are available (although not necessarily implemented for each hypervisor):</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_STATE">VIR_DOMAIN_STATS_STATE</a>: Return domain state and reason for entering that state. The typed parameter keys are in this format: "state.state" - state of the VM, returned as int from <a href="libvirt-libvirt-domain.html#virDomainState">virDomainState</a> enum "state.reason" - reason for entering given state, returned as int from virDomain*Reason enum corresponding to given state.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_CPU_TOTAL">VIR_DOMAIN_STATS_CPU_TOTAL</a>: Return CPU statistics and usage information. The typed parameter keys are in this format: "cpu.time" - total cpu time spent for this domain in nanoseconds as unsigned long long. "cpu.user" - user cpu time spent in nanoseconds as unsigned long long. "cpu.system" - system cpu time spent in nanoseconds as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_BALLOON">VIR_DOMAIN_STATS_BALLOON</a>: Return memory balloon device information. The typed parameter keys are in this format: "balloon.current" - the memory in kiB currently used as unsigned long long. "balloon.maximum" - the maximum memory in kiB allowed as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_VCPU">VIR_DOMAIN_STATS_VCPU</a>: Return virtual CPU statistics. Due to VCPU hotplug, the vcpu.<num>.* array could be sparse. The actual size of the array corresponds to "vcpu.current". The array size will never exceed "vcpu.maximum". The typed parameter keys are in this format: "vcpu.current" - current number of online virtual CPUs as unsigned int. "vcpu.maximum" - maximum number of online virtual CPUs as unsigned int. "vcpu.<num>.state" - state of the virtual CPU <num>, as int from <a href="libvirt-libvirt-domain.html#virVcpuState">virVcpuState</a> enum. "vcpu.<num>.time" - virtual cpu time spent by virtual CPU <num> as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_INTERFACE">VIR_DOMAIN_STATS_INTERFACE</a>: Return network interface statistics. The typed parameter keys are in this format: "net.count" - number of network interfaces on this domain as unsigned int. "net.<num>.name" - name of the interface <num> as string. "net.<num>.rx.bytes" - bytes received as unsigned long long. "net.<num>.rx.pkts" - packets received as unsigned long long. "net.<num>.rx.errs" - receive errors as unsigned long long. "net.<num>.rx.drop" - receive packets dropped as unsigned long long. "net.<num>.tx.bytes" - bytes transmitted as unsigned long long. "net.<num>.tx.pkts" - packets transmitted as unsigned long long. "net.<num>.tx.errs" - transmission errors as unsigned long long. "net.<num>.tx.drop" - transmit packets dropped as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_BLOCK">VIR_DOMAIN_STATS_BLOCK</a>: Return block devices statistics. The typed parameter keys are in this format: "block.count" - number of block devices on this domain as unsigned int. "block.<num>.name" - name of the block device <num> as string. matches the target name (vda/sda/hda) of the block device. "block.<num>.path" - string describing the source of block device <num>, if it is a file or block device (omitted for network sources and drives with no media inserted). "block.<num>.rd.reqs" - number of read requests as unsigned long long. "block.<num>.rd.bytes" - number of read bytes as unsigned long long. "block.<num>.rd.times" - total time (ns) spent on reads as unsigned long long. "block.<num>.wr.reqs" - number of write requests as unsigned long long. "block.<num>.wr.bytes" - number of written bytes as unsigned long long. "block.<num>.wr.times" - total time (ns) spent on writes as unsigned long long. "block.<num>.fl.reqs" - total flush requests as unsigned long long. "block.<num>.fl.times" - total time (ns) spent on cache flushing as unsigned long long. "block.<num>.errors" - Xen only: the 'oo_req' value as unsigned long long. "block.<num>.allocation" - offset of the highest written sector as unsigned long long. "block.<num>.capacity" - logical size in bytes of the block device backing image as unsigned long long. "block.<num>.physical" - physical size in bytes of the container of the backing image as unsigned long long.</p><p>Note that entire stats groups or individual stat fields may be missing from the output in case they are not supported by the given hypervisor, are not applicable for the current state of the guest domain, or their retrieval was not successful.</p><p>Using 0 for @stats returns all stats groups supported by the given hypervisor.</p><p>Specifying <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS</a> as @flags makes the function return error in case some of the stat types in @stats were not recognized by the daemon. However, even with this flag, a hypervisor may omit individual fields within a known group if the information is not available; as an extreme example, a supported group may produce zero fields for offline domains if the statistics are meaningful only for a running domain.</p><p>Similarly to <a href="libvirt-libvirt-domain.html#virConnectListAllDomains">virConnectListAllDomains</a>, @flags can contain various flags to filter the list of domains to provide stats for.</p><p><a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE</a> selects online domains while <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE</a> selects offline ones.</p><p><a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT</a> and <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT</a> allow to filter the list according to their persistence.</p><p>To filter the list of VMs by domain state @flags can contain <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING">VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING</a>, <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED</a>, <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF">VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF</a> and/or <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER">VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER</a> for all other states.</p></div><dl class="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>stats</dt><dd>stats to return, binary-OR of <a href="libvirt-libvirt-domain.html#virDomainStatsTypes">virDomainStatsTypes</a></dd><dt>retStats</dt><dd>Pointer that will be filled with the array of returned stats</dd><dt>flags</dt><dd>extra flags; binary-OR of <a href="libvirt-libvirt-domain.html#virConnectGetAllDomainStatsFlags">virConnectGetAllDomainStatsFlags</a></dd><dt>Returns</dt><dd>the count of returned statistics structures on success, -1 on error. The requested data are returned in the @retStats parameter. The returned array should be freed by the caller. See <a href="libvirt-libvirt-domain.html#virDomainStatsRecordListFree">virDomainStatsRecordListFree</a>.</dd></dl><div class="acl"></div><h3><a name="virConnectGetDomainCapabilities" id="virConnectGetDomainCapabilities"><code>virConnectGetDomainCapabilities</code></a><a class="headerlink" href="#virConnectGetDomainCapabilities" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">char *</span> virConnectGetDomainCapabilities (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, + <span class="type">unsigned int</span> flags)</pre><div class="description"><p>Query statistics for all domains on a given connection.</p><p>Report statistics of various parameters for a running VM according to @stats field. The statistics are returned as an array of structures for each queried domain. The structure contains an array of typed parameters containing the individual statistics. The typed parameter name for each statistic field consists of a dot-separated string containing name of the requested group followed by a group specific description of the statistic value.</p><p>The statistic groups are enabled using the @stats parameter which is a binary-OR of enum <a href="libvirt-libvirt-domain.html#virDomainStatsTypes">virDomainStatsTypes</a>. The following groups are available (although not necessarily implemented for each hypervisor):</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_STATE">VIR_DOMAIN_STATS_STATE</a>: Return domain state and reason for entering that state. The typed parameter keys are in this format: "state.state" - state of the VM, returned as int from <a href="libvirt-libvirt-domain.html#virDomainState">virDomainState</a> enum "state.reason" - reason for entering given state, returned as int from virDomain*Reason enum corresponding to given state.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_CPU_TOTAL">VIR_DOMAIN_STATS_CPU_TOTAL</a>: Return CPU statistics and usage information. The typed parameter keys are in this format: "cpu.time" - total cpu time spent for this domain in nanoseconds as unsigned long long. "cpu.user" - user cpu time spent in nanoseconds as unsigned long long. "cpu.system" - system cpu time spent in nanoseconds as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_BALLOON">VIR_DOMAIN_STATS_BALLOON</a>: Return memory balloon device information. The typed parameter keys are in this format: "balloon.current" - the memory in kiB currently used as unsigned long long. "balloon.maximum" - the maximum memory in kiB allowed as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_VCPU">VIR_DOMAIN_STATS_VCPU</a>: Return virtual CPU statistics. Due to VCPU hotplug, the vcpu.<num>.* array could be sparse. The actual size of the array corresponds to "vcpu.current". The array size will never exceed "vcpu.maximum". The typed parameter keys are in this format: "vcpu.current" - current number of online virtual CPUs as unsigned int. "vcpu.maximum" - maximum number of online virtual CPUs as unsigned int. "vcpu.<num>.state" - state of the virtual CPU <num>, as int from <a href="libvirt-libvirt-domain.html#virVcpuState">virVcpuState</a> enum. "vcpu.<num>.time" - virtual cpu time spent by virtual CPU <num> as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_INTERFACE">VIR_DOMAIN_STATS_INTERFACE</a>: Return network interface statistics. The typed parameter keys are in this format: "net.count" - number of network interfaces on this domain as unsigned int. "net.<num>.name" - name of the interface <num> as string. "net.<num>.rx.bytes" - bytes received as unsigned long long. "net.<num>.rx.pkts" - packets received as unsigned long long. "net.<num>.rx.errs" - receive errors as unsigned long long. "net.<num>.rx.drop" - receive packets dropped as unsigned long long. "net.<num>.tx.bytes" - bytes transmitted as unsigned long long. "net.<num>.tx.pkts" - packets transmitted as unsigned long long. "net.<num>.tx.errs" - transmission errors as unsigned long long. "net.<num>.tx.drop" - transmit packets dropped as unsigned long long.</p><p><a href="libvirt-libvirt-domain.html#VIR_DOMAIN_STATS_BLOCK">VIR_DOMAIN_STATS_BLOCK</a>: Return block devices statistics. By default, this information is limited to the active layer of each <disk> of the domain (where block.count is equal to the number of disks), but adding <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING">VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING</a> to @flags will expand the array to cover backing chains (block.count corresponds to the number of host resources used together to provide the guest disks). The typed parameter keys are in this format: "block.count" - number of block devices in the subsequent list, as unsigned int. "block.<num>.name" - name of the block device <num> as string. matches the target name (vda/sda/hda) of the block device. If the backing chain is listed, this name is the same for all host resources tied to the same guest device. "block.<num>.backingIndex" - unsigned int giving the <backingStore> index, only used when backing images are listed. "block.<num>.path" - string describing the source of block device <num>, if it is a file or block device (omitted for network sources and drives with no media inserted). "block.<num>.rd.reqs" - number of read requests as unsigned long long. "block.<num>.rd.bytes" - number of read bytes as unsigned long long. "block.<num>.rd.times" - total time (ns) spent on reads as unsigned long long. "block.<num>.wr.reqs" - number of write requests as unsigned long long. "block.<num>.wr.bytes" - number of written bytes as unsigned long long. "block.<num>.wr.times" - total time (ns) spent on writes as unsigned long long. "block.<num>.fl.reqs" - total flush requests as unsigned long long. "block.<num>.fl.times" - total time (ns) spent on cache flushing as unsigned long long. "block.<num>.errors" - Xen only: the 'oo_req' value as unsigned long long. "block.<num>.allocation" - offset of the highest written sector as unsigned long long. "block.<num>.capacity" - logical size in bytes of the block device backing image as unsigned long long. "block.<num>.physical" - physical size in bytes of the container of the backing image as unsigned long long.</p><p>Note that entire stats groups or individual stat fields may be missing from the output in case they are not supported by the given hypervisor, are not applicable for the current state of the guest domain, or their retrieval was not successful.</p><p>Using 0 for @stats returns all stats groups supported by the given hypervisor.</p><p>Specifying <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS</a> as @flags makes the function return error in case some of the stat types in @stats were not recognized by the daemon. However, even with this flag, a hypervisor may omit individual fields within a known group if the information is not available; as an extreme example, a supported group may produce zero fields for offline domains if the statistics are meaningful only for a running domain.</p><p>Similarly to <a href="libvirt-libvirt-domain.html#virConnectListAllDomains">virConnectListAllDomains</a>, @flags can contain various flags to filter the list of domains to provide stats for.</p><p><a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE</a> selects online domains while <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE">VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE</a> selects offline ones.</p><p><a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT</a> and <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT">VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT</a> allow to filter the list according to their persistence.</p><p>To filter the list of VMs by domain state @flags can contain <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING">VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING</a>, <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED">VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED</a>, <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF">VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF</a> and/or <a href="libvirt-libvirt-domain.html#VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER">VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER</a> for all other states.</p></div><dl class="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>stats</dt><dd>stats to return, binary-OR of <a href="libvirt-libvirt-domain.html#virDomainStatsTypes">virDomainStatsTypes</a></dd><dt>retStats</dt><dd>Pointer that will be filled with the array of returned stats</dd><dt>flags</dt><dd>extra flags; binary-OR of <a href="libvirt-libvirt-domain.html#virConnectGetAllDomainStatsFlags">virConnectGetAllDomainStatsFlags</a></dd><dt>Returns</dt><dd>the count of returned statistics structures on success, -1 on error. The requested data are returned in the @retStats parameter. The returned array should be freed by the caller. See <a href="libvirt-libvirt-domain.html#virDomainStatsRecordListFree">virDomainStatsRecordListFree</a>.</dd></dl><div class="acl"></div><h3><a name="virConnectGetDomainCapabilities" id="virConnectGetDomainCapabilities"><code>virConnectGetDomainCapabilities</code></a><a class="headerlink" href="#virConnectGetDomainCapabilities" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">char *</span> virConnectGetDomainCapabilities (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, <span class="type">const char *</span> emulatorbin, <span class="type">const char *</span> arch, <span class="type">const char *</span> machine, @@ -834,7 +838,9 @@ free(domains);</pre></div><dl class="variablelist"><dt>conn</dt><dd>Pointer to t <span class="type">unsigned int</span> nfiles, <span class="type">int *</span> files, <span class="type">unsigned int</span> flags)</pre><div class="description"><p>Launch a new guest domain, based on an XML description similar to the one returned by <a href="libvirt-libvirt-domain.html#virDomainGetXMLDesc">virDomainGetXMLDesc</a>() This function may require privileged access to the hypervisor. The domain is not persistent, so its definition will disappear when it is destroyed, or if the host is restarted (see <a href="libvirt-libvirt-domain.html#virDomainDefineXML">virDomainDefineXML</a>() to define persistent domains).</p><p>@files provides an array of file descriptors which will be made available to the 'init' process of the guest. The file handles exposed to the guest will be renumbered to start from 3 (ie immediately following stderr). This is only supported for guests which use container based virtualization technology.</p><p>If the <a href="libvirt-libvirt-domain.html#VIR_DOMAIN_START_PAUSED">VIR_DOMAIN_START_PAUSED</a> flag is set, the guest domain will be started, but its CPUs will remain paused. The CPUs can later be manually started using <a href="libvirt-libvirt-domain.html#virDomainResume">virDomainResume</a>.</p><p>If the <a href="libvirt-libvirt-domain.html#VIR_DOMAIN_START_AUTODESTROY">VIR_DOMAIN_START_AUTODESTROY</a> flag is set, the guest domain will be automatically destroyed when the <a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a> object is finally released. This will also happen if the client application crashes / loses its connection to the libvirtd daemon. Any domains marked for auto destroy will block attempts at migration, save-to-file, or snapshots.</p><p><a href="libvirt-libvirt-domain.html#virDomainFree">virDomainFree</a> should be used to free the resources after the domain object is no longer needed.</p></div><dl class="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>xmlDesc</dt><dd>string containing an XML description of the domain</dd><dt>nfiles</dt><dd>number of file descriptors passed</dd><dt>files</dt><dd>list of file descriptors passed</dd><dt>flags</dt><dd>bitwise-OR of supported <a href="libvirt-libvirt-domain.html#virDomainCreateFlags">virDomainCreateFlags</a></dd><dt>Returns</dt><dd>a new domain object or NULL in case of failure</dd></dl><div class="acl"></div><h3><a name="virDomainDefineXML" id="virDomainDefineXML"><code>virDomainDefineXML</code></a><a class="headerlink" href="#virDomainDefineXML" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> virDomainDefineXML (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, - <span class="type">const char *</span> xml)</pre><div class="description"><p>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with <a href="libvirt-libvirt-domain.html#virDomainUndefine">virDomainUndefine</a>(). A previous definition for this domain would be overridden if it already exists.</p><p>Some hypervisors may prevent this operation if there is a current block copy operation on a transient domain with the same id as the domain being defined; in that case, use <a href="libvirt-libvirt-domain.html#virDomainBlockJobAbort">virDomainBlockJobAbort</a>() to stop the block copy first.</p><p><a href="libvirt-libvirt-domain.html#virDomainFree">virDomainFree</a> should be used to free the resources after the domain object is no longer needed.</p></div><dl class="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>xml</dt><dd>the XML description for the domain, preferably in UTF-8</dd><dt>Returns</dt><dd>NULL in case of error, a pointer to the domain otherwise</dd></dl><div class="acl"></div><h3><a name="virDomainDestroy" id="virDomainDestroy"><code>virDomainDestroy</code></a><a class="headerlink" href="#virDomainDestroy" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virDomainDestroy (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain)</pre><div class="description"><p>Destroy the domain object. The running instance is shutdown if not down already and all resources used by it are given back to the hypervisor. This does not free the associated <a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a> object. This function may require privileged access.</p><p><a href="libvirt-libvirt-domain.html#virDomainDestroy">virDomainDestroy</a> first requests that a guest terminate (e.g. SIGTERM), then waits for it to comply. After a reasonable timeout, if the guest still exists, <a href="libvirt-libvirt-domain.html#virDomainDestroy">virDomainDestroy</a> will forcefully terminate the guest (e.g. SIGKILL) if necessary (which may produce undesirable results, for example unflushed disk cache in the guest). To avoid this possibility, it's recommended to instead call <a href="libvirt-libvirt-domain.html#virDomainDestroyFlags">virDomainDestroyFlags</a>, sending the <a href="libvirt-libvirt-domain.html#VIR_DOMAIN_DESTROY_GRACEFUL">VIR_DOMAIN_DESTROY_GRACEFUL</a> flag.</p><p>If the domain is transient and has any snapshot metadata (see <a href="libvirt-libvirt-domain-snapshot.html#virDomainSnapshotNum">virDomainSnapshotNum</a>()), then that metadata will automatically be deleted when the domain quits.</p></div><dl class="variablelist"><dt>domain</dt><dd>a domain object</dd><dt>Returns</dt><dd>0 in case of success and -1 in case of failure.</dd></dl><div class="acl"></div><h3><a name="virDomainDestroyFlags" id="virDomainDestroyFlags"><code>virDomainDestroyFlags</code></a><a class="headerlink" href="#virDomainDestroyFlags" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virDomainDestroyFlags (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain, + <span class="type">const char *</span> xml)</pre><div class="description"><p>Define a domain, but does not start it. This definition is persistent, until explicitly undefined with <a href="libvirt-libvirt-domain.html#virDomainUndefine">virDomainUndefine</a>(). A previous definition for this domain would be overridden if it already exists.</p><p>Some hypervisors may prevent this operation if there is a current block copy operation on a transient domain with the same id as the domain being defined; in that case, use <a href="libvirt-libvirt-domain.html#virDomainBlockJobAbort">virDomainBlockJobAbort</a>() to stop the block copy first.</p><p><a href="libvirt-libvirt-domain.html#virDomainFree">virDomainFree</a> should be used to free the resources after the domain object is no longer needed.</p></div><dl class="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>xml</dt><dd>the XML description for the domain, preferably in UTF-8</dd><dt>Returns</dt><dd>NULL in case of error, a pointer to the domain otherwise</dd></dl><div class="acl"></div><h3><a name="virDomainDefineXMLFlags" id="virDomainDefineXMLFlags"><code>virDomainDefineXMLFlags</code></a><a class="headerlink" href="#virDomainDefineXMLFlags" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> virDomainDefineXMLFlags (<span class="type"><a href="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn, + <span class="type">const char *</span> xml, + <span class="type">unsigned int</span> flags)</pre><div class="description"><p>Defines a domain, but does not start it. This definition is persistent, until explicitly undefined with <a href="libvirt-libvirt-domain.html#virDomainUndefine">virDomainUndefine</a>(). A previous definition for this domain would be overridden if it already exists.</p><p>Some hypervisors may prevent this operation if there is a current block copy operation on a transient domain with the same id as the domain being defined; in that case, use <a href="libvirt-libvirt-domain.html#virDomainBlockJobAbort">virDomainBlockJobAbort</a>() to stop the block copy first.</p><p><a href="libvirt-libvirt-domain.html#virDomainFree">virDomainFree</a> should be used to free the resources after the domain object is no longer needed.</p></div><dl class="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>xml</dt><dd>the XML description for the domain, preferably in UTF-8</dd><dt>flags</dt><dd>bitwise OR of the <a href="libvirt-libvirt-domain.html#virDomainDefineFlags">virDomainDefineFlags</a> constants</dd><dt>Returns</dt><dd>NULL in case of error, a pointer to the domain otherwise</dd></dl><div class="acl"></div><h3><a name="virDomainDestroy" id="virDomainDestroy"><code>virDomainDestroy</code></a><a class="headerlink" href="#virDomainDestroy" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virDomainDestroy (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain)</pre><div class="description"><p>Destroy the domain object. The running instance is shutdown if not down already and all resources used by it are given back to the hypervisor. This does not free the associated <a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a> object. This function may require privileged access.</p><p><a href="libvirt-libvirt-domain.html#virDomainDestroy">virDomainDestroy</a> first requests that a guest terminate (e.g. SIGTERM), then waits for it to comply. After a reasonable timeout, if the guest still exists, <a href="libvirt-libvirt-domain.html#virDomainDestroy">virDomainDestroy</a> will forcefully terminate the guest (e.g. SIGKILL) if necessary (which may produce undesirable results, for example unflushed disk cache in the guest). To avoid this possibility, it's recommended to instead call <a href="libvirt-libvirt-domain.html#virDomainDestroyFlags">virDomainDestroyFlags</a>, sending the <a href="libvirt-libvirt-domain.html#VIR_DOMAIN_DESTROY_GRACEFUL">VIR_DOMAIN_DESTROY_GRACEFUL</a> flag.</p><p>If the domain is transient and has any snapshot metadata (see <a href="libvirt-libvirt-domain-snapshot.html#virDomainSnapshotNum">virDomainSnapshotNum</a>()), then that metadata will automatically be deleted when the domain quits.</p></div><dl class="variablelist"><dt>domain</dt><dd>a domain object</dd><dt>Returns</dt><dd>0 in case of success and -1 in case of failure.</dd></dl><div class="acl"></div><h3><a name="virDomainDestroyFlags" id="virDomainDestroyFlags"><code>virDomainDestroyFlags</code></a><a class="headerlink" href="#virDomainDestroyFlags" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virDomainDestroyFlags (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain, <span class="type">unsigned int</span> flags)</pre><div class="description"><p>Destroy the domain object. The running instance is shutdown if not down already and all resources used by it are given back to the hypervisor. This does not free the associated <a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a> object. This function may require privileged access.</p><p>Calling this function with no @flags set (equal to zero) is equivalent to calling <a href="libvirt-libvirt-domain.html#virDomainDestroy">virDomainDestroy</a>, and after a reasonable timeout will forcefully terminate the guest (e.g. SIGKILL) if necessary (which may produce undesirable results, for example unflushed disk cache in the guest). Including <a href="libvirt-libvirt-domain.html#VIR_DOMAIN_DESTROY_GRACEFUL">VIR_DOMAIN_DESTROY_GRACEFUL</a> in the flags will prevent the forceful termination of the guest, and <a href="libvirt-libvirt-domain.html#virDomainDestroyFlags">virDomainDestroyFlags</a> will instead return an error if the guest doesn't terminate by the end of the timeout; at that time, the management application can decide if calling again without <a href="libvirt-libvirt-domain.html#VIR_DOMAIN_DESTROY_GRACEFUL">VIR_DOMAIN_DESTROY_GRACEFUL</a> is appropriate.</p><p>Another alternative which may produce cleaner results for the guest's disks is to use <a href="libvirt-libvirt-domain.html#virDomainShutdown">virDomainShutdown</a>() instead, but that depends on guest support (some hypervisor/guest combinations may ignore the shutdown request).</p></div><dl class="variablelist"><dt>domain</dt><dd>a domain object</dd><dt>flags</dt><dd>bitwise-OR of <a href="libvirt-libvirt-domain.html#virDomainDestroyFlagsValues">virDomainDestroyFlagsValues</a></dd><dt>Returns</dt><dd>0 in case of success and -1 in case of failure.</dd></dl><div class="acl"></div><h3><a name="virDomainDetachDevice" id="virDomainDetachDevice"><code>virDomainDetachDevice</code></a><a class="headerlink" href="#virDomainDetachDevice" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virDomainDetachDevice (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain, <span class="type">const char *</span> xml)</pre><div class="description"><p>Destroy a virtual device attachment to backend. This function, having hot-unplug semantics, is only allowed on an active domain.</p><p>Be aware that hotplug changes might not persist across a domain going into S4 state (also known as hibernation) unless you also modify the persistent domain definition.</p></div><dl class="variablelist"><dt>domain</dt><dd>pointer to domain object</dd><dt>xml</dt><dd>pointer to XML description of one device</dd><dt>Returns</dt><dd>0 in case of success, -1 in case of failure.</dd></dl><div class="acl"></div><h3><a name="virDomainDetachDeviceFlags" id="virDomainDetachDeviceFlags"><code>virDomainDetachDeviceFlags</code></a><a class="headerlink" href="#virDomainDetachDeviceFlags" title="Permalink to this headline">¶</a></h3><pre class="api"><span class="type">int</span> virDomainDetachDeviceFlags (<span class="type"><a href="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain, <span class="type">const char *</span> xml, diff --git a/docs/html/libvirt-libvirt-host.html b/docs/html/libvirt-libvirt-host.html index 79faff61f..71965616a 100644 --- a/docs/html/libvirt-libvirt-host.html +++ b/docs/html/libvirt-libvirt-host.html @@ -164,10 +164,10 @@ </pre></div><h3><a name="virNodeSuspendTarget" id="virNodeSuspendTarget"><code>virNodeSuspendTarget</code></a><a class="headerlink" href="#virNodeSuspendTarget" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virNodeSuspendTarget { </pre><table><tr><td><a name="VIR_NODE_SUSPEND_TARGET_MEM" id="VIR_NODE_SUSPEND_TARGET_MEM">VIR_NODE_SUSPEND_TARGET_MEM</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_NODE_SUSPEND_TARGET_DISK" id="VIR_NODE_SUSPEND_TARGET_DISK">VIR_NODE_SUSPEND_TARGET_DISK</a></td><td> = </td><td>1</td></tr><tr><td><a name="VIR_NODE_SUSPEND_TARGET_HYBRID" id="VIR_NODE_SUSPEND_TARGET_HYBRID">VIR_NODE_SUSPEND_TARGET_HYBRID</a></td><td> = </td><td>2</td></tr><tr><td><a name="VIR_NODE_SUSPEND_TARGET_LAST" id="VIR_NODE_SUSPEND_TARGET_LAST">VIR_NODE_SUSPEND_TARGET_LAST</a></td><td> = </td><td>3</td><td><div class="comment">This constant is subject to change</div></td></tr></table><pre>} </pre></div><h3><a name="virSecurityLabel" id="virSecurityLabel"><code>virSecurityLabel</code></a><a class="headerlink" href="#virSecurityLabel" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">struct </span>virSecurityLabel { -</pre><div class="undisclosed">The content of this structure is not made public by the API</div><pre> +</pre><table><tr><td><span class="type">char label[VIR_SECURITY_LABEL_BUFLEN]</span></td><td>label</td><td><div class="comment">security label string</div></td></tr><tr><td><span class="type">int</span></td><td>enforcing</td><td><div class="comment">1 if security policy is being enforced for domain</div></td></tr></table><pre> } </pre></div><h3><a name="virSecurityModel" id="virSecurityModel"><code>virSecurityModel</code></a><a class="headerlink" href="#virSecurityModel" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">struct </span>virSecurityModel { -</pre><div class="undisclosed">The content of this structure is not made public by the API</div><pre> +</pre><table><tr><td><span class="type">char model[VIR_SECURITY_MODEL_BUFLEN]</span></td><td>model</td><td><div class="comment">security model string</div></td></tr><tr><td><span class="type">char doi[VIR_SECURITY_DOI_BUFLEN]</span></td><td>doi</td><td><div class="comment">domain of interpretation</div></td></tr></table><pre> } </pre></div><h3><a name="virStream" id="virStream"><code>virStream</code></a><a class="headerlink" href="#virStream" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">struct </span>virStream { </pre><div class="undisclosed">The content of this structure is not made public by the API</div><pre> diff --git a/docs/html/libvirt-virterror.html b/docs/html/libvirt-virterror.html index 4159c4db4..fce508b99 100644 --- a/docs/html/libvirt-virterror.html +++ b/docs/html/libvirt-virterror.html @@ -32,7 +32,7 @@ </pre></div><h3><a name="virErrorLevel" id="virErrorLevel"><code>virErrorLevel</code></a><a class="headerlink" href="#virErrorLevel" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virErrorLevel { </pre><table><tr><td><a name="VIR_ERR_NONE" id="VIR_ERR_NONE">VIR_ERR_NONE</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_ERR_WARNING" id="VIR_ERR_WARNING">VIR_ERR_WARNING</a></td><td> = </td><td>1</td><td><div class="comment">A simple warning</div></td></tr><tr><td><a name="VIR_ERR_ERROR" id="VIR_ERR_ERROR">VIR_ERR_ERROR</a></td><td> = </td><td>2</td><td><div class="comment">An error</div></td></tr></table><pre>} </pre></div><h3><a name="virErrorNumber" id="virErrorNumber"><code>virErrorNumber</code></a><a class="headerlink" href="#virErrorNumber" title="Permalink to this headline">¶</a></h3><div class="api"><pre><span class="keyword">enum</span> virErrorNumber { -</pre><table><tr><td><a name="VIR_ERR_OK" id="VIR_ERR_OK">VIR_ERR_OK</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_ERR_INTERNAL_ERROR" id="VIR_ERR_INTERNAL_ERROR">VIR_ERR_INTERNAL_ERROR</a></td><td> = </td><td>1</td><td><div class="comment">internal error</div></td></tr><tr><td><a name="VIR_ERR_NO_MEMORY" id="VIR_ERR_NO_MEMORY">VIR_ERR_NO_MEMORY</a></td><td> = </td><td>2</td><td><div class="comment">memory allocation failure</div></td></tr><tr><td><a name="VIR_ERR_NO_SUPPORT" id="VIR_ERR_NO_SUPPORT">VIR_ERR_NO_SUPPORT</a></td><td> = </td><td>3</td><td><div class="comment">no support for this function</div></td></tr><tr><td><a name="VIR_ERR_UNKNOWN_HOST" id="VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a></td><td> = </td><td>4</td><td><div class="comment">could not resolve hostname</div></td></tr><tr><td><a name="VIR_ERR_NO_CONNECT" id="VIR_ERR_NO_CONNECT">VIR_ERR_NO_CONNECT</a></td><td> = </td><td>5</td><td><div class="comment">can't connect to hypervisor</div></td></tr><tr><td><a name="VIR_ERR_INVALID_CONN" id="VIR_ERR_INVALID_CONN">VIR_ERR_INVALID_CONN</a></td><td> = </td><td>6</td><td><div class="comment">invalid connection object</div></td></tr><tr><td><a name="VIR_ERR_INVALID_DOMAIN" id="VIR_ERR_INVALID_DOMAIN">VIR_ERR_INVALID_DOMAIN</a></td><td> = </td><td>7</td><td><div class="comment">invalid domain object</div></td></tr><tr><td><a name="VIR_ERR_INVALID_ARG" id="VIR_ERR_INVALID_ARG">VIR_ERR_INVALID_ARG</a></td><td> = </td><td>8</td><td><div class="comment">invalid function argument</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_FAILED" id="VIR_ERR_OPERATION_FAILED">VIR_ERR_OPERATION_FAILED</a></td><td> = </td><td>9</td><td><div class="comment">a command to hypervisor failed</div></td></tr><tr><td><a name="VIR_ERR_GET_FAILED" id="VIR_ERR_GET_FAILED">VIR_ERR_GET_FAILED</a></td><td> = </td><td>10</td><td><div class="comment">a HTTP GET command to failed</div></td></tr><tr><td><a name="VIR_ERR_POST_FAILED" id="VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a></td><td> = </td><td>11</td><td><div class="comment">a HTTP POST command to failed</div></td></tr><tr><td><a name="VIR_ERR_HTTP_ERROR" id="VIR_ERR_HTTP_ERROR">VIR_ERR_HTTP_ERROR</a></td><td> = </td><td>12</td><td><div class="comment">unexpected HTTP error code</div></td></tr><tr><td><a name="VIR_ERR_SEXPR_SERIAL" id="VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a></td><td> = </td><td>13</td><td><div class="comment">failure to serialize an S-Expr</div></td></tr><tr><td><a name="VIR_ERR_NO_XEN" id="VIR_ERR_NO_XEN">VIR_ERR_NO_XEN</a></td><td> = </td><td>14</td><td><div class="comment">could not open Xen hypervisor control</div></td></tr><tr><td><a name="VIR_ERR_XEN_CALL" id="VIR_ERR_XEN_CALL">VIR_ERR_XEN_CALL</a></td><td> = </td><td>15</td><td><div class="comment">failure doing an hypervisor call</div></td></tr><tr><td><a name="VIR_ERR_OS_TYPE" id="VIR_ERR_OS_TYPE">VIR_ERR_OS_TYPE</a></td><td> = </td><td>16</td><td><div class="comment">unknown OS type</div></td></tr><tr><td><a name="VIR_ERR_NO_KERNEL" id="VIR_ERR_NO_KERNEL">VIR_ERR_NO_KERNEL</a></td><td> = </td><td>17</td><td><div class="comment">missing kernel information</div></td></tr><tr><td><a name="VIR_ERR_NO_ROOT" id="VIR_ERR_NO_ROOT">VIR_ERR_NO_ROOT</a></td><td> = </td><td>18</td><td><div class="comment">missing root device information</div></td></tr><tr><td><a name="VIR_ERR_NO_SOURCE" id="VIR_ERR_NO_SOURCE">VIR_ERR_NO_SOURCE</a></td><td> = </td><td>19</td><td><div class="comment">missing source device information</div></td></tr><tr><td><a name="VIR_ERR_NO_TARGET" id="VIR_ERR_NO_TARGET">VIR_ERR_NO_TARGET</a></td><td> = </td><td>20</td><td><div class="comment">missing target device information</div></td></tr><tr><td><a name="VIR_ERR_NO_NAME" id="VIR_ERR_NO_NAME">VIR_ERR_NO_NAME</a></td><td> = </td><td>21</td><td><div class="comment">missing domain name information</div></td></tr><tr><td><a name="VIR_ERR_NO_OS" id="VIR_ERR_NO_OS">VIR_ERR_NO_OS</a></td><td> = </td><td>22</td><td><div class="comment">missing domain OS information</div></td></tr><tr><td><a name="VIR_ERR_NO_DEVICE" id="VIR_ERR_NO_DEVICE">VIR_ERR_NO_DEVICE</a></td><td> = </td><td>23</td><td><div class="comment">missing domain devices information</div></td></tr><tr><td><a name="VIR_ERR_NO_XENSTORE" id="VIR_ERR_NO_XENSTORE">VIR_ERR_NO_XENSTORE</a></td><td> = </td><td>24</td><td><div class="comment">could not open Xen Store control</div></td></tr><tr><td><a name="VIR_ERR_DRIVER_FULL" id="VIR_ERR_DRIVER_FULL">VIR_ERR_DRIVER_FULL</a></td><td> = </td><td>25</td><td><div class="comment">too many drivers registered</div></td></tr><tr><td><a name="VIR_ERR_CALL_FAILED" id="VIR_ERR_CALL_FAILED">VIR_ERR_CALL_FAILED</a></td><td> = </td><td>26</td><td><div class="comment">not supported by the drivers (DEPRECATED)</div></td></tr><tr><td><a name="VIR_ERR_XML_ERROR" id="VIR_ERR_XML_ERROR">VIR_ERR_XML_ERROR</a></td><td> = </td><td>27</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" id="VIR_ERR_DOM_EXIST">VIR_ERR_DOM_EXIST</a></td><td> = </td><td>28</td><td><div class="comment">the domain already exist</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_DENIED" id="VIR_ERR_OPERATION_DENIED">VIR_ERR_OPERATION_DENIED</a></td><td> = </td><td>29</td><td><div class="comment">operation forbidden on read-only connections</div></td></tr><tr><td><a name="VIR_ERR_OPEN_FAILED" id="VIR_ERR_OPEN_FAILED">VIR_ERR_OPEN_FAILED</a></td><td> = </td><td>30</td><td><div class="comment">failed to open a conf file</div></td></tr><tr><td><a name="VIR_ERR_READ_FAILED" id="VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a></td><td> = </td><td>31</td><td><div class="comment">failed to read a conf file</div></td></tr><tr><td><a name="VIR_ERR_PARSE_FAILED" id="VIR_ERR_PARSE_FAILED">VIR_ERR_PARSE_FAILED</a></td><td> = </td><td>32</td><td><div class="comment">failed to parse a conf file</div></td></tr><tr><td><a name="VIR_ERR_CONF_SYNTAX" id="VIR_ERR_CONF_SYNTAX">VIR_ERR_CONF_SYNTAX</a></td><td> = </td><td>33</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" id="VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a></td><td> = </td><td>34</td><td><div class="comment">failed to write a conf file</div></td></tr><tr><td><a name="VIR_ERR_XML_DETAIL" id="VIR_ERR_XML_DETAIL">VIR_ERR_XML_DETAIL</a></td><td> = </td><td>35</td><td><div class="comment">detail of an XML error</div></td></tr><tr><td><a name="VIR_ERR_INVALID_NETWORK" id="VIR_ERR_INVALID_NETWORK">VIR_ERR_INVALID_NETWORK</a></td><td> = </td><td>36</td><td><div class="comment">invalid network object</div></td></tr><tr><td><a name="VIR_ERR_NETWORK_EXIST" id="VIR_ERR_NETWORK_EXIST">VIR_ERR_NETWORK_EXIST</a></td><td> = </td><td>37</td><td><div class="comment">the network already exist</div></td></tr><tr><td><a name="VIR_ERR_SYSTEM_ERROR" id="VIR_ERR_SYSTEM_ERROR">VIR_ERR_SYSTEM_ERROR</a></td><td> = </td><td>38</td><td><div class="comment">general system call failure</div></td></tr><tr><td><a name="VIR_ERR_RPC" id="VIR_ERR_RPC">VIR_ERR_RPC</a></td><td> = </td><td>39</td><td><div class="comment">some sort of RPC error</div></td></tr><tr><td><a name="VIR_ERR_GNUTLS_ERROR" id="VIR_ERR_GNUTLS_ERROR">VIR_ERR_GNUTLS_ERROR</a></td><td> = </td><td>40</td><td><div class="comment">error from a GNUTLS call</div></td></tr><tr><td><a name="VIR_WAR_NO_NETWORK" id="VIR_WAR_NO_NETWORK">VIR_WAR_NO_NETWORK</a></td><td> = </td><td>41</td><td><div class="comment">failed to start network</div></td></tr><tr><td><a name="VIR_ERR_NO_DOMAIN" id="VIR_ERR_NO_DOMAIN">VIR_ERR_NO_DOMAIN</a></td><td> = </td><td>42</td><td><div class="comment">domain not found or unexpectedly disappeared</div></td></tr><tr><td><a name="VIR_ERR_NO_NETWORK" id="VIR_ERR_NO_NETWORK">VIR_ERR_NO_NETWORK</a></td><td> = </td><td>43</td><td><div class="comment">network not found</div></td></tr><tr><td><a name="VIR_ERR_INVALID_MAC" id="VIR_ERR_INVALID_MAC">VIR_ERR_INVALID_MAC</a></td><td> = </td><td>44</td><td><div class="comment">invalid MAC address</div></td></tr><tr><td><a name="VIR_ERR_AUTH_FAILED" id="VIR_ERR_AUTH_FAILED">VIR_ERR_AUTH_FAILED</a></td><td> = </td><td>45</td><td><div class="comment">authentication failed</div></td></tr><tr><td><a name="VIR_ERR_INVALID_STORAGE_POOL" id="VIR_ERR_INVALID_STORAGE_POOL">VIR_ERR_INVALID_STORAGE_POOL</a></td><td> = </td><td>46</td><td><div class="comment">invalid storage pool object</div></td></tr><tr><td><a name="VIR_ERR_INVALID_STORAGE_VOL" id="VIR_ERR_INVALID_STORAGE_VOL">VIR_ERR_INVALID_STORAGE_VOL</a></td><td> = </td><td>47</td><td><div class="comment">invalid storage vol object</div></td></tr><tr><td><a name="VIR_WAR_NO_STORAGE" id="VIR_WAR_NO_STORAGE">VIR_WAR_NO_STORAGE</a></td><td> = </td><td>48</td><td><div class="comment">failed to start storage</div></td></tr><tr><td><a name="VIR_ERR_NO_STORAGE_POOL" id="VIR_ERR_NO_STORAGE_POOL">VIR_ERR_NO_STORAGE_POOL</a></td><td> = </td><td>49</td><td><div class="comment">storage pool not found</div></td></tr><tr><td><a name="VIR_ERR_NO_STORAGE_VOL" id="VIR_ERR_NO_STORAGE_VOL">VIR_ERR_NO_STORAGE_VOL</a></td><td> = </td><td>50</td><td><div class="comment">storage volume not found</div></td></tr><tr><td><a name="VIR_WAR_NO_NODE" id="VIR_WAR_NO_NODE">VIR_WAR_NO_NODE</a></td><td> = </td><td>51</td><td><div class="comment">failed to start node driver</div></td></tr><tr><td><a name="VIR_ERR_INVALID_NODE_DEVICE" id="VIR_ERR_INVALID_NODE_DEVICE">VIR_ERR_INVALID_NODE_DEVICE</a></td><td> = </td><td>52</td><td><div class="comment">invalid node device object</div></td></tr><tr><td><a name="VIR_ERR_NO_NODE_DEVICE" id="VIR_ERR_NO_NODE_DEVICE">VIR_ERR_NO_NODE_DEVICE</a></td><td> = </td><td>53</td><td><div class="comment">node device not found</div></td></tr><tr><td><a name="VIR_ERR_NO_SECURITY_MODEL" id="VIR_ERR_NO_SECURITY_MODEL">VIR_ERR_NO_SECURITY_MODEL</a></td><td> = </td><td>54</td><td><div class="comment">security model not found</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_INVALID" id="VIR_ERR_OPERATION_INVALID">VIR_ERR_OPERATION_INVALID</a></td><td> = </td><td>55</td><td><div class="comment">operation is not applicable at this time</div></td></tr><tr><td><a name="VIR_WAR_NO_INTERFACE" id="VIR_WAR_NO_INTERFACE">VIR_WAR_NO_INTERFACE</a></td><td> = </td><td>56</td><td><div class="comment">failed to start interface driver</div></td></tr><tr><td><a name="VIR_ERR_NO_INTERFACE" id="VIR_ERR_NO_INTERFACE">VIR_ERR_NO_INTERFACE</a></td><td> = </td><td>57</td><td><div class="comment">interface driver not running</div></td></tr><tr><td><a name="VIR_ERR_INVALID_INTERFACE" id="VIR_ERR_INVALID_INTERFACE">VIR_ERR_INVALID_INTERFACE</a></td><td> = </td><td>58</td><td><div class="comment">invalid interface object</div></td></tr><tr><td><a name="VIR_ERR_MULTIPLE_INTERFACES" id="VIR_ERR_MULTIPLE_INTERFACES">VIR_ERR_MULTIPLE_INTERFACES</a></td><td> = </td><td>59</td><td><div class="comment">more than one matching interface found</div></td></tr><tr><td><a name="VIR_WAR_NO_NWFILTER" id="VIR_WAR_NO_NWFILTER">VIR_WAR_NO_NWFILTER</a></td><td> = </td><td>60</td><td><div class="comment">failed to start nwfilter driver</div></td></tr><tr><td><a name="VIR_ERR_INVALID_NWFILTER" id="VIR_ERR_INVALID_NWFILTER">VIR_ERR_INVALID_NWFILTER</a></td><td> = </td><td>61</td><td><div class="comment">invalid nwfilter object</div></td></tr><tr><td><a name="VIR_ERR_NO_NWFILTER" id="VIR_ERR_NO_NWFILTER">VIR_ERR_NO_NWFILTER</a></td><td> = </td><td>62</td><td><div class="comment">nw filter pool not found</div></td></tr><tr><td><a name="VIR_ERR_BUILD_FIREWALL" id="VIR_ERR_BUILD_FIREWALL">VIR_ERR_BUILD_FIREWALL</a></td><td> = </td><td>63</td><td><div class="comment">nw filter pool not found</div></td></tr><tr><td><a name="VIR_WAR_NO_SECRET" id="VIR_WAR_NO_SECRET">VIR_WAR_NO_SECRET</a></td><td> = </td><td>64</td><td><div class="comment">failed to start secret storage</div></td></tr><tr><td><a name="VIR_ERR_INVALID_SECRET" id="VIR_ERR_INVALID_SECRET">VIR_ERR_INVALID_SECRET</a></td><td> = </td><td>65</td><td><div class="comment">invalid secret</div></td></tr><tr><td><a name="VIR_ERR_NO_SECRET" id="VIR_ERR_NO_SECRET">VIR_ERR_NO_SECRET</a></td><td> = </td><td>66</td><td><div class="comment">secret not found</div></td></tr><tr><td><a name="VIR_ERR_CONFIG_UNSUPPORTED" id="VIR_ERR_CONFIG_UNSUPPORTED">VIR_ERR_CONFIG_UNSUPPORTED</a></td><td> = </td><td>67</td><td><div class="comment">unsupported configuration construct</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_TIMEOUT" id="VIR_ERR_OPERATION_TIMEOUT">VIR_ERR_OPERATION_TIMEOUT</a></td><td> = </td><td>68</td><td><div class="comment">timeout occurred during operation</div></td></tr><tr><td><a name="VIR_ERR_MIGRATE_PERSIST_FAILED" id="VIR_ERR_MIGRATE_PERSIST_FAILED">VIR_ERR_MIGRATE_PERSIST_FAILED</a></td><td> = </td><td>69</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" id="VIR_ERR_HOOK_SCRIPT_FAILED">VIR_ERR_HOOK_SCRIPT_FAILED</a></td><td> = </td><td>70</td><td><div class="comment">a synchronous hook script failed</div></td></tr><tr><td><a name="VIR_ERR_INVALID_DOMAIN_SNAPSHOT" id="VIR_ERR_INVALID_DOMAIN_SNAPSHOT">VIR_ERR_INVALID_DOMAIN_SNAPSHOT</a></td><td> = </td><td>71</td><td><div class="comment">invalid domain snapshot</div></td></tr><tr><td><a name="VIR_ERR_NO_DOMAIN_SNAPSHOT" id="VIR_ERR_NO_DOMAIN_SNAPSHOT">VIR_ERR_NO_DOMAIN_SNAPSHOT</a></td><td> = </td><td>72</td><td><div class="comment">domain snapshot not found</div></td></tr><tr><td><a name="VIR_ERR_INVALID_STREAM" id="VIR_ERR_INVALID_STREAM">VIR_ERR_INVALID_STREAM</a></td><td> = </td><td>73</td><td><div class="comment">stream pointer not valid</div></td></tr><tr><td><a name="VIR_ERR_ARGUMENT_UNSUPPORTED" id="VIR_ERR_ARGUMENT_UNSUPPORTED">VIR_ERR_ARGUMENT_UNSUPPORTED</a></td><td> = </td><td>74</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" id="VIR_ERR_STORAGE_PROBE_FAILED">VIR_ERR_STORAGE_PROBE_FAILED</a></td><td> = </td><td>75</td><td><div class="comment">storage pool probe failed</div></td></tr><tr><td><a name="VIR_ERR_STORAGE_POOL_BUILT" id="VIR_ERR_STORAGE_POOL_BUILT">VIR_ERR_STORAGE_POOL_BUILT</a></td><td> = </td><td>76</td><td><div class="comment">storage pool already built</div></td></tr><tr><td><a name="VIR_ERR_SNAPSHOT_REVERT_RISKY" id="VIR_ERR_SNAPSHOT_REVERT_RISKY">VIR_ERR_SNAPSHOT_REVERT_RISKY</a></td><td> = </td><td>77</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" id="VIR_ERR_OPERATION_ABORTED">VIR_ERR_OPERATION_ABORTED</a></td><td> = </td><td>78</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" id="VIR_ERR_AUTH_CANCELLED">VIR_ERR_AUTH_CANCELLED</a></td><td> = </td><td>79</td><td><div class="comment">authentication cancelled</div></td></tr><tr><td><a name="VIR_ERR_NO_DOMAIN_METADATA" id="VIR_ERR_NO_DOMAIN_METADATA">VIR_ERR_NO_DOMAIN_METADATA</a></td><td> = </td><td>80</td><td><div class="comment">The metadata is not present</div></td></tr><tr><td><a name="VIR_ERR_MIGRATE_UNSAFE" id="VIR_ERR_MIGRATE_UNSAFE">VIR_ERR_MIGRATE_UNSAFE</a></td><td> = </td><td>81</td><td><div class="comment">Migration is not safe</div></td></tr><tr><td><a name="VIR_ERR_OVERFLOW" id="VIR_ERR_OVERFLOW">VIR_ERR_OVERFLOW</a></td><td> = </td><td>82</td><td><div class="comment">integer overflow</div></td></tr><tr><td><a name="VIR_ERR_BLOCK_COPY_ACTIVE" id="VIR_ERR_BLOCK_COPY_ACTIVE">VIR_ERR_BLOCK_COPY_ACTIVE</a></td><td> = </td><td>83</td><td><div class="comment">action prevented by block copy job</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_UNSUPPORTED" id="VIR_ERR_OPERATION_UNSUPPORTED">VIR_ERR_OPERATION_UNSUPPORTED</a></td><td> = </td><td>84</td><td><div class="comment">The requested operation is not supported</div></td></tr><tr><td><a name="VIR_ERR_SSH" id="VIR_ERR_SSH">VIR_ERR_SSH</a></td><td> = </td><td>85</td><td><div class="comment">error in ssh transport driver</div></td></tr><tr><td><a name="VIR_ERR_AGENT_UNRESPONSIVE" id="VIR_ERR_AGENT_UNRESPONSIVE">VIR_ERR_AGENT_UNRESPONSIVE</a></td><td> = </td><td>86</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" id="VIR_ERR_RESOURCE_BUSY">VIR_ERR_RESOURCE_BUSY</a></td><td> = </td><td>87</td><td><div class="comment">resource is already in use</div></td></tr><tr><td><a name="VIR_ERR_ACCESS_DENIED" id="VIR_ERR_ACCESS_DENIED">VIR_ERR_ACCESS_DENIED</a></td><td> = </td><td>88</td><td><div class="comment">operation on the object/resource was denied</div></td></tr><tr><td><a name="VIR_ERR_DBUS_SERVICE" id="VIR_ERR_DBUS_SERVICE">VIR_ERR_DBUS_SERVICE</a></td><td> = </td><td>89</td><td><div class="comment">error from a dbus service</div></td></tr><tr><td><a name="VIR_ERR_STORAGE_VOL_EXIST" id="VIR_ERR_STORAGE_VOL_EXIST">VIR_ERR_STORAGE_VOL_EXIST</a></td><td> = </td><td>90</td><td><div class="comment">the storage vol already exists</div></td></tr><tr><td><a name="VIR_ERR_CPU_INCOMPATIBLE" id="VIR_ERR_CPU_INCOMPATIBLE">VIR_ERR_CPU_INCOMPATIBLE</a></td><td> = </td><td>91</td><td><div class="comment">given CPU is incompatible with host CP</div></td></tr></table><pre>} +</pre><table><tr><td><a name="VIR_ERR_OK" id="VIR_ERR_OK">VIR_ERR_OK</a></td><td> = </td><td>0</td></tr><tr><td><a name="VIR_ERR_INTERNAL_ERROR" id="VIR_ERR_INTERNAL_ERROR">VIR_ERR_INTERNAL_ERROR</a></td><td> = </td><td>1</td><td><div class="comment">internal error</div></td></tr><tr><td><a name="VIR_ERR_NO_MEMORY" id="VIR_ERR_NO_MEMORY">VIR_ERR_NO_MEMORY</a></td><td> = </td><td>2</td><td><div class="comment">memory allocation failure</div></td></tr><tr><td><a name="VIR_ERR_NO_SUPPORT" id="VIR_ERR_NO_SUPPORT">VIR_ERR_NO_SUPPORT</a></td><td> = </td><td>3</td><td><div class="comment">no support for this function</div></td></tr><tr><td><a name="VIR_ERR_UNKNOWN_HOST" id="VIR_ERR_UNKNOWN_HOST">VIR_ERR_UNKNOWN_HOST</a></td><td> = </td><td>4</td><td><div class="comment">could not resolve hostname</div></td></tr><tr><td><a name="VIR_ERR_NO_CONNECT" id="VIR_ERR_NO_CONNECT">VIR_ERR_NO_CONNECT</a></td><td> = </td><td>5</td><td><div class="comment">can't connect to hypervisor</div></td></tr><tr><td><a name="VIR_ERR_INVALID_CONN" id="VIR_ERR_INVALID_CONN">VIR_ERR_INVALID_CONN</a></td><td> = </td><td>6</td><td><div class="comment">invalid connection object</div></td></tr><tr><td><a name="VIR_ERR_INVALID_DOMAIN" id="VIR_ERR_INVALID_DOMAIN">VIR_ERR_INVALID_DOMAIN</a></td><td> = </td><td>7</td><td><div class="comment">invalid domain object</div></td></tr><tr><td><a name="VIR_ERR_INVALID_ARG" id="VIR_ERR_INVALID_ARG">VIR_ERR_INVALID_ARG</a></td><td> = </td><td>8</td><td><div class="comment">invalid function argument</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_FAILED" id="VIR_ERR_OPERATION_FAILED">VIR_ERR_OPERATION_FAILED</a></td><td> = </td><td>9</td><td><div class="comment">a command to hypervisor failed</div></td></tr><tr><td><a name="VIR_ERR_GET_FAILED" id="VIR_ERR_GET_FAILED">VIR_ERR_GET_FAILED</a></td><td> = </td><td>10</td><td><div class="comment">a HTTP GET command to failed</div></td></tr><tr><td><a name="VIR_ERR_POST_FAILED" id="VIR_ERR_POST_FAILED">VIR_ERR_POST_FAILED</a></td><td> = </td><td>11</td><td><div class="comment">a HTTP POST command to failed</div></td></tr><tr><td><a name="VIR_ERR_HTTP_ERROR" id="VIR_ERR_HTTP_ERROR">VIR_ERR_HTTP_ERROR</a></td><td> = </td><td>12</td><td><div class="comment">unexpected HTTP error code</div></td></tr><tr><td><a name="VIR_ERR_SEXPR_SERIAL" id="VIR_ERR_SEXPR_SERIAL">VIR_ERR_SEXPR_SERIAL</a></td><td> = </td><td>13</td><td><div class="comment">failure to serialize an S-Expr</div></td></tr><tr><td><a name="VIR_ERR_NO_XEN" id="VIR_ERR_NO_XEN">VIR_ERR_NO_XEN</a></td><td> = </td><td>14</td><td><div class="comment">could not open Xen hypervisor control</div></td></tr><tr><td><a name="VIR_ERR_XEN_CALL" id="VIR_ERR_XEN_CALL">VIR_ERR_XEN_CALL</a></td><td> = </td><td>15</td><td><div class="comment">failure doing an hypervisor call</div></td></tr><tr><td><a name="VIR_ERR_OS_TYPE" id="VIR_ERR_OS_TYPE">VIR_ERR_OS_TYPE</a></td><td> = </td><td>16</td><td><div class="comment">unknown OS type</div></td></tr><tr><td><a name="VIR_ERR_NO_KERNEL" id="VIR_ERR_NO_KERNEL">VIR_ERR_NO_KERNEL</a></td><td> = </td><td>17</td><td><div class="comment">missing kernel information</div></td></tr><tr><td><a name="VIR_ERR_NO_ROOT" id="VIR_ERR_NO_ROOT">VIR_ERR_NO_ROOT</a></td><td> = </td><td>18</td><td><div class="comment">missing root device information</div></td></tr><tr><td><a name="VIR_ERR_NO_SOURCE" id="VIR_ERR_NO_SOURCE">VIR_ERR_NO_SOURCE</a></td><td> = </td><td>19</td><td><div class="comment">missing source device information</div></td></tr><tr><td><a name="VIR_ERR_NO_TARGET" id="VIR_ERR_NO_TARGET">VIR_ERR_NO_TARGET</a></td><td> = </td><td>20</td><td><div class="comment">missing target device information</div></td></tr><tr><td><a name="VIR_ERR_NO_NAME" id="VIR_ERR_NO_NAME">VIR_ERR_NO_NAME</a></td><td> = </td><td>21</td><td><div class="comment">missing domain name information</div></td></tr><tr><td><a name="VIR_ERR_NO_OS" id="VIR_ERR_NO_OS">VIR_ERR_NO_OS</a></td><td> = </td><td>22</td><td><div class="comment">missing domain OS information</div></td></tr><tr><td><a name="VIR_ERR_NO_DEVICE" id="VIR_ERR_NO_DEVICE">VIR_ERR_NO_DEVICE</a></td><td> = </td><td>23</td><td><div class="comment">missing domain devices information</div></td></tr><tr><td><a name="VIR_ERR_NO_XENSTORE" id="VIR_ERR_NO_XENSTORE">VIR_ERR_NO_XENSTORE</a></td><td> = </td><td>24</td><td><div class="comment">could not open Xen Store control</div></td></tr><tr><td><a name="VIR_ERR_DRIVER_FULL" id="VIR_ERR_DRIVER_FULL">VIR_ERR_DRIVER_FULL</a></td><td> = </td><td>25</td><td><div class="comment">too many drivers registered</div></td></tr><tr><td><a name="VIR_ERR_CALL_FAILED" id="VIR_ERR_CALL_FAILED">VIR_ERR_CALL_FAILED</a></td><td> = </td><td>26</td><td><div class="comment">not supported by the drivers (DEPRECATED)</div></td></tr><tr><td><a name="VIR_ERR_XML_ERROR" id="VIR_ERR_XML_ERROR">VIR_ERR_XML_ERROR</a></td><td> = </td><td>27</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" id="VIR_ERR_DOM_EXIST">VIR_ERR_DOM_EXIST</a></td><td> = </td><td>28</td><td><div class="comment">the domain already exist</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_DENIED" id="VIR_ERR_OPERATION_DENIED">VIR_ERR_OPERATION_DENIED</a></td><td> = </td><td>29</td><td><div class="comment">operation forbidden on read-only connections</div></td></tr><tr><td><a name="VIR_ERR_OPEN_FAILED" id="VIR_ERR_OPEN_FAILED">VIR_ERR_OPEN_FAILED</a></td><td> = </td><td>30</td><td><div class="comment">failed to open a conf file</div></td></tr><tr><td><a name="VIR_ERR_READ_FAILED" id="VIR_ERR_READ_FAILED">VIR_ERR_READ_FAILED</a></td><td> = </td><td>31</td><td><div class="comment">failed to read a conf file</div></td></tr><tr><td><a name="VIR_ERR_PARSE_FAILED" id="VIR_ERR_PARSE_FAILED">VIR_ERR_PARSE_FAILED</a></td><td> = </td><td>32</td><td><div class="comment">failed to parse a conf file</div></td></tr><tr><td><a name="VIR_ERR_CONF_SYNTAX" id="VIR_ERR_CONF_SYNTAX">VIR_ERR_CONF_SYNTAX</a></td><td> = </td><td>33</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" id="VIR_ERR_WRITE_FAILED">VIR_ERR_WRITE_FAILED</a></td><td> = </td><td>34</td><td><div class="comment">failed to write a conf file</div></td></tr><tr><td><a name="VIR_ERR_XML_DETAIL" id="VIR_ERR_XML_DETAIL">VIR_ERR_XML_DETAIL</a></td><td> = </td><td>35</td><td><div class="comment">detail of an XML error</div></td></tr><tr><td><a name="VIR_ERR_INVALID_NETWORK" id="VIR_ERR_INVALID_NETWORK">VIR_ERR_INVALID_NETWORK</a></td><td> = </td><td>36</td><td><div class="comment">invalid network object</div></td></tr><tr><td><a name="VIR_ERR_NETWORK_EXIST" id="VIR_ERR_NETWORK_EXIST">VIR_ERR_NETWORK_EXIST</a></td><td> = </td><td>37</td><td><div class="comment">the network already exist</div></td></tr><tr><td><a name="VIR_ERR_SYSTEM_ERROR" id="VIR_ERR_SYSTEM_ERROR">VIR_ERR_SYSTEM_ERROR</a></td><td> = </td><td>38</td><td><div class="comment">general system call failure</div></td></tr><tr><td><a name="VIR_ERR_RPC" id="VIR_ERR_RPC">VIR_ERR_RPC</a></td><td> = </td><td>39</td><td><div class="comment">some sort of RPC error</div></td></tr><tr><td><a name="VIR_ERR_GNUTLS_ERROR" id="VIR_ERR_GNUTLS_ERROR">VIR_ERR_GNUTLS_ERROR</a></td><td> = </td><td>40</td><td><div class="comment">error from a GNUTLS call</div></td></tr><tr><td><a name="VIR_WAR_NO_NETWORK" id="VIR_WAR_NO_NETWORK">VIR_WAR_NO_NETWORK</a></td><td> = </td><td>41</td><td><div class="comment">failed to start network</div></td></tr><tr><td><a name="VIR_ERR_NO_DOMAIN" id="VIR_ERR_NO_DOMAIN">VIR_ERR_NO_DOMAIN</a></td><td> = </td><td>42</td><td><div class="comment">domain not found or unexpectedly disappeared</div></td></tr><tr><td><a name="VIR_ERR_NO_NETWORK" id="VIR_ERR_NO_NETWORK">VIR_ERR_NO_NETWORK</a></td><td> = </td><td>43</td><td><div class="comment">network not found</div></td></tr><tr><td><a name="VIR_ERR_INVALID_MAC" id="VIR_ERR_INVALID_MAC">VIR_ERR_INVALID_MAC</a></td><td> = </td><td>44</td><td><div class="comment">invalid MAC address</div></td></tr><tr><td><a name="VIR_ERR_AUTH_FAILED" id="VIR_ERR_AUTH_FAILED">VIR_ERR_AUTH_FAILED</a></td><td> = </td><td>45</td><td><div class="comment">authentication failed</div></td></tr><tr><td><a name="VIR_ERR_INVALID_STORAGE_POOL" id="VIR_ERR_INVALID_STORAGE_POOL">VIR_ERR_INVALID_STORAGE_POOL</a></td><td> = </td><td>46</td><td><div class="comment">invalid storage pool object</div></td></tr><tr><td><a name="VIR_ERR_INVALID_STORAGE_VOL" id="VIR_ERR_INVALID_STORAGE_VOL">VIR_ERR_INVALID_STORAGE_VOL</a></td><td> = </td><td>47</td><td><div class="comment">invalid storage vol object</div></td></tr><tr><td><a name="VIR_WAR_NO_STORAGE" id="VIR_WAR_NO_STORAGE">VIR_WAR_NO_STORAGE</a></td><td> = </td><td>48</td><td><div class="comment">failed to start storage</div></td></tr><tr><td><a name="VIR_ERR_NO_STORAGE_POOL" id="VIR_ERR_NO_STORAGE_POOL">VIR_ERR_NO_STORAGE_POOL</a></td><td> = </td><td>49</td><td><div class="comment">storage pool not found</div></td></tr><tr><td><a name="VIR_ERR_NO_STORAGE_VOL" id="VIR_ERR_NO_STORAGE_VOL">VIR_ERR_NO_STORAGE_VOL</a></td><td> = </td><td>50</td><td><div class="comment">storage volume not found</div></td></tr><tr><td><a name="VIR_WAR_NO_NODE" id="VIR_WAR_NO_NODE">VIR_WAR_NO_NODE</a></td><td> = </td><td>51</td><td><div class="comment">failed to start node driver</div></td></tr><tr><td><a name="VIR_ERR_INVALID_NODE_DEVICE" id="VIR_ERR_INVALID_NODE_DEVICE">VIR_ERR_INVALID_NODE_DEVICE</a></td><td> = </td><td>52</td><td><div class="comment">invalid node device object</div></td></tr><tr><td><a name="VIR_ERR_NO_NODE_DEVICE" id="VIR_ERR_NO_NODE_DEVICE">VIR_ERR_NO_NODE_DEVICE</a></td><td> = </td><td>53</td><td><div class="comment">node device not found</div></td></tr><tr><td><a name="VIR_ERR_NO_SECURITY_MODEL" id="VIR_ERR_NO_SECURITY_MODEL">VIR_ERR_NO_SECURITY_MODEL</a></td><td> = </td><td>54</td><td><div class="comment">security model not found</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_INVALID" id="VIR_ERR_OPERATION_INVALID">VIR_ERR_OPERATION_INVALID</a></td><td> = </td><td>55</td><td><div class="comment">operation is not applicable at this time</div></td></tr><tr><td><a name="VIR_WAR_NO_INTERFACE" id="VIR_WAR_NO_INTERFACE">VIR_WAR_NO_INTERFACE</a></td><td> = </td><td>56</td><td><div class="comment">failed to start interface driver</div></td></tr><tr><td><a name="VIR_ERR_NO_INTERFACE" id="VIR_ERR_NO_INTERFACE">VIR_ERR_NO_INTERFACE</a></td><td> = </td><td>57</td><td><div class="comment">interface driver not running</div></td></tr><tr><td><a name="VIR_ERR_INVALID_INTERFACE" id="VIR_ERR_INVALID_INTERFACE">VIR_ERR_INVALID_INTERFACE</a></td><td> = </td><td>58</td><td><div class="comment">invalid interface object</div></td></tr><tr><td><a name="VIR_ERR_MULTIPLE_INTERFACES" id="VIR_ERR_MULTIPLE_INTERFACES">VIR_ERR_MULTIPLE_INTERFACES</a></td><td> = </td><td>59</td><td><div class="comment">more than one matching interface found</div></td></tr><tr><td><a name="VIR_WAR_NO_NWFILTER" id="VIR_WAR_NO_NWFILTER">VIR_WAR_NO_NWFILTER</a></td><td> = </td><td>60</td><td><div class="comment">failed to start nwfilter driver</div></td></tr><tr><td><a name="VIR_ERR_INVALID_NWFILTER" id="VIR_ERR_INVALID_NWFILTER">VIR_ERR_INVALID_NWFILTER</a></td><td> = </td><td>61</td><td><div class="comment">invalid nwfilter object</div></td></tr><tr><td><a name="VIR_ERR_NO_NWFILTER" id="VIR_ERR_NO_NWFILTER">VIR_ERR_NO_NWFILTER</a></td><td> = </td><td>62</td><td><div class="comment">nw filter pool not found</div></td></tr><tr><td><a name="VIR_ERR_BUILD_FIREWALL" id="VIR_ERR_BUILD_FIREWALL">VIR_ERR_BUILD_FIREWALL</a></td><td> = </td><td>63</td><td><div class="comment">nw filter pool not found</div></td></tr><tr><td><a name="VIR_WAR_NO_SECRET" id="VIR_WAR_NO_SECRET">VIR_WAR_NO_SECRET</a></td><td> = </td><td>64</td><td><div class="comment">failed to start secret storage</div></td></tr><tr><td><a name="VIR_ERR_INVALID_SECRET" id="VIR_ERR_INVALID_SECRET">VIR_ERR_INVALID_SECRET</a></td><td> = </td><td>65</td><td><div class="comment">invalid secret</div></td></tr><tr><td><a name="VIR_ERR_NO_SECRET" id="VIR_ERR_NO_SECRET">VIR_ERR_NO_SECRET</a></td><td> = </td><td>66</td><td><div class="comment">secret not found</div></td></tr><tr><td><a name="VIR_ERR_CONFIG_UNSUPPORTED" id="VIR_ERR_CONFIG_UNSUPPORTED">VIR_ERR_CONFIG_UNSUPPORTED</a></td><td> = </td><td>67</td><td><div class="comment">unsupported configuration construct</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_TIMEOUT" id="VIR_ERR_OPERATION_TIMEOUT">VIR_ERR_OPERATION_TIMEOUT</a></td><td> = </td><td>68</td><td><div class="comment">timeout occurred during operation</div></td></tr><tr><td><a name="VIR_ERR_MIGRATE_PERSIST_FAILED" id="VIR_ERR_MIGRATE_PERSIST_FAILED">VIR_ERR_MIGRATE_PERSIST_FAILED</a></td><td> = </td><td>69</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" id="VIR_ERR_HOOK_SCRIPT_FAILED">VIR_ERR_HOOK_SCRIPT_FAILED</a></td><td> = </td><td>70</td><td><div class="comment">a synchronous hook script failed</div></td></tr><tr><td><a name="VIR_ERR_INVALID_DOMAIN_SNAPSHOT" id="VIR_ERR_INVALID_DOMAIN_SNAPSHOT">VIR_ERR_INVALID_DOMAIN_SNAPSHOT</a></td><td> = </td><td>71</td><td><div class="comment">invalid domain snapshot</div></td></tr><tr><td><a name="VIR_ERR_NO_DOMAIN_SNAPSHOT" id="VIR_ERR_NO_DOMAIN_SNAPSHOT">VIR_ERR_NO_DOMAIN_SNAPSHOT</a></td><td> = </td><td>72</td><td><div class="comment">domain snapshot not found</div></td></tr><tr><td><a name="VIR_ERR_INVALID_STREAM" id="VIR_ERR_INVALID_STREAM">VIR_ERR_INVALID_STREAM</a></td><td> = </td><td>73</td><td><div class="comment">stream pointer not valid</div></td></tr><tr><td><a name="VIR_ERR_ARGUMENT_UNSUPPORTED" id="VIR_ERR_ARGUMENT_UNSUPPORTED">VIR_ERR_ARGUMENT_UNSUPPORTED</a></td><td> = </td><td>74</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" id="VIR_ERR_STORAGE_PROBE_FAILED">VIR_ERR_STORAGE_PROBE_FAILED</a></td><td> = </td><td>75</td><td><div class="comment">storage pool probe failed</div></td></tr><tr><td><a name="VIR_ERR_STORAGE_POOL_BUILT" id="VIR_ERR_STORAGE_POOL_BUILT">VIR_ERR_STORAGE_POOL_BUILT</a></td><td> = </td><td>76</td><td><div class="comment">storage pool already built</div></td></tr><tr><td><a name="VIR_ERR_SNAPSHOT_REVERT_RISKY" id="VIR_ERR_SNAPSHOT_REVERT_RISKY">VIR_ERR_SNAPSHOT_REVERT_RISKY</a></td><td> = </td><td>77</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" id="VIR_ERR_OPERATION_ABORTED">VIR_ERR_OPERATION_ABORTED</a></td><td> = </td><td>78</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" id="VIR_ERR_AUTH_CANCELLED">VIR_ERR_AUTH_CANCELLED</a></td><td> = </td><td>79</td><td><div class="comment">authentication cancelled</div></td></tr><tr><td><a name="VIR_ERR_NO_DOMAIN_METADATA" id="VIR_ERR_NO_DOMAIN_METADATA">VIR_ERR_NO_DOMAIN_METADATA</a></td><td> = </td><td>80</td><td><div class="comment">The metadata is not present</div></td></tr><tr><td><a name="VIR_ERR_MIGRATE_UNSAFE" id="VIR_ERR_MIGRATE_UNSAFE">VIR_ERR_MIGRATE_UNSAFE</a></td><td> = </td><td>81</td><td><div class="comment">Migration is not safe</div></td></tr><tr><td><a name="VIR_ERR_OVERFLOW" id="VIR_ERR_OVERFLOW">VIR_ERR_OVERFLOW</a></td><td> = </td><td>82</td><td><div class="comment">integer overflow</div></td></tr><tr><td><a name="VIR_ERR_BLOCK_COPY_ACTIVE" id="VIR_ERR_BLOCK_COPY_ACTIVE">VIR_ERR_BLOCK_COPY_ACTIVE</a></td><td> = </td><td>83</td><td><div class="comment">action prevented by block copy job</div></td></tr><tr><td><a name="VIR_ERR_OPERATION_UNSUPPORTED" id="VIR_ERR_OPERATION_UNSUPPORTED">VIR_ERR_OPERATION_UNSUPPORTED</a></td><td> = </td><td>84</td><td><div class="comment">The requested operation is not supported</div></td></tr><tr><td><a name="VIR_ERR_SSH" id="VIR_ERR_SSH">VIR_ERR_SSH</a></td><td> = </td><td>85</td><td><div class="comment">error in ssh transport driver</div></td></tr><tr><td><a name="VIR_ERR_AGENT_UNRESPONSIVE" id="VIR_ERR_AGENT_UNRESPONSIVE">VIR_ERR_AGENT_UNRESPONSIVE</a></td><td> = </td><td>86</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" id="VIR_ERR_RESOURCE_BUSY">VIR_ERR_RESOURCE_BUSY</a></td><td> = </td><td>87</td><td><div class="comment">resource is already in use</div></td></tr><tr><td><a name="VIR_ERR_ACCESS_DENIED" id="VIR_ERR_ACCESS_DENIED">VIR_ERR_ACCESS_DENIED</a></td><td> = </td><td>88</td><td><div class="comment">operation on the object/resource was denied</div></td></tr><tr><td><a name="VIR_ERR_DBUS_SERVICE" id="VIR_ERR_DBUS_SERVICE">VIR_ERR_DBUS_SERVICE</a></td><td> = </td><td>89</td><td><div class="comment">error from a dbus service</div></td></tr><tr><td><a name="VIR_ERR_STORAGE_VOL_EXIST" id="VIR_ERR_STORAGE_VOL_EXIST">VIR_ERR_STORAGE_VOL_EXIST</a></td><td> = </td><td>90</td><td><div class="comment">the storage vol already exists</div></td></tr><tr><td><a name="VIR_ERR_CPU_INCOMPATIBLE" id="VIR_ERR_CPU_INCOMPATIBLE">VIR_ERR_CPU_INCOMPATIBLE</a></td><td> = </td><td>91</td><td><div class="comment">given CPU is incompatible with host CP</div></td></tr><tr><td><a name="VIR_ERR_XML_INVALID_SCHEMA" id="VIR_ERR_XML_INVALID_SCHEMA">VIR_ERR_XML_INVALID_SCHEMA</a></td><td> = </td><td>92</td><td><div class="comment">XML document doens't validate against schema</div></td></tr></table><pre>} </pre></div><h3><a name="functions" id="functions">Functions</a><a class="headerlink" href="#functions" title="Permalink to this headline">¶</a></h3><h3><a name="virConnCopyLastError" id="virConnCopyLastError"><code>virConnCopyLastError</code></a><a class="headerlink" href="#virConnCopyLastError" title="Permalink to this headline">¶</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"></div><h3><a name="virConnGetLastError" id="virConnGetLastError"><code>virConnGetLastError</code></a><a class="headerlink" href="#virConnGetLastError" title="Permalink to this headline">¶</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"></div><h3><a name="virConnResetLastError" id="virConnResetLastError"><code>virConnResetLastError</code></a><a class="headerlink" href="#virConnResetLastError" title="Permalink to this headline">¶</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"></div><h3><a name="virConnSetErrorFunc" id="virConnSetErrorFunc"><code>virConnSetErrorFunc</code></a><a class="headerlink" href="#virConnSetErrorFunc" title="Permalink to this headline">¶</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, diff --git a/docs/schemas/basictypes.rng b/docs/schemas/basictypes.rng index efc9da416..2bc9c1be2 100644 --- a/docs/schemas/basictypes.rng +++ b/docs/schemas/basictypes.rng @@ -14,6 +14,12 @@ </data> </define> + <define name='hexuint'> + <data type='string'> + <param name="pattern">(0x)?[0-9a-f]+</param> + </data> + </define> + <define name="positiveInteger"> <data type="positiveInteger"> <param name="pattern">[0-9]+</param> diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng index c428ddf4f..9d6c1ee2b 100644 --- a/docs/schemas/domaincommon.rng +++ b/docs/schemas/domaincommon.rng @@ -2207,6 +2207,16 @@ <empty/> </element> </optional> + <optional> + <element name="model"> + <attribute name="type"> + <data type="string"> + <param name='pattern'>[a-zA-Z0-9\-_]+</param> + </data> + </attribute> + <empty/> + </element> + </optional> </interleave> </group> <group> diff --git a/docs/schemas/nodedev.rng b/docs/schemas/nodedev.rng index c4f402c39..13c540221 100644 --- a/docs/schemas/nodedev.rng +++ b/docs/schemas/nodedev.rng @@ -467,12 +467,6 @@ </element> </define> - <define name='hexuint'> - <data type='string'> - <param name="pattern">(0x)?[0-9a-f]+</param> - </data> - </define> - <define name='mac'> <data type='string'> <param name="pattern">([a-fA-F0-9]{2}:){5}[a-fA-F0-9]{2}</param> |