| Server IP : 184.154.167.98 / Your IP : 3.147.89.48 Web Server : Apache System : Linux pink.dnsnetservice.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 User : puertode ( 1767) PHP Version : 8.2.27 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /lib64/python3.6/site-packages/__pycache__/ |
Upload File : |
3
�rkcf� � # @ s� y d dl Z W nb ek
rn Z zFy d dlZ W n2 ek
r\ Z zdee�krLe�W Y ddZ[X nX W Y ddZ[X nX d dlmZ d dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ ed�Ze
eeeegdf Ze
eeeegef Ze
eegdf Ze
egef Ze
eegdf Ze
eeegef Ze
eegdf Ze
egef Z e
ddeeege
e f Z e ee f Z e ee f Z e ee f Z e ee f Z!G dd � d e"�Z#e
ee gdf eed
�d d �Z$�d�ee edd
�dd�Z%�d�e
e ed�dd�Z&e�d�eeeeeef ddd�dd��Z'e�d�eeeeedd�dd��Z'�d�eeeeeeef ef e
e dd�dd�Z'�d�eeeeef ef e
e dd�dd�Z(eeee ee f ed�d d �Z)ee ee f ed �d d �Z*eeeeed!�d"d#�Z+eeeed$�d%d&�Z,e dd'�d(d)�Z-�d�d*d+�Z.�d�d,d-�Z/d.d/� Z0d0d1� Z1d2d3� Z2d4d5� Z3d6d7� Z4d8d9� Z5d:d;� Z6d<d=� Z7d>d?� Z8d@dA� Z9dBdC� Z:dDdE� Z;dFdG� Z<G dHd� de=�Z>G dIdJ� dJe=�Z?G dKdL� dLe=�Z@G dMdN� dNe=�ZAG dOdP� dPe=�ZBG dQdR� dRe=�ZCG dSd� de=�ZDG dTdU� dUe=�ZEG dVdW� dWe=�ZFG dXdY� dYe=�ZGG dZd[� d[e=�ZHG d\d]� d]e=�ZIG d^d_� d_e=�ZJG d`da� dae=�ZKdbZLdcZMddZNdeZOdfZPdgZQ�d�ZRd ZSdbZTdcZUdbZVdcZWd ZXdbZYdcZZddZ[dbZ\dcZ]dbZ^dcZ_ddZ`deZadfZbdgZcdhZddiZedjZfd ZgdbZhdcZidbZjdcZkd ZldbZmdcZnddZod ZpdbZqdbZrdcZsdbZtdcZudeZvdiZwdkZxdlZydmZzdnZ{doZ|dpZ}dqZ~dbZdcZ�deZ�diZ�dkZ�dlZ�dmZ�dnZ�drZ�dsZ�dtZ�duZ�dvZ�dwZ�dxZ�dyZ�dbZ�dcZ�dbZ�dcZ�deZ�diZ�dkZ�dlZ�dbZ�dcZ�deZ�diZ�dkZ�dlZ�dmZ�dnZ�drZ�dsZ�dtZ�duZ�dvZ�dwZ�dxZ�dyZ�dzZ�d{Z�d|Z�d}Z�d~Z�dZ�dpZ�dqZ�dbZ�dcZ�deZ�diZ�dbZ�dcZ�deZ�diZ�dkZ�dlZ�dmZ�dnZ�drZ�dsZ�dtZ�duZ�dvZ�dwZ�dxZ�dyZ�dzZ�d{Z�d|Z�d}ZƐd�Zǐd�Z�d Z�dbZ�dcZ�dbZ�dbZ�dcZ�deZ�diZ�dkZ�dbZ�dcZ�deZ�diZ�dbZ�dcZ�dbZ�dbZ�d Z�dbZ�dcZ�ddZ�deZ�dfZ�dmZ�dbZ�dcZ�deZ�diZ�dkZ�dlZ�dmZ�dbZ�d Z�dbZ�dbZ�dcZ�deZ�dbZ�dcZ�deZ�dbZ�dbZ�dcZ�deZ�diZ�dbZ�dcZ�deZ�dbZ�dcZ�d Z�dbZ�dcZ�ddZ�d Z�db�Z dc�Zdd�Zdb�Zdc�Zde�Zdi�Zdk�Zd �Zdb�Z dc�Z
dd�Z de�Z d �Z
db�Zd �Zdb�Zdc�Zde�Zdi�Zdk�Zdb�Zd �Zdb�Zd �Zdb�Zdc�Zde�Zd �Z db�Z dc�Z d �Z db�Z dc�Z!d �Z"db�Z#d �Z$db�Z%dc�Z&dd�Z'd �Z(db�Z)dc�Z*d �Z+db�Z,dc�Z-d �Z.db�Z/dc�Z0dd�Z1de�Z2df�Z3dg�Z4dh�Z5di�Z6dj�Z7d��Z8d��Z9d��Z:d��Z;d��Z<d��Z=dk�Z>d��Z?d��Z@d��ZAd��ZBd��ZCd��ZDd��ZEd��ZFd��ZGd��ZHd �ZIdb�ZJdc�ZKd �ZLdb�ZMd �ZNdb�ZOdc�ZPdd�ZQd �ZRdb�ZSdc�ZTd �ZUdb�ZVdc�ZWdd�ZXde�ZYd �ZZdb�Z[dc�Z\dd�Z]de�Z^df�Z_dg�Z`d �Zadb�Zbdc�Zcdd�Zdde�Zedf�Zfdg�Zgdh�Zhdi�Zid �Zjdb�Zkd �Zldb�Zmdc�Zndd�Zode�Zpdf�Zqdg�Zrdh�Zsdi�Ztd �Zudb�Zvd �Zwdb�Zxdc�Zydd�Zzde�Z{df�Z|dg�Z}db�Z~dc�Zdb�Z�dc�Z�db�Z�dc�Z�de�Z�di�Z�dk�Z�dl�Z�dm�Z�d �Z�db�Z�dc�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�d �Z�db�Z�dc�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�d �Z�db�Z�dc�Z�dd�Z�db�Z�dc�Z�d �Z�db�Z�db�Z�dc�Z�d �Z�db�Z�dc�Z�de�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d��Z�d��Z�d��Z�d��Z�d��Z�db�Z�dc�Z�d �Z�db�Z�dc�Z�db�Z�dc�Z�de�Z�di�Z�dk�Z�dl�Z�dm�Z�dn�Z�dr�Z�ds�Z�dt�Z�du�Z�dv�Z�dw�Z�dx�Z�dy�Z�dz�Z�d{�Z�d|�Z�d~�Z�db�Z�d �Z�db�Z�dc�Z�d �Z�d �Z�db�Z�dc�Z�dd�Z�db�Z�d �Z�d �Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d��Z�d��Z�d��Z�d��Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d��Z�d��Z d��Zd��Zd��Zd��Zdk�Zd��Zd��Zd��Zd��Z d��Z
d��Z d��Z d��Z
d��Zd��Zd��Zd��Zd��Zd��Zd��Zdl�Zd��Zd��Zd��Zd��Zd��Zd��Zd��Z d��Z d��Z d��Z d��Z d��Z!d��Z"d��Z#d��Z$d��Z%d��Z&d��Z'd��Z(d��Z)d��Z*d��Z+d��Z,d��Z-d��Z.d��Z/d��Z0d��Z1d��Z2d��Z3d��Z4dm�Z5d �Z6db�Z7dc�Z8de�Z9di�Z:dk�Z;d �Z<db�Z=dc�Z>dd�Z?de�Z@df�ZAdg�ZBdh�ZCdi�ZDdj�ZEd��ZFdb�ZGdb�ZHdc�ZIde�ZJdb�ZKdb�ZLd �ZMdb�ZNdc�ZOde�ZPdi�ZQdk�ZRd �ZSdb�ZTd �ZUdb�ZVdc�ZWdd�ZXde�ZYdf�ZZdg�Z[dh�Z\di�Z]db�Z^dc�Z_de�Z`di�Zadk�Zbdl�Zcdm�Zddn�Zedr�Zfds�Zgdb�Zhdc�Zide�Zjdb�Zkdb�Zldc�Zmde�Zndi�Zodk�Zpdl�Zqdm�Zrdn�Zsdr�Ztds�Zudt�Zvdb�Zwdc�Zxde�Zydb�Zzd �Z{db�Z|dc�Z}dd�Z~de�Zdf�Z�dg�Z�dh�Z�db�Z�dc�Z�de�Z�di�Z�dk�Z�dl�Z�dm�Z�dn�Z�dr�Z�ds�Z�db�Z�dc�Z�de�Z�di�Z�dk�Z�d �Z�db�Z�dc�Z�de�Z�di�Z�dk�Z�db�Z�dc�Z�de�Z�di�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�dk�Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�dl�Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�dm�Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d �Z�db�Z�dc�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�dk�Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z�d��Z d��Zd��Zd��Zd��Zd��Zd��Zd��Zdl�Zd��Z d��Z
d��Z d��Z d��Z
d��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Zd��Z d��Z d��Z d��Z d��Z d��Z!d��Z"d��Z#d��Z$d��Z%d��Z&d��Z'dm�Z(d��Z)d��Z*d��Z+d��Z,d��Z-d��Z.d��Z/d��Z0d��Z1d��Z2d��Z3d��Z4d��Z5d��Z6dZ7dÐZ8dĐZ9dŐZ:dƐZ;dǐZ<dȐZ=dɐZ>dʐZ?dːZ@d̐ZAd͐ZBdΐZCdϐZDdАZEdѐZFdҐZGdӐZHdԐZIdՐZJdZKdאZLdؐZMdِZNdڐZOdېZPdܐZQdݐZRdސZSdߐZTd�ZUd�ZVdb�ZWdc�ZXde�ZYdi�ZZd �Z[db�Z\db�Z]db�Z^d �Z_db�Z`dc�Zadd�Zbde�Zcdf�Zddg�Zedh�Zfdi�Zgdj�Zhdb�Zidc�Zjdd�Zkde�Zldf�Zmdg�Zndb�Zodb�Zpdb�Zqdb�Zrd �Zsd �Ztdb�Zudc�Zvdd�Zwdb�Zxdc�Zyd �Zzdb�Z{dc�Z|dd�Z}de�Z~d �Zdb�Z�dc�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�d��Z�d��Z�d��Z�db�Z�d �Z�db�Z�d �Z�db�Z�d �Z�db�Z�dc�Z�dd�Z��dʐZ��dːZ�d �Z�db�Z�dc�Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�db�Z�d �Z�db�Z�d �Z�db�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�d �Z�db�Z�dc�Z�de�Z�di�Z�d �Z�db�Z�dc�Z�de�Z�db�Z�d �Z�db�Z�d �Z�db�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�db�Z�dc�Z�d �Z�db�Z�dc�Z�db�Z�d �Z�db�Z�db�Z�dc�Z�de�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�db�Z�d �Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�di�Z�dj�Z�db�Z�db�Z�dc�Z�de�Z�di�Z�db�Z�db�Z�de�Z�db�Z�dc�Z�dd�Z�de�Z�df�Z�dg�Z�dh�Z�d̐Z�d͐Z�d �Z�db�Z�dc�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z d�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Z d��Z
d��Z d��Z d��Z
d��Zd��Zd��Zd��Zd��Zd��Zd��Z�d �Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z �d�Z �d �Z �d
�Z �d �Z �d �Z!�d
�Z"�d�Z#�d�Z$�d�Z%�d�Z&�d�Z'�d�Z(�d�Z)�d�Z*�d�Z+�d�Z,�d�Z-�d�Z.�d�Z/�d�Z0�d �Z1�d �Z2�d �Z3�d �Z4�d �Z5�d!�Z6�d"�Z7�d#�Z8�d$�Z9�d%�Z:�d&�Z;�d'�Z<�d(�Z=�d)�Z>�d*�Z?�d+�Z@�d,�ZA�d-�ZB�d.�ZC�d/�ZD�d0�ZE�d1�ZF�d2�ZG�d3�ZH�d4�ZI�d5�ZJ�d6�ZK�d7�ZL�d8�ZM�d9�ZN�d:�ZO�d;�ZP�d<�ZQ�d=�ZR�d>�ZS�d?�ZT�d@�ZU�dA�ZV�dB�ZW�dC�ZX�dD�ZY�dE�ZZ�dF�Z[�dG�Z\�dH�Z]�dI�Z^�dJ�Z_�dK�Z`�dL�Za�dM�Zb�dN�Zc�dO�Zd�dP�Ze�dQ�Zf�dR�Zg�dS�Zh�dT�Zi�dU�Zj�dV�Zk�dW�Zl�dX�Zm�dY�Zn�dZ�Zo�d[�Zp�d\�Zqd��Zr�d]�Zs�d^�Zt�d_�Zu�d`�Zv�da�Zw�db�Zx�dc�Zy�dd�Zz�de�Z{�df�Z|�dg�Z}�dh�Z~�di�Z�dj�Z��dk�Z��dl�Z��dm�Z��dn�Z��do�Z��dp�Z��dq�Z��dr�Z��ds�Z��dt�Z��du�Z��dv�Z��dw�Z��dx�Z��dy�Z��dz�Z��d{�Z��d|�Z��d}�Z��d~�Z��d�Z�d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z�d�Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Z��d��Zd��ZÐd��ZĐd��ZŐd��ZƐd��Zǐd��ZȐd��Zɐd��Zʐd��Zːd��Z̐d��Z͐d��Zΐd��Zϐd��ZАd��Zѐd��ZҐd��ZӐd��ZԐd��ZՐd��Zd��Zאd��Zؐd��Zِd��Zڐd��Zېd��Z�dS (� � NzNo module named)�
TracebackType)
�Any�Callable�Dict�List�Optional�overload�Tuple�Type�TypeVar�Union�_T�
virConnect� virDomainc @ s� e Zd Zedd�dd�Zee d�dd�Zee d�dd �Zee d�d
d �Z ee d�d d
�Z
ee d�dd�Z ee d�dd�Z ee d�dd�Z
ee d�dd�Zee d�dd�ZdS )� libvirtErrorN)�defmsg�returnc C s4 t j� }|d kr|}n|d }tj| |� || _d S )N� )�
libvirtmod�virGetLastError� Exception�__init__�err)�selfr r �msg� r � /usr/lib64/python3.6/libvirt.pyr . s zlibvirtError.__init__)r c C s | j d krd S | j d S )Nr )r )r r r r �get_error_code< s
zlibvirtError.get_error_codec C s | j d krd S | j d S )N� )r )r r r r �get_error_domainA s
z libvirtError.get_error_domainc C s | j d krd S | j d S )Nr )r )r r r r �get_error_messageF s
z libvirtError.get_error_messagec C s | j d krd S | j d S )N� )r )r r r r �get_error_levelK s
z libvirtError.get_error_levelc C s | j d krd S | j d S )N� )r )r r r r �get_str1P s
zlibvirtError.get_str1c C s | j d krd S | j d S )N� )r )r r r r �get_str2U s
zlibvirtError.get_str2c C s | j d krd S | j d S )N� )r )r r r r �get_str3Z s
zlibvirtError.get_str3c C s | j d krd S | j d S )N� )r )r r r r �get_int1_ s
zlibvirtError.get_int1c C s | j d krd S | j d S )N� )r )r r r r �get_int2d s
zlibvirtError.get_int2)�__name__�
__module__� __qualname__�strr r �intr r r r" r$ r& r( r* r, r r r r r - s r )�f�ctxr c C s t j| |�S )z�Register a Python function for error reporting.
The function is called back as f(ctx, error), with error
being a list of information about the error being raised.
Returns 1 in case of success.)r ZvirRegisterErrorHandler)r2 r3 r r r �registerErrorHandlerm s r4 )�uri�auth�flagsr c C s( t j| ||�}|dkr td��t|d�S )a�
This function should be called first to get a connection to the
Hypervisor. If necessary, authentication will be performed fetching
credentials via the callback.
See :py:func:`open` for notes about environment variables which can
have an effect on opening drivers and freeing the connection resources.
:param str uri: (Optional) connection URI, see https://libvirt.org/uri.html
:param auth: a list that contains 3 items:
- a list of supported credential types
- a callable that takes 2 arguments (credentials, user-data) and returns 0 on succcess and -1 on errors.
The credentials argument is a list of credentials that libvirt (actually
the ESX driver) would like to request. An element of this list is itself a
list containing 5 items (4 inputs, 1 output):
- the credential type, e.g. :py:const:`libvirt.VIR_CRED_AUTHNAME`
- a prompt to be displayed to the user
- a challenge, the ESX driver sets this to the hostname to allow automatic
distinction between requests for ESX and vCenter credentials
- a default result for the request
- a place to store the actual result for the request
- user data that will be passed to the callable as second argument
:param int flags: bitwise-OR of virConnectFlags
:returns: a :py:class:`virConnect` instance on success.
:raises libvirtError: on errors.
NzvirConnectOpenAuth() failed)�_obj)r ZvirConnectOpenAuthr r )r5 r6 r7 �retr r r �openAuthu s r: )�namer c C s0 | dkrt j� }n
t j| �}|dkr,td��|S )a� If no name parameter is passed (or name is None) then the
version of the libvirt library is returned as an integer.
If a name is passed and it refers to a driver linked to the
libvirt library, then this returns a tuple of (library version,
driver version).
If the name passed refers to a non-existent driver, then you
will get the exception 'no support for hypervisor'.
Versions numbers are integers: 1000000*major + 1000*minor + release.NzvirGetVersion() failed)r Z
virGetVersionr )r; r9 r r r �
getVersion� s
r< )�watch�fd�event�opaque� opaquecompatr c C s d S )Nr )r= r> r? r@ rA r r r �_eventInvokeHandleCallback� s rB c C s d S )Nr )r= r> r? r@ rA r r r rB � s c C s4 |r|}|}n|d }|d }t j| ||||� dS )z4
Invoke the Event Impl Handle Callback in C
r r N)r Z virEventInvokeHandleCallback)r= r> r? r@ rA �callback�opaque_r r r rB � s )�timerr@ rA r c C s0 |r|}|}n|d }|d }t j| ||� dS )z5
Invoke the Event Impl Timeout Callback in C
r r N)r Z virEventInvokeTimeoutCallback)rE r@ rA rC rD r r r �_eventInvokeTimeoutCallback� s rF )r= r> �events�cbDatar c C s" |d }|d }|| |||� dS )N�cbr@ r r )r= r> rG rH rI r@ r r r � _dispatchEventHandleCallback� s rJ )rE rH r c C s |d }|d }|| |� dS )NrI r@ r r )rE rH rI r@ r r r � _dispatchEventTimeoutCallback� s
rK )r> rG rI r@ r c C s, ||d�}t j| ||�}|dkr(td��|S )a(
register a callback for monitoring file handle events
@fd: file handle to monitor for events
@events: bitset of events to watch from virEventHandleType constants
@cb: callback to invoke when an event occurs
@opaque: user data to pass to callback
Example callback prototype is:
def cb(watch, # int id of the handle
fd, # int file descriptor the event occurred on
events, # int bitmap of events that have occurred
opaque): # opaque data passed to eventAddHandle
)rI r@ r zvirEventAddHandle() failed���)r �virEventAddHandler )r> rG rI r@ rH r9 r r r rM � s
rM )�timeoutrI r@ r c C s* ||d�}t j| |�}|dkr&td��|S )a�
register a callback for a timer event
@timeout: time between events in milliseconds
@cb: callback to invoke when an event occurs
@opaque: user data to pass to callback
Setting timeout to -1 will disable the timer. Setting the timeout
to zero will cause it to fire on every event loop iteration.
Example callback prototype is:
def cb(timer, # int id of the timer
opaque): # opaque data passed to eventAddTimeout
)rI r@ r zvirEventAddTimeout() failedrL )r �virEventAddTimeoutr )rN rI r@ rH r9 r r r rO s
rO )r@ r c C s t j| d | d � dS )a
Execute callback which frees the opaque buffer
@opaque: the opaque object passed to addHandle or addTimeout
WARNING: This function should not be called from any call by libvirt's
core. It will most probably cause deadlock in C-level libvirt code.
Instead it should be scheduled and called from implementation's stack.
See https://libvirt.org/html/libvirt-libvirt-event.html#virEventAddHandleFunc
for more information.
This function is not dependent on any event loop implementation.
r r N)r �virEventInvokeFreeCallback)r@ r r r rP s rP c C s$ t j| �}|dkrtd��t|d�S )a� This function should be called first to get a connection to the
Hypervisor and xen store
If @name is None, if the LIBVIRT_DEFAULT_URI environment variable is set,
then it will be used. Otherwise if the client configuration file
has the "uri_default" parameter set, then it will be used. Finally
probing will be done to determine a suitable default driver to activate.
This involves trying each hypervisor in turn until one successfully opens.
If connecting to an unprivileged hypervisor driver which requires
the libvirtd daemon to be active, it will automatically be launched
if not already running. This can be prevented by setting the
environment variable LIBVIRT_AUTOSTART=0
URIs are documented at https://libvirt.org/uri.html
virConnectClose should be used to release the resources after the connection
is no longer needed. NzvirConnectOpen() failed)r8 )r ZvirConnectOpenr r )r; r9 r r r �open; s
rQ c C s$ t j| �}|dkrtd��t|d�S )a� This function should be called first to get a restricted connection to the
library functionalities. The set of APIs usable are then restricted
on the available methods to control the domains.
See virConnectOpen for notes about environment variables which can
have an effect on opening drivers and freeing the connection resources
URIs are documented at https://libvirt.org/uri.html Nz virConnectOpenReadOnly() failed)r8 )r ZvirConnectOpenReadOnlyr r )r; r9 r r r � openReadOnlyS s
rR c C s t j� } | dkrtd��| S )a0 Registers a default event implementation based on the
poll() system call. This is a generic implementation
that can be used by any client application which does
not have a need to integrate with an external event
loop impl.
For proper event handling, it is important that the event implementation
is registered before a connection to the Hypervisor is opened.
Once registered, the application has to invoke virEventRunDefaultImpl() in
a loop to process events. Failure to do so may result in connections being
closed unexpectedly as a result of keepalive timeout. The default
event loop fully supports handle and timeout events, but only
wakes up on events registered by libvirt API calls such as
virEventAddHandle() or virConnectDomainEventRegisterAny(). r z$virEventRegisterDefaultImpl() failedrL )r �virEventRegisterDefaultImplr )r9 r r r rS e s rS c C s t j| |||||� dS )a� Registers an event implementation, to allow integration
with an external event loop. Applications would use this
to integrate with the libglib2 event loop, or libevent
or the QT event loop.
For proper event handling, it is important that the event implementation
is registered before a connection to the Hypervisor is opened.
Use of the virEventAddHandle() and similar APIs require that the
corresponding handler is registered. Use of the
virConnectDomainEventRegisterAny() and similar APIs requires that
the three timeout handlers are registered. Likewise, the three
timeout handlers must be registered if the remote server has been
configured to send keepalive messages, or if the client intends
to call virConnectSetKeepAlive(), to avoid either side from
unexpectedly closing the connection due to inactivity.
If an application does not need to integrate with an
existing event loop implementation, then the
virEventRegisterDefaultImpl() method can be used to setup
the generic libvirt implementation.
Once registered, the event loop implementation cannot be
changed, and must be run continuously. Note that callbacks
may remain registered for a short time even after calling
virConnectClose on all open connections, so it is not safe
to stop running the event loop immediately after closing
the connection. N)r �virEventRegisterImpl)Z addHandleZ updateHandleZ removeHandleZ
addTimeoutZ
updateTimeoutZ
removeTimeoutr r r rT z s rT c C s t j| �}|dkrtd��|S )z�Unregister a callback from a file handle. This function
requires that an event loop has previously been registered with
virEventRegisterImpl() or virEventRegisterDefaultImpl(). r z virEventRemoveHandle() failedrL )r �virEventRemoveHandler )r= r9 r r r rU � s
rU c C s t j| �}|dkrtd��|S )z�Unregister a callback for a timer. This function
requires that an event loop has previously been registered with
virEventRegisterImpl() or virEventRegisterDefaultImpl(). r z virEventRemoveTimeout() failedrL )r �virEventRemoveTimeoutr )rE r9 r r r rV � s
rV c C s t j� } | dkrtd��| S )a� Run one iteration of the event loop. Applications
will generally want to have a thread which invokes
this method in an infinite loop. Furthermore, it is wise
to set up a pipe-to-self handler (via virEventAddHandle())
or a timeout (via virEventAddTimeout()) before calling this
function, as it will block forever if there are no
registered events.
static bool quit;
while (!quit) {
if (virEventRunDefaultImpl() < 0)
...print error...
} r z virEventRunDefaultImpl() failedrL )r �virEventRunDefaultImplr )r9 r r r rW � s rW c C s t j| |� dS )z�Change event set for a monitored file handle. This function
requires that an event loop has previously been registered with
virEventRegisterImpl() or virEventRegisterDefaultImpl().
Will not fail if fd exists. N)r �virEventUpdateHandle)r= rG r r r rX � s rX c C s t j| |� dS )af Change frequency for a timer. This function
requires that an event loop has previously been registered with
virEventRegisterImpl() or virEventRegisterDefaultImpl().
Setting frequency to -1 will disable the timer. Setting the frequency
to zero will cause it to fire on every event loop iteration.
Will not fail if timer exists. N)r �virEventUpdateTimeout)rE rN r r r rY � s rY c C s t j� } | S )z�Provide a pointer to the last error caught at the library level
The error object is kept in thread local storage, so separate
threads can safely access this concurrently. )r r )r9 r r r r � s r c C s t j� } | dkrtd��| S )z6Get the most recent error code (enum virErrorNumber). r z virGetLastErrorCode() failedrL )r �virGetLastErrorCoder )r9 r r r rZ � s rZ c C s t j� } | dkrtd��| S )z8Get the most recent error domain (enum virErrorDomain). r z virGetLastErrorDomain() failedrL )r �virGetLastErrorDomainr )r9 r r r r[ � s r[ c C s t j� } | dkrtd��| S )z"Get the most recent error message Nz virGetLastErrorMessage() failed)r �virGetLastErrorMessager )r9 r r r r\ � s r\ c C s t j� } | dkrtd��| S )a Initialize the library.
This method is invoked automatically by any of the virConnectOpen() API
calls, and by virGetVersion(). Since release 1.0.0, there is no need to
call this method even in a multithreaded application, since
initialization is performed in a thread safe manner; but applications
using an older version of the library should manually call this before
setting up competing threads that attempt virConnectOpen in parallel.
The only other time it would be necessary to call virInitialize is if the
application did not invoke virConnectOpen as its first API call, such
as when calling virEventRegisterImpl() before setting up connections,
or when using virSetErrorFunc() to alter error reporting of the first
connection attempt. r zvirInitialize() failedrL )r �
virInitializer )r9 r r r r] � s r] c C s t j� dS )z�Reset the last error caught at the library level.
The error object is kept in thread local storage, so separate
threads can safely access this concurrently, only resetting
their own error object. N)r �virResetLastErrorr r r r r^ s r^ c @ s8 e Zd Z�dUdd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
�dVdd�Z dd� Z �dWdd�Z
�dXdd�Zdd � Z�dYd d �Z�dZd d �Z�d[d!d"�Zd#d$� Z�d\d%d&�Z�d]d'd(�Z�d^d)d*�Z�d_d+d,�Z�d`d-d.�Z�dad/d0�Z�dbd1d2�Z�dcd3d4�Z�ddd5d6�Z �ded7d8�Z �dfd9d:�Z �dgd;d<�Z �dhd=d>�Z �did?d@�Z!dAdB� Z"�djdCdD�Z#�dkdEdF�Z$�dldGdH�Z%�dmdIdJ�Z&�dndKdL�Z'�dodMdN�Z(dOdP� Z)�dpdQdR�Z*�dqdSdT�Z+dUdV� Z,�drdWdX�Z-dYdZ� Z.�dsd[d\�Z/�dtd]d^�Z0�dud_d`�Z1�dvdadb�Z2�dwdcdd�Z3�dxdedf�Z4�dydgdh�Z5�dzdidj�Z6�d{dkdl�Z7�d|dmdn�Z8�d}dodp�Z9�d~dqdr�Z:dsdt� Z;�ddudv�Z<�d�dwdx�Z=�d�dydz�Z>d{d|� Z?�d�d}d~�Z@dd�� ZAd�d�� ZBd�d�� ZCd�d�� ZD�d�d�d��ZE�d�d�d��ZF�d�d�d��ZG�d�d�d��ZH�d�d�d��ZI�d�d�d��ZJd�d�� ZKd�d�� ZL�d�d�d��ZM�d�d�d��ZNd�d�� ZO�d�d�d��ZP�d�d�d��ZQ�d�d�d��ZR�d�d�d��ZS�d�d�d��ZT�d�d�d��ZU�d�d�d��ZV�d�d�d��ZW�d�d�d��ZX�d�d�d��ZY�d�d�d��ZZ�d�d�d��Z[�d�d�d��Z\�d�d�d��Z]�d�d�d��Z^d�d�� Z_�d�d�d��Z`�d�d�d��Za�d�d�dZb�d�d�dĄZc�d�d�dƄZd�d�d�dȄZe�d�d�dʄZf�d�d�d̄Zg�d�d�d΄Zh�d�d�dЄZid�d҄ Zj�d�d�dԄZk�d�d�dքZl�d�d�dZm�d�d�dڄZnd�d܄ Zo�d�d�dބZpd�d� Zq�d�d�d�Zrd�d� Zs�d�d�d�Ztd�d� Zu�d�d�d�Zvd�d� Zwd�d� Zx�d�d�d�Zy�d�d�d�Zzd�d� Z{�d�d�d��Z|�d�d�d��Z}�d�d�d��Z~�d�d�d��Z�d�d�d��Z��d�d��d �Z��d��d�d�Z��d��d�d�Z��d�d� Z��d�d� Z��d��d �d
�Z��d��d �d �Z��d��d
�d�Z��d��d�d�Z��d��d�d�Z��d��d�d�Z��d�d� Z��d��d�d�Z��d��d�d�Z��d��d�d �Z��d �d � Z��d��d �d �Z��d!�d"� Z��d��d#�d$�Z��d��d%�d&�Z��dd'�d(�Z��dÐd)�d*�Z��dĐd+�d,�Z��dŐd-�d.�Z��dƐd/�d0�Z��dǐd1�d2�Z��d3�d4� Z��d5�d6� Z��dȐd7�d8�Z��dɐd9�d:�Z��dʐd;�d<�Z��d=�d>� Z��dːd?�d@�Z��d�e�e��dA �dB��dC�dD�Z��d�e�e��dE �dB��dF�dG�Z��d�e�e� e�d �dH��dI�dJ�Z��d�e�e� e�e��dK��dL�dM�Z��d�e�e� e�e��dK��dN�dO�Z��d�e�e��dB��dP�dQ�Z��d�e�e�e��dR��dS�dT�Z�dS (� r Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )N� PyCapsule� PyCObjectz&Expected a wrapped C Object but got %s)r_ r` )�_conn�typer- r �_o)r �connr8 r r r r s zvirDomain.__init__c C s | j d k rtj| j � d | _ d S )N)rc r Z
virDomainFree)r r r r �__del__ s
zvirDomain.__del__c C s | j S )N)ra )r r r r �connect# s zvirDomain.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirDomain_pointerrc )r r r r � c_pointer& s zvirDomain.c_pointerc C s t j| j�}|S )z,Get the hypervisor ID number for the domain )r ZvirDomainGetIDrc )r r9 r r r �ID. s z virDomain.IDc C s t j| j�}|dkr td��|S )z)Get the type of domain operation system. NzvirDomainGetOSType() failed)r ZvirDomainGetOSTyperc r )r r9 r r r �OSType3 s zvirDomain.OSTypec C s t j| j�}|dkr td��|S )z0Extract the UUID unique Identifier of a domain. NzvirDomainGetUUID() failed)r ZvirDomainGetUUIDrc r )r r9 r r r �UUID> s zvirDomain.UUIDc C s t j| j�}|dkr td��|S )z4Fetch globally unique ID of the domain as a string. Nz virDomainGetUUIDString() failed)r ZvirDomainGetUUIDStringrc r )r r9 r r r �
UUIDStringE s zvirDomain.UUIDStringr c C s" t j| j|�}|dkr td��|S )a� Provide an XML description of the domain. The description may be reused
later to relaunch the domain with virDomainCreateXML().
No security-sensitive data will be included unless @flags contains
VIR_DOMAIN_XML_SECURE; this flag is rejected on read-only
connections. If @flags includes VIR_DOMAIN_XML_INACTIVE, then the
XML represents the configuration that will be used on the next boot
of a persistent domain; otherwise, the configuration represents the
currently running domain. If @flags contains
VIR_DOMAIN_XML_UPDATE_CPU, then the portion of the domain XML
describing CPU capabilities is modified to match actual
capabilities of the host.
If @flags contains VIR_DOMAIN_XML_MIGRATABLE, the XML is altered to
assist in migrations, since the source and destination may be
running different libvirt versions. This may include trimming
redundant or default information that might confuse an older
recipient, or exposing internal details that aid a newer recipient;
this flag is rejected on read-only connections, and the resulting
XML might not validate against the schema, so it is mainly for
internal use. Nz virDomainGetXMLDesc() failed)r ZvirDomainGetXMLDescrc r )r r7 r9 r r r �XMLDescP s zvirDomain.XMLDescc C s t j| j�}|dkr td��|S )z�Requests that the current background job be aborted at the
soonest opportunity. In case the job is a migration in a post-copy mode,
virDomainAbortJob will report an error (see virDomainMigrateStartPostCopy
for more details). r zvirDomainAbortJob() failedrL )r ZvirDomainAbortJobrc r )r r9 r r r �abortJobk s zvirDomain.abortJobc C s$ t j| j||�}|dkr td��|S )a= Dynamically add an IOThread to the domain. It is left up to the
underlying virtual hypervisor to determine the valid range for an
@iothread_id and determining whether the @iothread_id already exists.
Note that this call can fail if the underlying virtualization hypervisor
does not support it or if growing the number is arbitrarily limited.
This function requires privileged access to the hypervisor.
@flags may include VIR_DOMAIN_AFFECT_LIVE or VIR_DOMAIN_AFFECT_CONFIG.
Both flags may be set.
If VIR_DOMAIN_AFFECT_LIVE is set, the change affects a running domain
and may fail if domain is not alive.
If VIR_DOMAIN_AFFECT_CONFIG is set, the change affects persistent state,
and will fail for transient domains. If neither flag is specified (that is,
@flags is VIR_DOMAIN_AFFECT_CURRENT), then an inactive domain modifies
persistent setup, while an active domain is hypervisor-dependent on whether
just live or both live and persistent state is changed. r z virDomainAddIOThread() failedrL )r ZvirDomainAddIOThreadrc r )r � iothread_idr7 r9 r r r � addIOThreadu s zvirDomain.addIOThreadc C s$ t j| j||�}|dkr td��|S )a: Set how long to wait for a response from guest agent commands. By default,
agent commands block forever waiting for a response.
@timeout must be a value from virDomainAgentResponseTimeoutValues or
positive:
VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK(-2): meaning to block forever
waiting for a result.
VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT(-1): use default timeout value.
VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT(0): does not wait.
positive value: wait for @timeout seconds r z)virDomainAgentSetResponseTimeout() failedrL )r Z virDomainAgentSetResponseTimeoutrc r )r rN r7 r9 r r r �agentSetResponseTimeout� s z!virDomain.agentSetResponseTimeoutc C s" t j| j|�}|dkr td��|S )a5 Create a virtual device attachment to backend. This function,
having hotplug semantics, is only allowed on an active domain.
For compatibility, this method can also be used to change the media
in an existing CDROM/Floppy device, however, applications are
recommended to use the virDomainUpdateDeviceFlags method instead.
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. r z virDomainAttachDevice() failedrL )r ZvirDomainAttachDevicerc r )r �xmlr9 r r r � attachDevice� s zvirDomain.attachDevicec C s$ t j| j||�}|dkr td��|S )a� Attach a virtual device to a domain, using the flags parameter
to control how the device is attached. VIR_DOMAIN_AFFECT_CURRENT
specifies that the device allocation is made based on current domain
state. VIR_DOMAIN_AFFECT_LIVE specifies that the device shall be
allocated to the active domain instance only and is not added to the
persisted domain configuration. VIR_DOMAIN_AFFECT_CONFIG
specifies that the device shall be allocated to the persisted domain
configuration only. Note that the target hypervisor must return an
error if unable to satisfy flags. E.g. the hypervisor driver will
return failure if LIVE is specified but it only supports modifying the
persisted device allocation.
For compatibility, this method can also be used to change the media
in an existing CDROM/Floppy device, however, applications are
recommended to use the virDomainUpdateDeviceFlag method instead.
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. r z#virDomainAttachDeviceFlags() failedrL )r ZvirDomainAttachDeviceFlagsrc r )r rq r7 r9 r r r �attachDeviceFlags� s zvirDomain.attachDeviceFlagsc C s$ t j| j||�}|dkr td��|S )zCFetch list of public SSH authorized keys for given user in domain. Nz&virDomainAuthorizedSSHKeysGet() failed)r Z virDomainAuthorizedSSHKeysGetrc r )r �userr7 r9 r r r �authorizedSSHKeysGet� s z virDomain.authorizedSSHKeysGetc C s& t j| j|||�}|dkr"td��|S )zGManipulate set of public SSH authorized keys for given user in domain. r z&virDomainAuthorizedSSHKeysSet() failedrL )r Z virDomainAuthorizedSSHKeysSetrc r )r rt �keysr7 r9 r r r �authorizedSSHKeysSet� s z virDomain.authorizedSSHKeysSetc C s t j| j�}|dkr td��|S )z(Extract the autostart flag for a domain r z virDomainGetAutostart() failedrL )r ZvirDomainGetAutostartrc r )r r9 r r r � autostart� s zvirDomain.autostartc C s& t j| j|||�}|dkr"td��|S )a^ Start a point-in-time backup job for the specified disks of a
running domain.
A backup job is a domain job and thus mutually exclusive with any other
domain job such as migration.
For now, backup jobs are also mutually exclusive with any
other block job on the same device, although this restriction may
be lifted in a future release. Progress of the backup job can be
tracked via virDomainGetJobStats(). Completion of the job is also announced
asynchronously via VIR_DOMAIN_EVENT_ID_JOB_COMPLETED event.
There are two fundamental backup approaches. The first, called a
push model, instructs the hypervisor to copy the state of the guest
disk to the designated storage destination (which may be on the
local file system or a network device). In this mode, the
hypervisor writes the content of the guest disk to the destination,
then emits VIR_DOMAIN_EVENT_ID_JOB_COMPLETED when the backup is
either complete or failed (the backup image is invalid if the job
fails or virDomainAbortJob() is used prior to the event being
emitted). This kind of the job finishes automatically. Users can
determine success by using virDomainGetJobStats() with
VIR_DOMAIN_JOB_STATS_COMPLETED flag.
The second, called a pull model, instructs the hypervisor to expose
the state of the guest disk over an NBD export. A third-party
client can then connect to this export and read whichever portions
of the disk it desires. In this mode libvirt has to be informed via
virDomainAbortJob() when the third-party NBD client is done and the backup
resources can be released.
The @backupXML parameter contains details about the backup in the top-level
element <domainbackup>, including which backup mode to use, whether the
backup is incremental from a previous checkpoint, which disks
participate in the backup, the destination for a push model backup,
and the temporary storage and NBD server details for a pull model
backup.
virDomainBackupGetXMLDesc() can be called to learn actual
values selected. For more information, see
formatcheckpoint.html#BackupAttributes.
The @checkpointXML parameter is optional; if non-None, then libvirt
behaves as if virDomainCheckpointCreateXML() were called to create
a checkpoint atomically covering the same point in time as the
backup.
The VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNAL specifies that the output or
temporary files described by the @backupXML document were created by the
caller with correct format and size to hold the backup or temporary data.
The creation of a new checkpoint allows for future incremental backups.
Note that some hypervisors may require a particular disk format, such as
qcow2, in order to take advantage of checkpoints, while allowing arbitrary
formats if checkpoints are not involved. r z virDomainBackupBegin() failedrL )r ZvirDomainBackupBeginrc r )r Z backupXMLZ
checkpointXMLr7 r9 r r r � backupBegin� s 8zvirDomain.backupBeginc C s" t j| j|�}|dkr td��|S )aN Queries the configuration of the active backup job.
In some cases, a user can start a backup job without supplying all
details and rely on libvirt to fill in the rest (for example,
selecting the port used for an NBD export). This API can then be
used to learn what default values were chosen. Nz"virDomainBackupGetXMLDesc() failed)r ZvirDomainBackupGetXMLDescrc r )r r7 r9 r r r �backupGetXMLDesc s zvirDomain.backupGetXMLDescc C s" t j| j|�}|dkr td��|S )zGet the blkio parameters Nz$virDomainGetBlkioParameters() failed)r ZvirDomainGetBlkioParametersrc r )r r7 r9 r r r �blkioParameters0 s zvirDomain.blkioParametersc C s* t j| j|||||�}|dkr&td��|S )a Commit changes that were made to temporary top-level files within a disk
image backing file chain into a lower-level base file. In other words,
take all the difference between @base and @top, and update @base to contain
that difference; after the commit, any portion of the chain that previously
depended on @top will now depend on @base, and all files after @base up
to and including @top will now be invalidated. A typical use of this
command is to reduce the length of a backing file chain after taking an
external disk snapshot. To move data in the opposite direction, see
virDomainBlockPull().
This command starts a long-running commit block job, whose status may
be tracked by virDomainBlockJobInfo() with a job type of
VIR_DOMAIN_BLOCK_JOB_TYPE_COMMIT, and the operation can be aborted with
virDomainBlockJobAbort(). When finished, an asynchronous event is
raised to indicate the final status, and the job no longer exists. If
the job is aborted, it is up to the hypervisor whether starting a new
job will resume from the same point, or start over.
As a special case, if @top is the active image (or None), and @flags
includes VIR_DOMAIN_BLOCK_COMMIT_ACTIVE, the block job will have a type
of VIR_DOMAIN_BLOCK_JOB_TYPE_ACTIVE_COMMIT, and operates in two phases.
In the first phase, the contents are being committed into @base, and the
job can only be canceled. The job transitions to the second phase when
the block job event with state VIR_DOMAIN_BLOCK_JOB_READY is
emitted for the given device. This information is also visible in the
live XML as 'ready="yes"' attribute of the corresponding <mirror> element.
Once in the second phase, the user must choose whether to cancel the job
(keeping @top as the active image, but now containing only the changes
since the time the job ended) or to pivot the job (adjusting to @base as
the active image, and invalidating @top).
Be aware that this command may invalidate files even if it is aborted;
the user is cautioned against relying on the contents of invalidated
intermediate files such as @top (when @top is not the active image)
without manually rebasing those files to use a backing file of a
read-only copy of @base prior to the point where the commit operation
was started (and such a rebase cannot be safely done until the commit
has successfully completed). However, the domain itself will not have
any issues; the active layer remains valid throughout the entire commit
operation.
Some hypervisors may support a shortcut where if @flags contains
VIR_DOMAIN_BLOCK_COMMIT_DELETE, then this command will unlink all files
that were invalidated, after the commit successfully completes.
If @flags contains VIR_DOMAIN_BLOCK_COMMIT_RELATIVE, the name recorded
into the overlay of the @top image (if there is such image) as the
path to the new backing file will be kept relative to other images.
The operation will fail if libvirt can't infer the name.
By default, if @base is None, the commit target will be the bottom of
the backing chain; if @flags contains VIR_DOMAIN_BLOCK_COMMIT_SHALLOW,
then the immediate backing file of @top will be used instead. If @top
is None, the active image at the top of the chain will be used. Some
hypervisors place restrictions on how much can be committed, and might
fail if @base is not the immediate backing file of @top, or if @top is
the active layer in use by a running domain but @flags did not include
VIR_DOMAIN_BLOCK_COMMIT_ACTIVE, or if @top is not the top-most file;
restrictions may differ for online vs. offline domains.
The @disk parameter is either an unambiguous source name of the
block device (the <source file='...'/> sub-element, such as
"/path/to/image"), or the device target shorthand (the
<target dev='...'/> sub-element, such as "vda"). Valid names
can be found by calling virDomainGetXMLDesc() and inspecting
elements within //domain/devices/disk.
The @base and @top parameters can be either paths to files within the
backing chain, or the device target shorthand (the <target dev='...'/>
sub-element, such as "vda") followed by an index to the backing chain
enclosed in square brackets. Backing chain indexes can be found by
inspecting //disk//backingStore/@index in the domain XML. Thus, for
example, "vda[3]" refers to the backing store with index equal to "3"
in the chain of disk "vda".
The maximum bandwidth that will be used to do the commit can be
specified with the @bandwidth parameter. If set to 0, there is no
limit. If @flags includes VIR_DOMAIN_BLOCK_COMMIT_BANDWIDTH_BYTES,
@bandwidth is in bytes/second; otherwise, it is in MiB/second.
Values larger than 2^52 bytes/sec may be rejected due to overflow
considerations based on the word size of both client and server,
and values larger than 2^31 bytes/sec may cause overflow problems
if later queried by virDomainGetBlockJobInfo() without scaling.
Hypervisors may further restrict the range of valid bandwidth
values. Some hypervisors do not support this feature and will
return an error if bandwidth is not 0; in this case, it might still
be possible for a later call to virDomainBlockJobSetSpeed() to
succeed. The actual speed can be determined with
virDomainGetBlockJobInfo(). r z virDomainBlockCommit() failedrL )r ZvirDomainBlockCommitrc r )r �disk�base�top� bandwidthr7 r9 r r r � blockCommit; s ZzvirDomain.blockCommitc C s( t j| j||||�}|dkr$td��|S )zSCopy the guest-visible contents of a disk image to a new file described by destxml r zvirDomainBlockCopy() failedrL )r ZvirDomainBlockCopyrc r )r r| Zdestxml�paramsr7 r9 r r r � blockCopy� s zvirDomain.blockCopyc C s$ t j| j||�}|dkr td��|S )z5Extract information about a domain block device size Nz virDomainGetBlockInfo() failed)r ZvirDomainGetBlockInforc r )r �pathr7 r9 r r r � blockInfo� s zvirDomain.blockInfoc C s$ t j| j||�}|dkr td��|S )z(Get the I/O tunables for a block device Nz virDomainGetBlockIoTune() failed)r ZvirDomainGetBlockIoTunerc r )r r| r7 r9 r r r � blockIoTune� s zvirDomain.blockIoTunec C s$ t j| j||�}|dkr td��|S )a� Cancel the active block job on the given disk.
The @disk parameter is either an unambiguous source name of the
block device (the <source file='...'/> sub-element, such as
"/path/to/image"), or (since 0.9.5) the device target shorthand
(the <target dev='...'/> sub-element, such as "vda"). Valid names
can be found by calling virDomainGetXMLDesc() and inspecting
elements within //domain/devices/disk.
If the current block job for @disk is VIR_DOMAIN_BLOCK_JOB_TYPE_PULL, then
by default, this function performs a synchronous operation and the caller
may assume that the operation has completed when 0 is returned. However,
BlockJob operations may take a long time to cancel, and during this time
further domain interactions may be unresponsive. To avoid this problem,
pass VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC in the @flags argument to enable
asynchronous behavior, returning as soon as possible. When the job has
been canceled, a BlockJob event will be emitted, with status
VIR_DOMAIN_BLOCK_JOB_CANCELED (even if the ABORT_ASYNC flag was not
used); it is also possible to poll virDomainBlockJobInfo() to see if
the job cancellation is still pending. This type of job can be restarted
to pick up from where it left off.
If the current block job for @disk is VIR_DOMAIN_BLOCK_JOB_TYPE_COPY, then
the default is to abort the mirroring and revert to the source disk;
likewise, if the current job is VIR_DOMAIN_BLOCK_JOB_TYPE_ACTIVE_COMMIT,
the default is to abort without changing the active layer of @disk.
Adding @flags of VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT causes this call to
fail with VIR_ERR_BLOCK_COPY_ACTIVE if the copy or commit is not yet
ready; otherwise it will swap the disk over to the new active image
to end the mirroring or active commit. An event will be issued when the
job is ended, and it is possible to use VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC
to control whether this command waits for the completion of the job.
Restarting a copy or active commit job requires starting over from the
beginning of the first phase. r z virDomainBlockJobAbort() failedrL )r ZvirDomainBlockJobAbortrc r )r r| r7 r9 r r r �
blockJobAbort� s #zvirDomain.blockJobAbortc C s$ t j| j||�}|dkr td��|S )z)Get progress information for a block job Nz!virDomainGetBlockJobInfo() failed)r ZvirDomainGetBlockJobInforc r )r r� r7 r9 r r r � blockJobInfo� s zvirDomain.blockJobInfoc C s& t j| j|||�}|dkr"td��|S )aL Set the maximum allowable bandwidth that a block job may consume. If
bandwidth is 0, the limit will revert to the hypervisor default of
unlimited.
If @flags contains VIR_DOMAIN_BLOCK_JOB_SPEED_BANDWIDTH_BYTES, @bandwidth
is in bytes/second; otherwise, it is in MiB/second. Values larger than
2^52 bytes/sec may be rejected due to overflow considerations based on
the word size of both client and server, and values larger than 2^31
bytes/sec may cause overflow problems if later queried by
virDomainGetBlockJobInfo() without scaling. Hypervisors may further
restrict the range of valid bandwidth values.
The @disk parameter is either an unambiguous source name of the
block device (the <source file='...'/> sub-element, such as
"/path/to/image"), or (since 0.9.5) the device target shorthand
(the <target dev='...'/> sub-element, such as "vda"). Valid names
can be found by calling virDomainGetXMLDesc() and inspecting
elements within //domain/devices/disk. r z"virDomainBlockJobSetSpeed() failedrL )r ZvirDomainBlockJobSetSpeedrc r )r r| r r7 r9 r r r �blockJobSetSpeed� s zvirDomain.blockJobSetSpeedc C s( t j| j||||�}|dkr$td��|S )z*Read the contents of domain's disk device NzvirDomainBlockPeek() failed)r ZvirDomainBlockPeekrc r )r r| �offset�sizer7 r9 r r r � blockPeek
s zvirDomain.blockPeekc C s& t j| j|||�}|dkr"td��|S )a� Populate a disk image with data from its backing image. Once all data from
its backing image has been pulled, the disk no longer depends on a backing
image. This function pulls data for the entire device in the background.
Progress of the operation can be checked with virDomainGetBlockJobInfo() and
the operation can be aborted with virDomainBlockJobAbort(). When finished,
an asynchronous event is raised to indicate the final status. To move
data in the opposite direction, see virDomainBlockCommit().
The @disk parameter is either an unambiguous source name of the
block device (the <source file='...'/> sub-element, such as
"/path/to/image"), or (since 0.9.5) the device target shorthand
(the <target dev='...'/> sub-element, such as "vda"). Valid names
can be found by calling virDomainGetXMLDesc() and inspecting
elements within //domain/devices/disk.
The maximum bandwidth that will be used to do the copy can be
specified with the @bandwidth parameter. If set to 0, there is no
limit. If @flags includes VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTES,
@bandwidth is in bytes/second; otherwise, it is in MiB/second.
Values larger than 2^52 bytes/sec may be rejected due to overflow
considerations based on the word size of both client and server,
and values larger than 2^31 bytes/sec may cause overflow problems
if later queried by virDomainGetBlockJobInfo() without scaling.
Hypervisors may further restrict the range of valid bandwidth
values. Some hypervisors do not support this feature and will
return an error if bandwidth is not 0; in this case, it might still
be possible for a later call to virDomainBlockJobSetSpeed() to
succeed. The actual speed can be determined with
virDomainGetBlockJobInfo().
This is shorthand for virDomainBlockRebase() with a None base. r zvirDomainBlockPull() failedrL )r ZvirDomainBlockPullrc r )r r| r r7 r9 r r r � blockPull s zvirDomain.blockPullc C s( t j| j||||�}|dkr$td��|S )a� Populate a disk image with data from its backing image chain, and
setting the backing image to @base, or alternatively copy an entire
backing chain to a new file @base.
When @flags is 0, this starts a pull, where @base must be the absolute
path of one of the backing images further up the chain, or None to
convert the disk image so that it has no backing image. Once all
data from its backing image chain has been pulled, the disk no
longer depends on those intermediate backing images. This function
pulls data for the entire device in the background. Progress of
the operation can be checked with virDomainGetBlockJobInfo() with a
job type of VIR_DOMAIN_BLOCK_JOB_TYPE_PULL, and the operation can be
aborted with virDomainBlockJobAbort(). When finished, an asynchronous
event is raised to indicate the final status, and the job no longer
exists. If the job is aborted, a new one can be started later to
resume from the same point.
If @flags contains VIR_DOMAIN_BLOCK_REBASE_RELATIVE, the name recorded
into the active disk as the location for @base will be kept relative.
The operation will fail if libvirt can't infer the name.
When @flags includes VIR_DOMAIN_BLOCK_REBASE_COPY, this starts a copy,
where @base must be the name of a new file to copy the chain to. By
default, the copy will pull the entire source chain into the destination
file, but if @flags also contains VIR_DOMAIN_BLOCK_REBASE_SHALLOW, then
only the top of the source chain will be copied (the source and
destination have a common backing file). By default, @base will be
created with the same file format as the source, but this can be altered
by adding VIR_DOMAIN_BLOCK_REBASE_COPY_RAW to force the copy to be raw
(does not make sense with the shallow flag unless the source is also raw),
or by using VIR_DOMAIN_BLOCK_REBASE_REUSE_EXT to reuse an existing file
which was pre-created with the correct format and metadata and sufficient
size to hold the copy. In case the VIR_DOMAIN_BLOCK_REBASE_SHALLOW flag
is used the pre-created file has to exhibit the same guest visible contents
as the backing file of the original image. This allows a management app to
pre-create files with relative backing file names, rather than the default
of absolute backing file names; as a security precaution, you should
generally only use reuse_ext with the shallow flag and a non-raw
destination file. By default, the copy destination will be treated as
type='file', but using VIR_DOMAIN_BLOCK_REBASE_COPY_DEV treats the
destination as type='block' (affecting how virDomainGetBlockInfo() will
report allocation after pivoting).
A copy job has two parts; in the first phase, the @bandwidth parameter
affects how fast the source is pulled into the destination, and the job
can only be canceled by reverting to the source file; progress in this
phase can be tracked via the virDomainBlockJobInfo() command, with a
job type of VIR_DOMAIN_BLOCK_JOB_TYPE_COPY. The job transitions to the
second phase when the job info states cur == end, and remains alive to
mirror all further changes to both source and destination. The user
must call virDomainBlockJobAbort() to end the mirroring while choosing
whether to revert to source or pivot to the destination. An event is
issued when the job ends, and depending on the hypervisor, an event may
also be issued when the job transitions from pulling to mirroring. If
the job is aborted, a new job will have to start over from the beginning
of the first phase.
Some hypervisors will restrict certain actions, such as virDomainSave()
or virDomainDetachDevice(), while a copy job is active; they may
also restrict a copy job to transient domains.
The @disk parameter is either an unambiguous source name of the
block device (the <source file='...'/> sub-element, such as
"/path/to/image"), or the device target shorthand (the
<target dev='...'/> sub-element, such as "vda"). Valid names
can be found by calling virDomainGetXMLDesc() and inspecting
elements within //domain/devices/disk.
The @base parameter can be either a path to a file within the backing
chain, or the device target shorthand (the <target dev='...'/>
sub-element, such as "vda") followed by an index to the backing chain
enclosed in square brackets. Backing chain indexes can be found by
inspecting //disk//backingStore/@index in the domain XML. Thus, for
example, "vda[3]" refers to the backing store with index equal to "3"
in the chain of disk "vda".
The maximum bandwidth that will be used to do the copy can be
specified with the @bandwidth parameter. If set to 0, there is no
limit. If @flags includes VIR_DOMAIN_BLOCK_REBASE_BANDWIDTH_BYTES,
@bandwidth is in bytes/second; otherwise, it is in MiB/second.
Values larger than 2^52 bytes/sec may be rejected due to overflow
considerations based on the word size of both client and server,
and values larger than 2^31 bytes/sec may cause overflow problems
if later queried by virDomainGetBlockJobInfo() without scaling.
Hypervisors may further restrict the range of valid bandwidth
values. Some hypervisors do not support this feature and will
return an error if bandwidth is not 0; in this case, it might still
be possible for a later call to virDomainBlockJobSetSpeed() to
succeed. The actual speed can be determined with
virDomainGetBlockJobInfo().
When @base is None and @flags is 0, this is identical to
virDomainBlockPull(). When @flags contains VIR_DOMAIN_BLOCK_REBASE_COPY,
this command is shorthand for virDomainBlockCopy() where the destination
XML encodes @base as a <disk type='file'>, @bandwidth is properly scaled
and passed as a typed parameter, the shallow and reuse external flags
are preserved, and remaining flags control whether the XML encodes a
destination format of raw instead of leaving the destination identical
to the source format or probed from the reused file. r z virDomainBlockRebase() failedrL )r ZvirDomainBlockRebaserc r )r r| r} r r7 r9 r r r � blockRebase: s dzvirDomain.blockRebasec C s& t j| j|||�}|dkr"td��|S )a� Resize a block device of domain while the domain is running. If
@flags is 0, then @size is in kibibytes (blocks of 1024 bytes);
since 0.9.11, if @flags includes VIR_DOMAIN_BLOCK_RESIZE_BYTES,
@size is in bytes instead. @size is taken directly as the new
size. Depending on the file format, the hypervisor may round up
to the next alignment boundary.
The @disk parameter is either an unambiguous source name of the
block device (the <source file='...'/> sub-element, such as
"/path/to/image"), or (since 0.9.5) the device target shorthand
(the <target dev='...'/> sub-element, such as "vda"). Valid names
can be found by calling virDomainGetXMLDesc() and inspecting
elements within //domain/devices/disk.
Note that this call may fail if the underlying virtualization hypervisor
does not support it; this call requires privileged access to the
hypervisor. r z virDomainBlockResize() failedrL )r ZvirDomainBlockResizerc r )r r| r� r7 r9 r r r � blockResize� s zvirDomain.blockResizec C s" t j| j|�}|dkr td��|S )z.Extracts block device statistics for a domain Nz virDomainBlockStats() failed)r ZvirDomainBlockStatsrc r )r r� r9 r r r �
blockStats� s zvirDomain.blockStatsc C s$ t j| j||�}|dkr td��|S )z@Extracts block device statistics parameters of a running domain Nz!virDomainBlockStatsFlags() failed)r ZvirDomainBlockStatsFlagsrc r )r r� r7 r9 r r r �blockStatsFlags� s zvirDomain.blockStatsFlagsc C s0 t j| j||�}|dkr td��t| |d�}|S )az Create a new checkpoint using @xmlDesc, with a top-level
<domaincheckpoint> element, on a running @domain. Note that
@xmlDesc must validate against the <domaincheckpoint> XML schema.
Typically, it is more common to create a new checkpoint as part of
kicking off a backup job with virDomainBackupBegin(); however, it
is also possible to start a checkpoint without a backup.
See <a href="formatcheckpoint.html#CheckpointAttributes">Checkpoint XML</a>
for more details on @xmlDesc. In particular, some hypervisors may require
particular disk formats, such as qcow2, in order to support this
command; where @xmlDesc can be used to limit the checkpoint to a working
subset of the domain's disks.
If @flags includes VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE, then this
is a request to reinstate checkpoint metadata that was previously
captured from virDomainCheckpointGetXMLDesc() before removing that
metadata, rather than creating a new checkpoint. Note that while
original creation can omit a number of elements from @xmlDesc (and
libvirt will supply sane defaults based on the domain state at that
point in time), a redefinition must supply more elements (as the
domain may have changed in the meantime, so that libvirt no longer
has a way to resupply correct defaults). Not all hypervisors support
this flag.
If @flags includes VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE_VALIDATE along with
VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE the state of the metadata related
to the disk state of the redefined checkpoint is validated. Note that
hypervisors may require that the @domain is running to perform validation.
If @flags includes VIR_DOMAIN_CHECKPOINT_CREATE_QUIESCE, then the
libvirt will attempt to use guest agent to freeze and thaw all file
systems in use within domain OS. However, if the guest agent is not
present, an error is thrown. This flag is incompatible with
VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE. Nz%virDomainCheckpointCreateXML() failed)r8 )r Z virDomainCheckpointCreateXMLrc r �virDomainCheckpoint)r �xmlDescr7 r9 �_virDomain__tmpr r r �checkpointCreateXML� s
# z virDomain.checkpointCreateXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )z5Try to lookup a domain checkpoint based on its name. Nz(virDomainCheckpointLookupByName() failed)r8 )r Z virDomainCheckpointLookupByNamerc r r� )r r; r7 r9 r� r r r �checkpointLookupByName� s
z virDomain.checkpointLookupByNamec C s" t j| j|�}|dkr td��|S )zFExtract details about current state of control interface to a domain. Nz virDomainGetControlInfo() failed)r ZvirDomainGetControlInforc r )r r7 r9 r r r � controlInfo s zvirDomain.controlInfoc C s$ t j| j||�}|dkr td��|S )a^ This method will dump the core of a domain on a given file for analysis.
Note that for remote Xen Daemon the file path will be interpreted in
the remote host. Hypervisors may require the user to manually ensure
proper permissions on the file named by @to.
If @flags includes VIR_DUMP_CRASH, then leave the guest shut off with
a crashed state after the dump completes. If @flags includes
VIR_DUMP_LIVE, then make the core dump while continuing to allow
the guest to run; otherwise, the guest is suspended during the dump.
VIR_DUMP_RESET flag forces reset of the guest after dump.
The above three flags are mutually exclusive.
Additionally, if @flags includes VIR_DUMP_BYPASS_CACHE, then libvirt
will attempt to bypass the file system cache while creating the file,
or fail if it cannot do so for the given system; this can allow less
pressure on file system cache, but also risks slowing saves to NFS.
For more control over the output format, see virDomainCoreDumpWithFormat(). r zvirDomainCoreDump() failedrL )r ZvirDomainCoreDumprc r )r �tor7 r9 r r r �coreDump s zvirDomain.coreDumpc C s& t j| j|||�}|dkr"td��|S )a� This method will dump the core of a domain on a given file for analysis.
Note that for remote Xen Daemon the file path will be interpreted in
the remote host. Hypervisors may require the user to manually ensure
proper permissions on the file named by @to.
@dumpformat controls which format the dump will have; use of
VIR_DOMAIN_CORE_DUMP_FORMAT_RAW mirrors what virDomainCoreDump() will
perform. Not all hypervisors are able to support all formats.
If @flags includes VIR_DUMP_CRASH, then leave the guest shut off with
a crashed state after the dump completes. If @flags includes
VIR_DUMP_LIVE, then make the core dump while continuing to allow
the guest to run; otherwise, the guest is suspended during the dump.
VIR_DUMP_RESET flag forces reset of the guest after dump.
The above three flags are mutually exclusive.
Additionally, if @flags includes VIR_DUMP_BYPASS_CACHE, then libvirt
will attempt to bypass the file system cache while creating the file,
or fail if it cannot do so for the given system; this can allow less
pressure on file system cache, but also risks slowing saves to NFS. r z$virDomainCoreDumpWithFormat() failedrL )r ZvirDomainCoreDumpWithFormatrc r )r r� Z
dumpformatr7 r9 r r r �coreDumpWithFormat( s z virDomain.coreDumpWithFormatc C s t j| j�}|dkr td��|S )a Launch a defined domain. If the call succeeds the domain moves from the
defined to the running domains pools. The domain will be paused only
if restoring from managed state created from a paused domain. For more
control, see virDomainCreateWithFlags(). r zvirDomainCreate() failedrL )r ZvirDomainCreaterc r )r r9 r r r �createB s zvirDomain.createc C s" t j| j|�}|dkr td��|S )a� Launch a defined domain. If the call succeeds the domain moves from the
defined to the running domains pools.
If the VIR_DOMAIN_START_PAUSED flag is set, or if the guest domain
has a managed save image that requested paused state (see
virDomainManagedSave()) the guest domain will be started, but its
CPUs will remain paused. The CPUs can later be manually started
using virDomainResume(). In all other cases, the guest domain will
be running.
If the VIR_DOMAIN_START_AUTODESTROY flag is set, the guest
domain will be automatically destroyed when the virConnectPtr
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. Hypervisors may also block save-to-file,
or snapshots.
If the VIR_DOMAIN_START_BYPASS_CACHE flag is set, and there is a
managed save file for this domain (created by virDomainManagedSave()),
then libvirt will attempt to bypass the file system cache while restoring
the file, or fail if it cannot do so for the given system; this can allow
less pressure on file system cache, but also risks slowing loads from NFS.
If the VIR_DOMAIN_START_FORCE_BOOT flag is set, then any managed save
file for this domain is discarded, and the domain boots from scratch. r z!virDomainCreateWithFlags() failedrL )r ZvirDomainCreateWithFlagsrc r )r r7 r9 r r r �createWithFlagsL s zvirDomain.createWithFlagsc C s$ t j| j||�}|dkr td��|S )a& Dynamically delete an IOThread from the domain. The @iothread_id to be
deleted must not have a resource associated with it and can be any of
the currently valid IOThread ID's.
Note that this call can fail if the underlying virtualization hypervisor
does not support it or if reducing the number is arbitrarily limited.
This function requires privileged access to the hypervisor.
@flags may include VIR_DOMAIN_AFFECT_LIVE or VIR_DOMAIN_AFFECT_CONFIG.
Both flags may be set.
If VIR_DOMAIN_AFFECT_LIVE is set, the change affects a running domain
and may fail if domain is not alive.
If VIR_DOMAIN_AFFECT_CONFIG is set, the change affects persistent state,
and will fail for transient domains. If neither flag is specified (that is,
@flags is VIR_DOMAIN_AFFECT_CURRENT), then an inactive domain modifies
persistent setup, while an active domain is hypervisor-dependent on whether
just live or both live and persistent state is changed. r z virDomainDelIOThread() failedrL )r ZvirDomainDelIOThreadrc r )r rn r7 r9 r r r � delIOThreadl s zvirDomain.delIOThreadc C s t j| j�}|dkr td��|S )a� 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 virDomainPtr object.
This function may require privileged access.
virDomainDestroy first requests that a guest terminate
(e.g. SIGTERM), then waits for it to comply. After a reasonable
timeout, if the guest still exists, virDomainDestroy 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 virDomainDestroyFlags, sending the
VIR_DOMAIN_DESTROY_GRACEFUL flag.
If the domain is transient and has any snapshot metadata (see
virDomainSnapshotNum()), then that metadata will automatically
be deleted when the domain quits. r zvirDomainDestroy() failedrL )r ZvirDomainDestroyrc r )r r9 r r r �destroy� s zvirDomain.destroyc C s" t j| j|�}|dkr td��|S )a� 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 virDomainPtr object.
This function may require privileged access.
Calling this function with no @flags set (equal to zero) is
equivalent to calling virDomainDestroy, 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
VIR_DOMAIN_DESTROY_GRACEFUL in the flags will prevent the forceful
termination of the guest, and virDomainDestroyFlags 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 VIR_DOMAIN_DESTROY_GRACEFUL is appropriate.
Another alternative which may produce cleaner results for the
guest's disks is to use virDomainShutdown() instead, but that
depends on guest support (some hypervisor/guest combinations may
ignore the shutdown request). r z virDomainDestroyFlags() failedrL )r ZvirDomainDestroyFlagsrc r )r r7 r9 r r r � destroyFlags� s zvirDomain.destroyFlagsc C s" t j| j|�}|dkr td��|S )z�This is an equivalent of virDomainDetachDeviceFlags() when called with
@flags parameter set to VIR_DOMAIN_AFFECT_LIVE.
See virDomainDetachDeviceFlags() for more details. r z virDomainDetachDevice() failedrL )r ZvirDomainDetachDevicerc r )r rq r9 r r r � detachDevice� s zvirDomain.detachDevicec C s$ t j| j||�}|dkr td��|S )a� Detach a virtual device from a domain, using the alias to
specify the device. The value of @flags should be either
VIR_DOMAIN_AFFECT_CURRENT, or a bitwise-or of values from
VIR_DOMAIN_AFFECT_LIVE and VIR_DOMAIN_AFFECT_CURRENT, although
hypervisors vary in which flags are supported.
In contrast to virDomainDetachDeviceFlags() this API is
asynchronous - it returns immediately after sending the detach
request to the hypervisor. It's caller's responsibility to
wait for VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED event to signal
actual device removal or for
VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED to signal rejected
device removal. r z#virDomainDetachDeviceAlias() failedrL )r ZvirDomainDetachDeviceAliasrc r )r �aliasr7 r9 r r r �detachDeviceAlias� s zvirDomain.detachDeviceAliasc C s$ t j| j||�}|dkr td��|S )a Detach a virtual device from a domain, using the flags parameter
to control how the device is detached. VIR_DOMAIN_AFFECT_CURRENT
specifies that the device allocation is removed based on current domain
state. VIR_DOMAIN_AFFECT_LIVE specifies that the device shall be
deallocated from the active domain instance only and is not from the
persisted domain configuration. VIR_DOMAIN_AFFECT_CONFIG
specifies that the device shall be deallocated from the persisted domain
configuration only. Note that the target hypervisor must return an
error if unable to satisfy flags. E.g. the hypervisor driver will
return failure if LIVE is specified but it only supports removing the
persisted device allocation.
Some hypervisors may prevent this operation if there is a current
block job running operation on the device being detached; in that case,
use virDomainBlockJobAbort() to stop the block job first.
Beware that depending on the hypervisor and device type, detaching a device
from a running domain may be asynchronous. That is, calling
virDomainDetachDeviceFlags may just request device removal while the device
is actually removed later (in cooperation with a guest OS). Previously,
this fact was ignored and the device could have been removed from domain
configuration before it was actually removed by the hypervisor causing
various failures on subsequent operations. To check whether the device was
successfully removed, either recheck domain configuration using
virDomainGetXMLDesc() or add a handler for the VIR_DOMAIN_EVENT_ID_DEVICE_REMOVED
event. In case the device is already gone when virDomainDetachDeviceFlags
returns, the event is delivered before this API call ends. To help existing
clients work better in most cases, this API will try to transform an
asynchronous device removal that finishes shortly after the request into
a synchronous removal. In other words, this API may wait a bit for the
removal to complete in case it was not synchronous.
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.
The supplied XML description of the device should be as specific
as its definition in the domain XML. The set of attributes used
to match the device are internal to the drivers. Using a partial definition,
or attempting to detach a device that is not present in the domain XML,
but shares some specific attributes with one that is present,
may lead to unexpected results. r z#virDomainDetachDeviceFlags() failedrL )r ZvirDomainDetachDeviceFlagsrc r )r rq r7 r9 r r r �detachDeviceFlags� s +zvirDomain.detachDeviceFlagsc C s" t j| j|�}|dkr td��|S )z Extract errors on disk devices. Nz virDomainGetDiskErrors() failed)r ZvirDomainGetDiskErrorsrc r )r r7 r9 r r r �
diskErrors s zvirDomain.diskErrorsc C s" t j| j|�}|dkr td��|S )zAQuery the CPU affinity setting of the emulator process of domain Nz$virDomainGetEmulatorPinInfo() failed)r ZvirDomainGetEmulatorPinInforc r )r r7 r9 r r r �emulatorPinInfo s zvirDomain.emulatorPinInfoc C s& t j| j|||�}|dkr"td��|S )aM Calls FITRIM within the guest (hence guest agent may be
required depending on hypervisor used). Either call it on each
mounted filesystem (@mountPoint is None) or just on specified
@mountPoint. @minimum hints that free ranges smaller than this
may be ignored (this is a hint and the guest may not respect
it). By increasing this value, the fstrim operation will
complete more quickly for filesystems with badly fragmented
free space, although not all blocks will be discarded.
If @minimum is not zero, the command may fail. r zvirDomainFSTrim() failedrL )r ZvirDomainFSTrimrc r )r Z
mountPointZminimumr7 r9 r r r �fSTrim s
zvirDomain.fSTrimc C s" t j| j|�}|dkr td��|S )zjGet a list of mapping information for each mounted file systems within the specified guest and the disks. NzvirDomainGetFSInfo() failed)r ZvirDomainGetFSInforc r )r r7 r9 r r r �fsInfo* s zvirDomain.fsInfoc C s$ t j| j||�}|dkr td��|S )a� Extracts CPU statistics for a running domain. On success it will
return a list of data of dictionary type. If boolean total is False or 0, the
first element of the list refers to CPU0 on the host, second element is
CPU1, and so on. The format of data struct is as follows:
[{cpu_time:xxx}, {cpu_time:xxx}, ...]
If it is True or 1, it returns total domain CPU statistics in the format of
[{cpu_time:xxx, user_time:xxx, system_time:xxx}] Nz virDomainGetCPUStats() failed)r ZvirDomainGetCPUStatsrc r )r �totalr7 r9 r r r � getCPUStats1 s zvirDomain.getCPUStatsc C s$ t j| j||�}|dkr td��|S )z%Get aggregated info from guest agent Nz virDomainGetGuestInfo() failed)r ZvirDomainGetGuestInforc r )r �typesr7 r9 r r r � guestInfo> s zvirDomain.guestInfoc C s" t j| j|�}|dkr td��|S )zBreturns a dictionary containing information regarding guest vcpus r z virDomainGetGuestVcpus() failedrL )r ZvirDomainGetGuestVcpusrc r )r r7 r9 r r r �
guestVcpusE s zvirDomain.guestVcpusc C s" t j| j|�}|dkr td��|S )z0Determine if the domain has a current snapshot. r z$virDomainHasCurrentSnapshot() failedrL )r ZvirDomainHasCurrentSnapshotrc r )r r7 r9 r r r �hasCurrentSnapshotP s z virDomain.hasCurrentSnapshotc C s" t j| j|�}|dkr td��|S )z�Check if a domain has a managed save image as created by
virDomainManagedSave(). Note that any running domain should not have
such an image, as it should have been removed on restart. r z%virDomainHasManagedSaveImage() failedrL )r Z virDomainHasManagedSaveImagerc r )r r7 r9 r r r �hasManagedSaveImage[ s z virDomain.hasManagedSaveImagec C s" t j| j|�}|dkr td��|S )z�Get the hostname for that domain. If no hostname is found,
then an error is raised with VIR_ERR_NO_HOSTNAME code.
Dependent on hypervisor and @flags used, this may require a
guest agent to be available. Nz virDomainGetHostname() failed)r ZvirDomainGetHostnamerc r )r r7 r9 r r r �hostnamed s zvirDomain.hostnamec C s t j| j�}|dkr td��|S )z�Extract information about a domain. Note that if the connection used to get the domain is limited only a partial set of the information can be extracted. NzvirDomainGetInfo() failed)r ZvirDomainGetInforc r )r r9 r r r �infos s zvirDomain.infoc C s" t j| j|�}|dkr td��|S )zSend NMI to the guest r zvirDomainInjectNMI() failedrL )r ZvirDomainInjectNMIrc r )r r7 r9 r r r � injectNMI~ s zvirDomain.injectNMIc C s$ t j| j||�}|dkr td��|S )zPreturns a dictionary of domain interfaces along with their MAC and IP addresses Nz$virDomainInterfaceAddresses() failed)r ZvirDomainInterfaceAddressesrc r )r �sourcer7 r9 r r r �interfaceAddresses� s z virDomain.interfaceAddressesc C s$ t j| j||�}|dkr td��|S )z2Get the bandwidth tunables for a interface device Nz(virDomainGetInterfaceParameters() failed)r Z virDomainGetInterfaceParametersrc r )r �devicer7 r9 r r r �interfaceParameters� s z virDomain.interfaceParametersc C s" t j| j|�}|dkr td��|S )z2Extracts interface device statistics for a domain Nz virDomainInterfaceStats() failed)r ZvirDomainInterfaceStatsrc r )r r� r9 r r r �interfaceStats� s zvirDomain.interfaceStatsc C s" t j| j|�}|dkr td��|S )z>Query the CPU affinity setting of the IOThreads of the domain Nz!virDomainGetIOThreadInfo() failed)r ZvirDomainGetIOThreadInforc r )r r7 r9 r r r � ioThreadInfo� s zvirDomain.ioThreadInfoc C s t j| j�}|dkr td��|S )z-Determine if the domain is currently running r zvirDomainIsActive() failedrL )r ZvirDomainIsActiverc r )r r9 r r r �isActive� s zvirDomain.isActivec C s t j| j�}|dkr td��|S )zsDetermine if the domain has a persistent configuration
which means it will still exist after shutting down r z virDomainIsPersistent() failedrL )r ZvirDomainIsPersistentrc r )r r9 r r r � isPersistent� s zvirDomain.isPersistentc C s t j| j�}|dkr td��|S )z*Determine if the domain has been updated. r zvirDomainIsUpdated() failedrL )r ZvirDomainIsUpdatedrc r )r r9 r r r � isUpdated� s zvirDomain.isUpdatedc C s t j| j�}|dkr td��|S )zFExtract information about an active job being processed for a domain. Nz virDomainGetJobInfo() failed)r ZvirDomainGetJobInforc r )r r9 r r r �jobInfo� s zvirDomain.jobInfoc C s" t j| j|�}|dkr td��|S )zFExtract information about an active job being processed for a domain. Nz virDomainGetJobStats() failed)r ZvirDomainGetJobStatsrc r )r r7 r9 r r r �jobStats� s zvirDomain.jobStatsc C s" t j| j|�}|dkr td��|S )z&Get launch security info for a domain Nz'virDomainGetLaunchSecurityInfo() failed)r Z virDomainGetLaunchSecurityInforc r )r r7 r9 r r r �launchSecurityInfo� s z virDomain.launchSecurityInfoc C s" t j| j|�}|dkr td��|S )a This method will suspend a domain and save its memory contents to
a file on disk. After the call, if successful, the domain is not
listed as running anymore.
The difference from virDomainSave() is that libvirt is keeping track of
the saved state itself, and will reuse it once the domain is being
restarted (automatically or via an explicit libvirt call).
As a result any running domain is sure to not have a managed saved image.
This also implies that managed save only works on persistent domains,
since the domain must still exist in order to use virDomainCreate() to
restart it.
If @flags includes VIR_DOMAIN_SAVE_BYPASS_CACHE, then libvirt will
attempt to bypass the file system cache while creating the file, or
fail if it cannot do so for the given system; this can allow less
pressure on file system cache, but also risks slowing saves to NFS.
Normally, the managed saved state will remember whether the domain
was running or paused, and start will resume to the same state.
Specifying VIR_DOMAIN_SAVE_RUNNING or VIR_DOMAIN_SAVE_PAUSED in
@flags will override the default saved into the file. These two
flags are mutually exclusive. r z virDomainManagedSave() failedrL )r ZvirDomainManagedSaverc r )r r7 r9 r r r � managedSave� s zvirDomain.managedSavec C s$ t j| j||�}|dkr td��|S )a� This updates the definition of a domain stored in a saved state
file.
@dxml can be used to alter host-specific portions of the domain XML
that will be used on the next start of the domain. For example, it is
possible to alter the backing filename that is associated with a
disk device.
Normally, the saved state file will remember whether the domain was
running or paused, and restore defaults to the same state.
Specifying VIR_DOMAIN_SAVE_RUNNING or VIR_DOMAIN_SAVE_PAUSED in
@flags will override the default saved into the file; omitting both
leaves the file's default unchanged. These two flags are mutually
exclusive. r z&virDomainManagedSaveDefineXML() failedrL )r Z virDomainManagedSaveDefineXMLrc r )r �dxmlr7 r9 r r r �managedSaveDefineXML� s z virDomain.managedSaveDefineXMLc C s" t j| j|�}|dkr td��|S )a This method will extract the XML description of the managed save
state file of a domain.
No security-sensitive data will be included unless @flags contains
VIR_DOMAIN_SAVE_IMAGE_XML_SECURE; this flag is rejected on read-only
connections. Nz'virDomainManagedSaveGetXMLDesc() failed)r Z virDomainManagedSaveGetXMLDescrc r )r r7 r9 r r r �managedSaveGetXMLDesc s z virDomain.managedSaveGetXMLDescc C s" t j| j|�}|dkr td��|S )z/Remove any managed save image for this domain. r z#virDomainManagedSaveRemove() failedrL )r ZvirDomainManagedSaveRemoverc r )r r7 r9 r r r �managedSaveRemove s zvirDomain.managedSaveRemovec C s t j| j�}|dkr td��|S )z�Retrieve the maximum amount of physical memory allocated to a
domain. If domain is None, then this get the amount of memory reserved
to Domain0 i.e. the domain where the application runs. r z virDomainGetMaxMemory() failed)r ZvirDomainGetMaxMemoryrc r )r r9 r r r � maxMemory s zvirDomain.maxMemoryc C s t j| j�}|dkr td��|S )aR Provides the maximum number of virtual CPUs supported for
the guest VM. If the guest is inactive, this is basically
the same as virConnectGetMaxVcpus(). If the guest is running
this will reflect the maximum number of virtual CPUs the
guest was booted with. For more details, see virDomainGetVcpusFlags(). r z virDomainGetMaxVcpus() failedrL )r ZvirDomainGetMaxVcpusrc r )r r9 r r r �maxVcpus' s zvirDomain.maxVcpusc C s" t j| j|�}|dkr td��|S )zGet the memory parameters Nz%virDomainGetMemoryParameters() failed)r Z virDomainGetMemoryParametersrc r )r r7 r9 r r r �memoryParameters6 s zvirDomain.memoryParametersc C s& t j| j|||�}|dkr"td��|S )z%Read the contents of domain's memory Nz virDomainMemoryPeek() failed)r ZvirDomainMemoryPeekrc r )r �startr� r7 r9 r r r �
memoryPeek= s zvirDomain.memoryPeekc C s t j| j�}|dkr td��|S )z(Extracts memory statistics for a domain Nz virDomainMemoryStats() failed)r ZvirDomainMemoryStatsrc r )r r9 r r r � memoryStatsD s zvirDomain.memoryStatsc C s" t j| j|�}|dkr td��|S )z0Fetch list of messages reported against domain. Nz virDomainGetMessages() failed)r ZvirDomainGetMessagesrc r )r r7 r9 r r r �messagesK s zvirDomain.messagesc C s& t j| j|||�}|dkr"td��|S )as Retrieves the appropriate domain element given by @type.
If VIR_DOMAIN_METADATA_ELEMENT is requested parameter @uri
must be set to the name of the namespace the requested elements
belong to, otherwise must be None.
If an element of the domain XML is not present, the resulting
error will be VIR_ERR_NO_DOMAIN_METADATA. This method forms
a shortcut for seeing information from virDomainSetMetadata()
without having to go through virDomainGetXMLDesc().
@flags controls whether the live domain or persistent
configuration will be queried. Nz virDomainGetMetadata() failed)r ZvirDomainGetMetadatarc r )r rb r5 r7 r9 r r r �metadataV s
zvirDomain.metadatac C sL |dkrd}n|j }tj| j |||||�}|dkr:td��t| j|d�}|S )a
Migrate the domain object from its current host to the destination
host given by dconn (a connection to the destination host).
This function is similar to virDomainMigrate3, but it only supports a fixed
set of parameters: @dname corresponds to VIR_MIGRATE_PARAM_DEST_NAME, @uri
is VIR_MIGRATE_PARAM_URI, and @bandwidth is VIR_MIGRATE_PARAM_BANDWIDTH.
virDomainFree should be used to free the resources after the
returned domain object is no longer needed. NzvirDomainMigrate() failed)r8 )rc r ZvirDomainMigrater r ra ) r �dconnr7 �dnamer5 r �dconn__or9 r� r r r �migrateh s
zvirDomain.migratec
C sN |dkrd}n|j }tj| j ||||||�}|dkr<td��t| j|d�} | S )a7 Migrate the domain object from its current host to the destination
host given by dconn (a connection to the destination host).
This function is similar to virDomainMigrate3, but it only supports a fixed
set of parameters: @dxml corresponds to VIR_MIGRATE_PARAM_DEST_XML, @dname
is VIR_MIGRATE_PARAM_DEST_NAME, @uri is VIR_MIGRATE_PARAM_URI, and
@bandwidth is VIR_MIGRATE_PARAM_BANDWIDTH.
virDomainFree should be used to free the resources after the
returned domain object is no longer needed. NzvirDomainMigrate2() failed)r8 )rc r ZvirDomainMigrate2r r ra )
r r� r� r7 r� r5 r r� r9 r� r r r �migrate2| s zvirDomain.migrate2c C sH |dkrd}n|j }tj| j |||�}|dkr6td��t| j|d�}|S )z�Migrate the domain object from its current host to the destination host
given by dconn (a connection to the destination host). NzvirDomainMigrate3() failed)r8 )rc r ZvirDomainMigrate3r r ra )r r� r� r7 r� r9 r� r r r �migrate3� s zvirDomain.migrate3c C s t j| j|�}|S )z�Get current size of the cache (in bytes) used for compressing
repeatedly transferred memory pages during live migration. )r Z#virDomainMigrateGetCompressionCacherc )r r7 r9 r r r �migrateGetCompressionCache� s z$virDomain.migrateGetCompressionCachec C s t j| j|�}|S )z{Get the current value of the maximum downtime (in milliseconds)
allowed during a migration of a guest. )r Z virDomainMigrateGetMaxDowntimerc )r r7 r9 r r r �migrateGetMaxDowntime� s z virDomain.migrateGetMaxDowntimec C s" t j| j|�}|dkr td��|S )z>Get currently configured maximum migration speed for a domain r z$virDomainMigrateGetMaxSpeed() failedrL )r ZvirDomainMigrateGetMaxSpeedrc r )r r7 r9 r r r �migrateGetMaxSpeed� s z virDomain.migrateGetMaxSpeedc C s$ t j| j||�}|dkr td��|S )aO Sets size of the cache (in bytes) used for compressing repeatedly
transferred memory pages during live migration. It's supposed to be called
while the domain is being live-migrated as a reaction to migration progress
and increasing number of compression cache misses obtained from
virDomainGetJobStats. r z,virDomainMigrateSetCompressionCache() failedrL )r Z#virDomainMigrateSetCompressionCacherc r )r Z cacheSizer7 r9 r r r �migrateSetCompressionCache� s z$virDomain.migrateSetCompressionCachec C s$ t j| j||�}|dkr td��|S )z�Sets maximum tolerable time for which the domain is allowed to be paused
at the end of live migration. It's supposed to be called while the domain is
being live-migrated as a reaction to migration progress. r z'virDomainMigrateSetMaxDowntime() failedrL )r Z virDomainMigrateSetMaxDowntimerc r )r �downtimer7 r9 r r r �migrateSetMaxDowntime� s z virDomain.migrateSetMaxDowntimec C s$ t j| j||�}|dkr td��|S )aO The maximum bandwidth (in MiB/s) that will be used to do migration
can be specified with the bandwidth parameter. Not all hypervisors
will support a bandwidth cap. When VIR_DOMAIN_MIGRATE_MAX_SPEED_POSTCOPY
is set in @flags, this API sets the maximum bandwidth for the post-copy
phase of the migration. r z$virDomainMigrateSetMaxSpeed() failedrL )r ZvirDomainMigrateSetMaxSpeedrc r )r r r7 r9 r r r �migrateSetMaxSpeed� s z virDomain.migrateSetMaxSpeedc C s" t j| j|�}|dkr td��|S )a� Starts post-copy migration. This function has to be called while
migration (initiated with VIR_MIGRATE_POSTCOPY flag) is in progress.
Traditional pre-copy migration iteratively walks through guest memory
pages and migrates those that changed since the previous iteration. The
iterative phase stops when the number of dirty pages is low enough so that
the virtual CPUs can be paused, all dirty pages transferred to the
destination, where the virtual CPUs are unpaused, and all this can happen
within a predefined downtime period. It's clear that this process may never
converge if downtime is too short and/or the guest keeps changing a lot of
memory pages.
When migration is switched to post-copy mode, the virtual CPUs are paused
immediately, only a minimum set of pages is transferred, and the CPUs are
unpaused on destination. The source keeps sending all remaining memory pages
to the destination while the guest is already running there. Whenever the
guest tries to read a memory page which has not been migrated yet, the
hypervisor has to tell the source to transfer that page in a priority
channel. To minimize such page faults, it is a good idea to run at least one
iteration of pre-copy migration before switching to post-copy.
Post-copy migration is guaranteed to converge since each page is transferred
at most once no matter how fast it changes. On the other hand once the
guest is running on the destination host, the migration can no longer be
rolled back because none of the hosts has complete state. If this happens,
libvirt will leave the domain paused on both hosts with
VIR_DOMAIN_PAUSED_POSTCOPY_FAILED reason. It's up to the upper layer to
decide what to do in such case. Because of this, libvirt will refuse to
cancel post-copy migration via virDomainAbortJob.
The following domain life cycle events are emitted during post-copy
migration:
VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY (on the source) -- migration entered
post-copy mode.
VIR_DOMAIN_EVENT_RESUMED_POSTCOPY (on the destination) -- the guest is
running on the destination host while some of its memory pages still
remain on the source host; neither the source nor the destination host
contain a complete guest state from this point until migration
finishes.
VIR_DOMAIN_EVENT_RESUMED_MIGRATED (on the destination),
VIR_DOMAIN_EVENT_STOPPED_MIGRATED (on the source) -- migration finished
successfully and the destination host holds a complete guest state.
VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY_FAILED (on the destination) -- emitted
when migration fails in post-copy mode and it's unclear whether any
of the hosts has a complete guest state.
The progress of a post-copy migration can be monitored normally using
virDomainGetJobStats on the source host. Fetching statistics of a completed
post-copy migration can also be done on the source host (by calling
virDomainGetJobStats or listening to VIR_DOMAIN_EVENT_ID_JOB_COMPLETED
event, but (in contrast to pre-copy migration) the statistics are not
available on the destination host. Thus, VIR_DOMAIN_EVENT_ID_JOB_COMPLETED
event is the only way of getting statistics of a completed post-copy
migration of a transient domain (because the domain is removed after
migration and there's no domain to run virDomainGetJobStats on). r z&virDomainMigrateStartPostCopy() failedrL )r Z virDomainMigrateStartPostCopyrc r )r r7 r9 r r r �migrateStartPostCopy� s 8z virDomain.migrateStartPostCopyc C s( t j| j||||�}|dkr$td��|S )a� Migrate the domain object from its current host to the destination
host given by duri.
This function is similar to virDomainMigrateToURI3, but it only supports a
fixed set of parameters: @dname corresponds to VIR_MIGRATE_PARAM_DEST_NAME,
and @bandwidth corresponds to VIR_MIGRATE_PARAM_BANDWIDTH.
The operation of this API hinges on the VIR_MIGRATE_PEER2PEER flag.
If the VIR_MIGRATE_PEER2PEER flag IS set, the @duri parameter must be a
valid libvirt connection URI, by which the source libvirt driver can connect
to the destination libvirt. In other words, @duri corresponds to @dconnuri
of virDomainMigrateToURI3.
If the VIR_MIGRATE_PEER2PEER flag is NOT set, the @duri parameter takes a
hypervisor specific URI used to initiate the migration. In this case @duri
corresponds to VIR_MIGRATE_PARAM_URI of virDomainMigrateToURI3. r z virDomainMigrateToURI() failedrL )r ZvirDomainMigrateToURIrc r )r Zdurir7 r� r r9 r r r � migrateToURI s zvirDomain.migrateToURIc C s, t j| j||||||�}|dkr(td��|S )aI Migrate the domain object from its current host to the destination
host given by @dconnuri.
This function is similar to virDomainMigrateToURI3, but it only supports a
fixed set of parameters: @miguri corresponds to VIR_MIGRATE_PARAM_URI, @dxml
is VIR_MIGRATE_PARAM_DEST_XML, @dname is VIR_MIGRATE_PARAM_DEST_NAME, and
@bandwidth corresponds to VIR_MIGRATE_PARAM_BANDWIDTH.
The operation of this API hinges on the VIR_MIGRATE_PEER2PEER flag.
If the VIR_MIGRATE_PEER2PEER flag IS set, the @dconnuri parameter must be a
valid libvirt connection URI, by which the source libvirt driver can connect
to the destination libvirt. In other words, @dconnuri has the same semantics
as in virDomainMigrateToURI3.
If the VIR_MIGRATE_PEER2PEER flag is NOT set, the @dconnuri must be None
and the @miguri parameter takes a hypervisor specific URI used to initiate
the migration. In this case @miguri corresponds to VIR_MIGRATE_PARAM_URI of
virDomainMigrateToURI3. r z virDomainMigrateToURI2() failedrL )r ZvirDomainMigrateToURI2rc r )r �dconnuriZmigurir� r7 r� r r9 r r r �
migrateToURI2, s zvirDomain.migrateToURI2c C s& t j| j|||�}|dkr"td��|S )zjMigrate the domain object from its current host to the destination host
given by URI. r z virDomainMigrateToURI3() failedrL )r ZvirDomainMigrateToURI3rc r )r r� r� r7 r9 r r r �
migrateToURI3I s zvirDomain.migrateToURI3c C s t j| j�}|S )z$Get the public name for that domain )r ZvirDomainGetNamerc )r r9 r r r r; U s zvirDomain.namec C s" t j| j|�}|dkr td��|S )zGet the NUMA parameters Nz#virDomainGetNumaParameters() failed)r ZvirDomainGetNumaParametersrc r )r r7 r9 r r r �numaParameters^ s zvirDomain.numaParametersc C s: |dkrd}n|j }tj| j |||�}|dkr6td��|S )a� This opens the host interface associated with a channel device on a
guest, if the host interface is supported. If @name is given, it
can match either the device alias (e.g. "channel0"), or the virtio
target name (e.g. "org.qemu.guest_agent.0"). If @name is omitted,
then the first channel is opened. The channel is associated with
the passed in @st stream, which should have been opened in
non-blocking mode for bi-directional I/O.
By default, when @flags is 0, the open will fail if libvirt detects
that the channel is already in use by another client; passing
VIR_DOMAIN_CHANNEL_FORCE will cause libvirt to forcefully remove the
other client prior to opening this channel. Nr z virDomainOpenChannel() failedrL )rc r ZvirDomainOpenChannelr )r r; �str7 �st__or9 r r r � openChanneli s
zvirDomain.openChannelc C s: |dkrd}n|j }tj| j |||�}|dkr6td��|S )a� This opens the backend associated with a console, serial or
parallel port device on a guest, if the backend is supported.
If the @dev_name is omitted, then the first console or serial
device is opened. The console is associated with the passed
in @st stream, which should have been opened in non-blocking
mode for bi-directional I/O.
By default, when @flags is 0, the open will fail if libvirt
detects that the console is already in use by another client;
passing VIR_DOMAIN_CONSOLE_FORCE will cause libvirt to forcefully
remove the other client prior to opening this console.
If flag VIR_DOMAIN_CONSOLE_SAFE the console is opened only in the
case where the hypervisor driver supports safe (mutually exclusive)
console handling.
Older servers did not support either flag, and also did not forbid
simultaneous clients on a console, with potentially confusing results.
When passing @flags of 0 in order to support a wider range of server
versions, it is up to the client to ensure mutual exclusion. Nr z virDomainOpenConsole() failedrL )rc r ZvirDomainOpenConsoler )r Zdev_namer� r7 r� r9 r r r � openConsole s zvirDomain.openConsolec C s& t j| j|||�}|dkr"td��|S )a� This will attempt to connect the file descriptor @fd, to
the graphics backend of @dom. If @dom has multiple graphics
backends configured, then @idx will determine which one is
opened, starting from @idx 0.
To disable any authentication, pass the VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH
constant for @flags.
The caller should use an anonymous socketpair to open
@fd before invocation.
This method can only be used when connected to a local
libvirt hypervisor, over a UNIX domain socket. Attempts
to use this method over a TCP connection will always fail r z virDomainOpenGraphics() failedrL )r ZvirDomainOpenGraphicsrc r )r �idxr> r7 r9 r r r � openGraphics� s zvirDomain.openGraphicsc C s$ t j| j||�}|dkr td��|S )a� This will create a socket pair connected to the graphics backend of @dom.
One end of the socket will be returned on success, and the other end is
handed to the hypervisor.
If @dom has multiple graphics backends configured, then @idx will determine
which one is opened, starting from @idx 0.
To disable any authentication, pass the VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH
constant for @flags.
This method can only be used when connected to a local
libvirt hypervisor, over a UNIX domain socket. Attempts
to use this method over a TCP connection will always fail. r z virDomainOpenGraphicsFD() failedrL )r ZvirDomainOpenGraphicsFDrc r )r r� r7 r9 r r r �openGraphicsFD� s
zvirDomain.openGraphicsFDc C s& t j| j|||�}|dkr"td��|S )a] Attempt to have the guest enter the given @target power management
suspension level. If @duration is non-zero, also schedule the guest to
resume normal operation after that many seconds, if nothing else has
resumed it earlier. Some hypervisors require that @duration be 0, for
an indefinite suspension.
Dependent on hypervisor used, this may require a
guest agent to be available, e.g. QEMU.
Beware that at least for QEMU, the domain's process will be terminated
when VIR_NODE_SUSPEND_TARGET_DISK is used and a new process will be
launched when libvirt is asked to wake up the domain. As a result of
this, any runtime changes, such as device hotplug or memory settings,
are lost unless such changes were made with VIR_DOMAIN_AFFECT_CONFIG
flag. r z&virDomainPMSuspendForDuration() failedrL )r Z virDomainPMSuspendForDurationrc r )r �target�durationr7 r9 r r r �pMSuspendForDuration� s z virDomain.pMSuspendForDurationc C s" t j| j|�}|dkr td��|S )z�Inject a wakeup into the guest that previously used
virDomainPMSuspendForDuration, rather than waiting for the
previously requested duration (if any) to elapse. r zvirDomainPMWakeup() failedrL )r ZvirDomainPMWakeuprc r )r r7 r9 r r r �pMWakeup� s zvirDomain.pMWakeupc C s" t j| j|�}|dkr td��|S )z Get all perf events setting. Nz virDomainGetPerfEvents() failed)r ZvirDomainGetPerfEventsrc r )r r7 r9 r r r �
perfEvents� s zvirDomain.perfEventsc C s$ t j| j||�}|dkr td��|S )z�Dynamically change the real CPUs which can be allocated to the emulator process of a domain.
This function requires privileged access to the hypervisor. r z virDomainPinEmulator() failedrL )r ZvirDomainPinEmulatorrc r )r �cpumapr7 r9 r r r � pinEmulator� s zvirDomain.pinEmulatorc C s& t j| j|||�}|dkr"td��|S )z�Dynamically change the real CPUs which can be allocated to an IOThread. This function requires privileged access to the hypervisor. r z virDomainPinIOThread() failedrL )r ZvirDomainPinIOThreadrc r )r � iothread_valr� r7 r9 r r r � pinIOThread� s zvirDomain.pinIOThreadc C s$ t j| j||�}|dkr td��|S )z�Dynamically change the real CPUs which can be allocated to a virtual CPU. This function requires privileged access to the hypervisor. r zvirDomainPinVcpu() failedrL )r ZvirDomainPinVcpurc r )r �vcpur� r9 r r r �pinVcpu� s zvirDomain.pinVcpuc C s& t j| j|||�}|dkr"td��|S )z�Dynamically change the real CPUs which can be allocated to a virtual CPU. This function requires privileged access to the hypervisor. r z virDomainPinVcpuFlags() failedrL )r ZvirDomainPinVcpuFlagsrc r )r r� r� r7 r9 r r r � pinVcpuFlags s zvirDomain.pinVcpuFlagsc C s" t j| j|�}|dkr td��|S )aT Reboot a domain, the domain object is still usable thereafter, but
the domain OS is being stopped for a restart.
Note that the guest OS may ignore the request.
Additionally, the hypervisor may check and support the domain
'on_reboot' XML setting resulting in a domain that shuts down instead
of rebooting.
If @flags is set to zero, then the hypervisor will choose the
method of shutdown it considers best. To have greater control
pass one or more of the virDomainRebootFlagValues. The order
in which the hypervisor tries each shutdown method is undefined,
and a hypervisor is not required to support all methods.
To use guest agent (VIR_DOMAIN_REBOOT_GUEST_AGENT) the domain XML
must have <channel> configured.
Due to implementation limitations in some drivers (the qemu driver,
for instance) it is not advised to migrate or save a guest that is
rebooting as a result of this API. Migrating such a guest can lead
to a plain shutdown on the destination. r zvirDomainReboot() failedrL )r ZvirDomainRebootrc r )r r7 r9 r r r �reboot
s zvirDomain.rebootc C s$ t j| j||�}|dkr td��|S )a� Rename a domain. New domain name is specified in the second
argument. Depending on each driver implementation it may be
required that domain is in a specific state.
There might be some attributes and/or elements in domain XML that if no
value provided at XML defining time, libvirt will derive their value from
the domain name. These are not updated by this API. Users are strongly
advised to change these after the rename was successful. r zvirDomainRename() failedrL )r ZvirDomainRenamerc r )r �new_namer7 r9 r r r �rename' s zvirDomain.renamec C s" t j| j|�}|dkr td��|S )a8 Reset a domain immediately without any guest OS shutdown.
Reset emulates the power reset button on a machine, where all
hardware sees the RST line set and reinitializes internal state.
Note that there is a risk of data loss caused by reset without any
guest OS shutdown. r zvirDomainReset() failedrL )r ZvirDomainResetrc r )r r7 r9 r r r �reset5 s zvirDomain.resetc C s t j| j�}|dkr td��|S )a( Resume a suspended domain, the process is restarted from the state where
it was frozen by calling virDomainSuspend().
This function may require privileged access
Moreover, resume may not be supported if domain is in some
special state like VIR_DOMAIN_PMSUSPENDED. r zvirDomainResume() failedrL )r ZvirDomainResumerc r )r r9 r r r �resumeA s zvirDomain.resumec C s8 |dkrd}n|j }tj| j ||�}|dkr4td��|S )z(revert the domain to the given snapshot Nr z"virDomainRevertToSnapshot() failedrL )rc r ZvirDomainRevertToSnapshotr )r Zsnapr7 Zsnap__or9 r r r �revertToSnapshotP s zvirDomain.revertToSnapshotc C s" t j| j|�}|dkr td��|S )a� This method will suspend a domain and save its memory contents to
a file on disk. After the call, if successful, the domain is not
listed as running anymore (this ends the life of a transient domain).
Use virDomainRestore() to restore a domain after saving.
See virDomainSaveFlags() for more control. Also, a save file can
be inspected or modified slightly with virDomainSaveImageGetXMLDesc()
and virDomainSaveImageDefineXML(). r zvirDomainSave() failedrL )r Z
virDomainSaverc r )r r� r9 r r r �save_ s zvirDomain.savec C s& t j| j|||�}|dkr"td��|S )a� This method will suspend a domain and save its memory contents to
a file on disk. After the call, if successful, the domain is not
listed as running anymore (this ends the life of a transient domain).
Use virDomainRestore() to restore a domain after saving.
If the hypervisor supports it, @dxml can be used to alter
host-specific portions of the domain XML that will be used when
restoring an image. For example, it is possible to alter the
backing filename that is associated with a disk device, in order to
prepare for file renaming done as part of backing up the disk
device while the domain is stopped.
If @flags includes VIR_DOMAIN_SAVE_BYPASS_CACHE, then libvirt will
attempt to bypass the file system cache while creating the file, or
fail if it cannot do so for the given system; this can allow less
pressure on file system cache, but also risks slowing saves to NFS.
Normally, the saved state file will remember whether the domain was
running or paused, and restore defaults to the same state.
Specifying VIR_DOMAIN_SAVE_RUNNING or VIR_DOMAIN_SAVE_PAUSED in
@flags will override what state gets saved into the file. These
two flags are mutually exclusive.
A save file can be inspected or modified slightly with
virDomainSaveImageGetXMLDesc() and virDomainSaveImageDefineXML().
Some hypervisors may prevent this operation if there is a current
block job running; in that case, use virDomainBlockJobAbort()
to stop the block job first. r zvirDomainSaveFlags() failedrL )r ZvirDomainSaveFlagsrc r )r r� r� r7 r9 r r r � saveFlagsm s zvirDomain.saveFlagsc C s t j| j�}|dkr td��|S )zPGet the scheduler parameters, the @params array will be filled with the values. Nz(virDomainGetSchedulerParameters() failed)r Z virDomainGetSchedulerParametersrc r )r r9 r r r �schedulerParameters� s z virDomain.schedulerParametersc C s" t j| j|�}|dkr td��|S )z Get the scheduler parameters Nz-virDomainGetSchedulerParametersFlags() failed)r Z$virDomainGetSchedulerParametersFlagsrc r )r r7 r9 r r r �schedulerParametersFlags� s z"virDomain.schedulerParametersFlagsc C s t j| j�}|dkr td��|S )zGet the scheduler type. Nz"virDomainGetSchedulerType() failed)r ZvirDomainGetSchedulerTyperc r )r r9 r r r �
schedulerType� s zvirDomain.schedulerTypec C s: |dkrd}n|j }tj| j |||�}|dkr6td��|S )a� Take a screenshot of current domain console as a stream. The image format
is hypervisor specific. Moreover, some hypervisors supports multiple
displays per domain. These can be distinguished by @screen argument.
This call sets up a stream; subsequent use of stream API is necessary
to transfer actual data, determine how much data is successfully
transferred, and detect any errors.
The screen ID is the sequential number of screen. In case of multiple
graphics cards, heads are enumerated before devices, e.g. having
two graphics cards, both with four heads, screen ID 5 addresses
the second head on the second card. Nz virDomainScreenshot() failed)rc r ZvirDomainScreenshotr )r �streamZscreenr7 � stream__or9 r r r �
screenshot� s
zvirDomain.screenshotc C s t j| j�}|dkr td��|S )z\Extract information about the domain security label. Only the first label will be returned. Nz"virDomainGetSecurityLabel() failed)r ZvirDomainGetSecurityLabelrc r )r r9 r r r �
securityLabel� s zvirDomain.securityLabelc C s t j| j�}|dkr td��|S )z\Extract information about the domain security label. A list of all labels will be returned. Nz&virDomainGetSecurityLabelList() failed)r Z virDomainGetSecurityLabelListrc r )r r9 r r r �securityLabelList� s zvirDomain.securityLabelListc C s* t j| j|||||�}|dkr&td��|S )zSend key(s) to the guest. r zvirDomainSendKey() failedrL )r ZvirDomainSendKeyrc r )r ZcodesetZholdtimeZkeycodesZ nkeycodesr7 r9 r r r �sendKey� s zvirDomain.sendKeyc C s& t j| j|||�}|dkr"td��|S )a� Send a signal to the designated process in the guest
The signal numbers must be taken from the virDomainProcessSignal
enum. These will be translated to the corresponding signal
number for the guest OS, by the guest agent delivering the
signal. If there is no mapping from virDomainProcessSignal to
the native OS signals, this API will report an error.
If @pid_value is an integer greater than zero, it is
treated as a process ID. If @pid_value is an integer
less than zero, it is treated as a process group ID.
All the @pid_value numbers are from the container/guest
namespace. The value zero is not valid.
Not all hypervisors will support sending signals to
arbitrary processes or process groups. If this API is
implemented the minimum requirement is to be able to
use @pid_value == 1 (i.e. kill init). No other value is
required to be supported.
If the @signum is VIR_DOMAIN_PROCESS_SIGNAL_NOP then this
API will simply report whether the process is running in
the container/guest. r z#virDomainSendProcessSignal() failedrL )r ZvirDomainSendProcessSignalrc r )r Z pid_valueZsignumr7 r9 r r r �sendProcessSignal� s zvirDomain.sendProcessSignalc C s" t j| j|�}|dkr td��|S )zVConfigure the domain to be automatically started
when the host machine boots. r z virDomainSetAutostart() failedrL )r ZvirDomainSetAutostartrc r )r rx r9 r r r � setAutostart� s zvirDomain.setAutostartc C s$ t j| j||�}|dkr td��|S )zChange the blkio tunables r z$virDomainSetBlkioParameters() failedrL )r ZvirDomainSetBlkioParametersrc r )r r� r7 r9 r r r �setBlkioParameters
s z virDomain.setBlkioParametersc C s& t j| j|||�}|dkr"td��|S )z+Change the I/O tunables for a block device r z virDomainSetBlockIoTune() failedrL )r ZvirDomainSetBlockIoTunerc r )r r| r� r7 r9 r r r �setBlockIoTune
s zvirDomain.setBlockIoTunec C s& t j| j|||�}|dkr"td��|S )a� Set the threshold level for delivering the
VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD if the device or backing chain element
described by @dev is written beyond the set threshold level. The threshold
level is unset once the event fires. The event might not be delivered at all
if libvirtd was not running at the moment when the threshold was reached.
Note that if the threshold level is reached for a top level image, the event
is emitted for @dev corresponding to the disk target, and may also be reported
with @dev corresponding to the disk target with an index corresponding to the
'index' attribute of 'source' in the live VM XML if the attribute is present.
@dev can either be a disk target name (vda, sda) or disk target with index (
vda[4]). Without the index the top image in the backing chain will have the
threshold set. The index corresponds to the 'index' attribute reported in the
live VM XML for 'backingStore' or 'source' elements of a disk. If index is
given the threshold is set for the corresponding image.
In case when @dev does not contain index the
VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD event may be emitted twice, once for the
disk device target without index and once containing the index.
Note that the threshold event can be registered also for destinations of a
'virDomainBlockCopy' destination by using the 'index' of the 'mirror' source.
Hypervisors report the last written sector of an image in the bulk stats API
(virConnectGetAllDomainStats/virDomainListGetStats) as
"block.<num>.allocation" in the VIR_DOMAIN_STATS_BLOCK group. The current
threshold value is reported as "block.<num>.threshold".
This event allows to use thin-provisioned storage which needs management
tools to grow it without the need for polling of the data. r z#virDomainSetBlockThreshold() failedrL )r ZvirDomainSetBlockThresholdrc r )r �dev� thresholdr7 r9 r r r �setBlockThreshold
s zvirDomain.setBlockThresholdc C s& t j| j|||�}|dkr"td��|S )a� Sets state of individual vcpus described by @cpumap via guest agent. Other
vcpus are not modified.
This API requires the VM to run. Various hypervisors or guest agent
implementation may limit to operate on just 1 vCPU per call.
@cpumap is a list of vCPU numbers. Its syntax is a comma separated list and
a special markup using '-' and '^' (ex. '0-4', '0-3,^2'). The '-' denotes
the range and the '^' denotes exclusive. The expression is sequentially
evaluated, so "0-15,^8" is identical to "9-14,0-7,15" but not identical to
"^8,0-15".
Note that OSes (notably Linux) may require vCPU 0 to stay online to support
low-level features a S3 sleep. r z virDomainSetGuestVcpus() failedrL )r ZvirDomainSetGuestVcpusrc r )r r� �stater7 r9 r r r �
setGuestVcpus?
s zvirDomain.setGuestVcpusc C s& t j| j|||�}|dkr"td��|S )z�Dynamically allow changing the IOThread polling related parameters. This function requires privileged access to the hypervisor. r z#virDomainSetIOThreadParams() failedrL )r ZvirDomainSetIOThreadParamsrc r )r r� r� r7 r9 r r r �setIOThreadParamsW
s zvirDomain.setIOThreadParamsc C s& t j| j|||�}|dkr"td��|S )z5Change the bandwidth tunables for a interface device r z(virDomainSetInterfaceParameters() failedrL )r Z virDomainSetInterfaceParametersrc r )r r� r� r7 r9 r r r �setInterfaceParameters^
s z virDomain.setInterfaceParametersc C s$ t j| j||�}|dkr td��|S )z4Set a launch security secret in the guest's memory. r z(virDomainSetLaunchSecurityState() failedrL )r Z virDomainSetLaunchSecurityStaterc r )r r� r7 r9 r r r �setLaunchSecurityStatee
s z virDomain.setLaunchSecurityStatec C s& t j| j|||�}|dkr"td��|S )a? Changes the actions of lifecycle events for domain represented as
<on_$type>$action</on_$type> in the domain XML.
QEMU driver has a limitation that if all lifecycle events are set
to destroy when the domain is started, it's not possible to change
any action for running domain. r z$virDomainSetLifecycleAction() failedrL )r ZvirDomainSetLifecycleActionrc r )r rb �actionr7 r9 r r r �setLifecycleActionp
s z virDomain.setLifecycleActionc C s" t j| j|�}|dkr td��|S )a� Dynamically change the maximum amount of physical memory allocated to a
domain. If domain is None, then this change the amount of memory reserved
to Domain0 i.e. the domain where the application runs.
This function may require privileged access to the hypervisor.
This command is hypervisor-specific for whether active, persistent,
or both configurations are changed; for more control, use
virDomainSetMemoryFlags(). r z virDomainSetMaxMemory() failedrL )r ZvirDomainSetMaxMemoryrc r )r �memoryr9 r r r � setMaxMemory|
s zvirDomain.setMaxMemoryc C s" t j| j|�}|dkr td��|S )a� Dynamically change the target amount of physical memory allocated to a
domain. If domain is None, then this change the amount of memory reserved
to Domain0 i.e. the domain where the application runs.
This function may require privileged access to the hypervisor.
This command is hypervisor-specific for whether active, persistent,
or both configurations are changed; for more control, use
virDomainSetMemoryFlags(). r zvirDomainSetMemory() failedrL )r ZvirDomainSetMemoryrc r )r r r9 r r r � setMemory�
s zvirDomain.setMemoryc C s$ t j| j||�}|dkr td��|S )aU Dynamically change the target amount of physical memory allocated to a
domain. If domain is None, then this change the amount of memory reserved
to Domain0 i.e. the domain where the application runs.
This function may require privileged access to the hypervisor.
@flags may include VIR_DOMAIN_AFFECT_LIVE or VIR_DOMAIN_AFFECT_CONFIG.
Both flags may be set. If VIR_DOMAIN_AFFECT_LIVE is set, the change affects
a running domain and will fail if domain is not active.
If VIR_DOMAIN_AFFECT_CONFIG is set, the change affects persistent state,
and will fail for transient domains. If neither flag is specified
(that is, @flags is VIR_DOMAIN_AFFECT_CURRENT), then an inactive domain
modifies persistent setup, while an active domain is hypervisor-dependent
on whether just live or both live and persistent state is changed.
If VIR_DOMAIN_MEM_MAXIMUM is set, the change affects domain's maximum memory
size rather than current memory size.
Not all hypervisors can support all flag combinations. r z virDomainSetMemoryFlags() failedrL )r ZvirDomainSetMemoryFlagsrc r )r r r7 r9 r r r �setMemoryFlags�
s zvirDomain.setMemoryFlagsc C s$ t j| j||�}|dkr td��|S )zChange the memory tunables r z%virDomainSetMemoryParameters() failedrL )r Z virDomainSetMemoryParametersrc r )r r� r7 r9 r r r �setMemoryParameters�
s z virDomain.setMemoryParametersc C s$ t j| j||�}|dkr td��|S )aG Dynamically change the domain memory balloon driver statistics collection
period. Use 0 to disable and a positive value to enable.
@flags may include VIR_DOMAIN_AFFECT_LIVE or VIR_DOMAIN_AFFECT_CONFIG.
Both flags may be set. If VIR_DOMAIN_AFFECT_LIVE is set, the change affects
a running domain and will fail if domain is not active.
If VIR_DOMAIN_AFFECT_CONFIG is set, the change affects persistent state,
and will fail for transient domains. If neither flag is specified
(that is, @flags is VIR_DOMAIN_AFFECT_CURRENT), then an inactive domain
modifies persistent setup, while an active domain is hypervisor-dependent
on whether just live or both live and persistent state is changed.
Not all hypervisors can support all flag combinations. r z&virDomainSetMemoryStatsPeriod() failedrL )r Z virDomainSetMemoryStatsPeriodrc r )r Zperiodr7 r9 r r r �setMemoryStatsPeriod�
s z virDomain.setMemoryStatsPeriodc C s* t j| j|||||�}|dkr&td��|S )a� Sets the appropriate domain element given by @type to the
value of @metadata. A @type of VIR_DOMAIN_METADATA_DESCRIPTION
is free-form text; VIR_DOMAIN_METADATA_TITLE is free-form, but no
newlines are permitted, and should be short (although the length is
not enforced). For these two options @key and @uri are irrelevant and
must be set to None.
For type VIR_DOMAIN_METADATA_ELEMENT @metadata must be well-formed
XML belonging to namespace defined by @uri with local name @key.
Passing None for @metadata says to remove that element from the
domain XML (passing the empty string leaves the element present).
The resulting metadata will be present in virDomainGetXMLDesc(),
as well as quick access through virDomainGetMetadata().
@flags controls whether the live domain, persistent configuration,
or both will be modified. r z virDomainSetMetadata() failedrL )r ZvirDomainSetMetadatarc r )r rb r� �keyr5 r7 r9 r r r � setMetadata�
s zvirDomain.setMetadatac C s$ t j| j||�}|dkr td��|S )zChange the NUMA tunables r z#virDomainSetNumaParameters() failedrL )r ZvirDomainSetNumaParametersrc r )r r� r7 r9 r r r �setNumaParameters�
s zvirDomain.setNumaParametersc C s$ t j| j||�}|dkr td��|S )z5Enable or disable the particular list of perf events r z virDomainSetPerfEvents() failedrL )r ZvirDomainSetPerfEventsrc r )r r� r7 r9 r r r �
setPerfEvents�
s zvirDomain.setPerfEventsc C s" t j| j|�}|dkr td��|S )z Change the scheduler parameters r z(virDomainSetSchedulerParameters() failedrL )r Z virDomainSetSchedulerParametersrc r )r r� r9 r r r �setSchedulerParameters�
s z virDomain.setSchedulerParametersc C s$ t j| j||�}|dkr td��|S )z Change the scheduler parameters r z-virDomainSetSchedulerParametersFlags() failedrL )r Z$virDomainSetSchedulerParametersFlagsrc r )r r� r7 r9 r r r �setSchedulerParametersFlags s z%virDomain.setSchedulerParametersFlagsc C s& t j| j|||�}|dkr"td��|S )ac Sets the @user password to the value specified by @password.
If @flags contain VIR_DOMAIN_PASSWORD_ENCRYPTED, the password
is assumed to be encrypted by the method required by the guest OS.
Please note that some hypervisors may require guest agent to
be configured and running in order to be able to run this API. r z!virDomainSetUserPassword() failedrL )r ZvirDomainSetUserPasswordrc r )r rt Zpasswordr7 r9 r r r �setUserPassword s zvirDomain.setUserPasswordc C s& t j| j|||�}|dkr"td��|S )aF Enables/disables individual vcpus described by @vcpumap in the hypervisor.
Various hypervisor implementations may limit to operate on just 1
hotpluggable entity (which may contain multiple vCPUs on certain platforms).
Note that OSes and hypervisors may require vCPU 0 to stay online. r zvirDomainSetVcpu() failedrL )r ZvirDomainSetVcpurc r )r Zvcpumapr r7 r9 r r r �setVcpu s zvirDomain.setVcpuc C s" t j| j|�}|dkr td��|S )a� Dynamically change the number of virtual CPUs used by the domain.
Note that this call may fail if the underlying virtualization hypervisor
does not support it or if growing the number is arbitrarily limited.
This function may require privileged access to the hypervisor.
Note that if this call is executed before the guest has finished booting,
the guest may fail to process the change.
This command only changes the runtime configuration of the domain,
so can only be called on an active domain. It is hypervisor-dependent
whether it also affects persistent configuration; for more control,
use virDomainSetVcpusFlags(). r zvirDomainSetVcpus() failedrL )r ZvirDomainSetVcpusrc r )r �nvcpusr9 r r r �setVcpus$ s
zvirDomain.setVcpusc C s$ t j| j||�}|dkr td��|S )aP Dynamically change the number of virtual CPUs used by the domain.
Note that this call may fail if the underlying virtualization hypervisor
does not support it or if growing the number is arbitrarily limited.
This function may require privileged access to the hypervisor.
@flags may include VIR_DOMAIN_AFFECT_LIVE to affect a running
domain (which may fail if domain is not active), or
VIR_DOMAIN_AFFECT_CONFIG to affect the next boot via the XML
description of the domain. Both flags may be set.
If neither flag is specified (that is, @flags is VIR_DOMAIN_AFFECT_CURRENT),
then an inactive domain modifies persistent setup, while an active domain
is hypervisor-dependent on whether just live or both live and persistent
state is changed.
Note that if this call is executed before the guest has finished booting,
the guest may fail to process the change.
If @flags includes VIR_DOMAIN_VCPU_MAXIMUM, then
VIR_DOMAIN_AFFECT_LIVE must be clear, and only the maximum virtual
CPU limit is altered; generally, this value must be less than or
equal to virConnectGetMaxVcpus(). Otherwise, this call affects the
current virtual CPU limit, which must be less than or equal to the
maximum limit. Note that hypervisors may not allow changing the maximum
vcpu count if processor topology is specified.
If @flags includes VIR_DOMAIN_VCPU_GUEST, then the state of processors is
modified inside the guest instead of the hypervisor. This flag can only
be used with live guests and is incompatible with VIR_DOMAIN_VCPU_MAXIMUM.
The usage of this flag may require a guest agent configured.
Not all hypervisors can support all flag combinations. r z virDomainSetVcpusFlags() failedrL )r ZvirDomainSetVcpusFlagsrc r )r r r7 r9 r r r �
setVcpusFlags6 s zvirDomain.setVcpusFlagsc C s t j| j�}|dkr td��|S )ak Shutdown a domain, the domain object is still usable thereafter, but
the domain OS is being stopped. Note that the guest OS may ignore the
request. Additionally, the hypervisor may check and support the domain
'on_poweroff' XML setting resulting in a domain that reboots instead of
shutting down. For guests that react to a shutdown request, the differences
from virDomainDestroy() are that the guests disk storage will be in a
stable state rather than having the (virtual) power cord pulled, and
this command returns as soon as the shutdown request is issued rather
than blocking until the guest is no longer running.
If the domain is transient and has any snapshot metadata (see
virDomainSnapshotNum()), then that metadata will automatically
be deleted when the domain quits. r zvirDomainShutdown() failedrL )r ZvirDomainShutdownrc r )r r9 r r r �shutdown[ s zvirDomain.shutdownc C s" t j| j|�}|dkr td��|S )aN Shutdown a domain, the domain object is still usable thereafter but
the domain OS is being stopped. Note that the guest OS may ignore the
request. Additionally, the hypervisor may check and support the domain
'on_poweroff' XML setting resulting in a domain that reboots instead of
shutting down. For guests that react to a shutdown request, the differences
from virDomainDestroy() are that the guest's disk storage will be in a
stable state rather than having the (virtual) power cord pulled, and
this command returns as soon as the shutdown request is issued rather
than blocking until the guest is no longer running.
If the domain is transient and has any snapshot metadata (see
virDomainSnapshotNum()), then that metadata will automatically
be deleted when the domain quits.
If @flags is set to zero, then the hypervisor will choose the
method of shutdown it considers best. To have greater control
pass one or more of the virDomainShutdownFlagValues. The order
in which the hypervisor tries each shutdown method is undefined,
and a hypervisor is not required to support all methods.
To use guest agent (VIR_DOMAIN_SHUTDOWN_GUEST_AGENT) the domain XML
must have <channel> configured. r z virDomainShutdownFlags() failedrL )r ZvirDomainShutdownFlagsrc r )r r7 r9 r r r �
shutdownFlagsn s zvirDomain.shutdownFlagsc C s0 t j| j||�}|dkr td��t| |d�}|S )a6 Creates a new snapshot of a domain based on the snapshot xml
contained in xmlDesc, with a top-level element <domainsnapshot>.
If @flags is 0, the domain can be active, in which case the
snapshot will be a full system snapshot (capturing both disk state,
and runtime VM state such as RAM contents), where reverting to the
snapshot is
the same as resuming from hibernation (TCP connections may have
timed out, but everything else picks up where it left off); or
the domain can be inactive, in which case the snapshot includes
just the disk state prior to booting. The newly created snapshot
becomes current (see virDomainSnapshotCurrent()), and is a child
of any previous current snapshot.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_VALIDATE, then @xmlDesc
is validated against the <domainsnapshot> XML schema.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE, then this
is a request to reinstate snapshot metadata that was previously
captured from virDomainSnapshotGetXMLDesc() before removing that
metadata, rather than creating a new snapshot. This can be used to
recreate a snapshot hierarchy on a destination, then remove it on
the source, in order to allow migration (since migration normally
fails if snapshot metadata still remains on the source machine).
Note that while original creation can omit a number of elements
from @xmlDesc (and libvirt will supply sane defaults based on the
domain state at that point in time), a redefinition must supply
more elements (as the domain may have changed in the meantime, so
that libvirt no longer has a way to resupply correct
defaults). When redefining snapshot metadata, the domain's current
snapshot will not be altered unless the
VIR_DOMAIN_SNAPSHOT_CREATE_CURRENT flag is also present. It is an
error to request the VIR_DOMAIN_SNAPSHOT_CREATE_CURRENT flag
without VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE. On some hypervisors,
redefining an existing snapshot can be used to alter host-specific
portions of the domain XML to be used during revert (such as
backing filenames associated with disk devices), but must not alter
guest-visible layout. When redefining a snapshot name that does
not exist, the hypervisor may validate that reverting to the
snapshot appears to be possible (for example, disk images have
snapshot contents by the requested name). Not all hypervisors
support these flags.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_NO_METADATA, then the
domain's disk images are modified according to @xmlDesc, but
libvirt does not track any metadata (similar to immediately calling
virDomainSnapshotDelete() with
VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY). This flag is
incompatible with VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_HALT, then the domain
will be inactive after the snapshot completes, regardless of whether
it was active before; otherwise, a running domain will still be
running after the snapshot. This flag is invalid on transient domains,
and is incompatible with VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_LIVE, then the domain
is not paused while creating the snapshot. This increases the size
of the memory dump file, but reduces downtime of the guest while
taking the snapshot. Some hypervisors only support this flag during
external snapshots.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_DISK_ONLY, then the
snapshot will be limited to the disks described in @xmlDesc, and no
VM state will be saved. For an active guest, the disk image may be
inconsistent (as if power had been pulled), and specifying this
with the VIR_DOMAIN_SNAPSHOT_CREATE_HALT flag risks data loss.
If @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_QUIESCE, then the
libvirt will attempt to use guest agent to freeze and thaw all
file systems in use within domain OS. However, if the guest agent
is not present, an error is thrown. Moreover, this flag requires
VIR_DOMAIN_SNAPSHOT_CREATE_DISK_ONLY to be passed as well.
For better control and error recovery users should invoke virDomainFSFreeze
manually before taking the snapshot and then virDomainFSThaw to restore the
VM rather than using VIR_DOMAIN_SNAPSHOT_CREATE_QUIESCE.
By default, if the snapshot involves external files, and any of the
destination files already exist as a non-empty regular file, the
snapshot is rejected to avoid losing contents of those files.
However, if @flags includes VIR_DOMAIN_SNAPSHOT_CREATE_REUSE_EXT,
then the destination files must be pre-created manually with
the correct image format and metadata including backing store path
(this allows a management app to pre-create files with relative backing
file names, rather than the default of creating with absolute backing
file names). Note that only the file specified in the snapshot XML is
inserted as a snapshot thus setting incorrect metadata in the pre-created
image may lead to the VM being unable to start or other block jobs may fail.
Be aware that although libvirt prefers to report errors up front with
no other effect, some hypervisors have certain types of failures where
the overall command can easily fail even though the guest configuration
was partially altered (for example, if a disk snapshot request for two
disks fails on the second disk, but the first disk alteration cannot be
rolled back). If this API call fails, it is therefore normally
necessary to follow up with virDomainGetXMLDesc() and check each disk
to determine if any partial changes occurred. However, if @flags
contains VIR_DOMAIN_SNAPSHOT_CREATE_ATOMIC, then libvirt guarantees
that this command will not alter any disks unless the entire set of
changes can be done atomically, making failure recovery simpler (note
that it is still possible to fail after disks have changed, but only
in the much rarer cases of running out of memory or disk space).
Some hypervisors may prevent this operation if there is a current
block copy operation; in that case, use virDomainBlockJobAbort()
to stop the block copy first.
virDomainSnapshotFree should be used to free the resources after the
snapshot object is no longer needed. Nz#virDomainSnapshotCreateXML() failed)r8 )r ZvirDomainSnapshotCreateXMLrc r �virDomainSnapshot)r r� r7 r9 r� r r r �snapshotCreateXML� s
n zvirDomain.snapshotCreateXMLc C s. t j| j|�}|dkr td��t| |d�}|S )z�Get the current snapshot for a domain, if any.
virDomainSnapshotFree should be used to free the resources after the
snapshot object is no longer needed. Nz!virDomainSnapshotCurrent() failed)r8 )r ZvirDomainSnapshotCurrentrc r r" )r r7 r9 r� r r r �snapshotCurrent s
zvirDomain.snapshotCurrentc C s" t j| j|�}|dkr td��|S )z8collect the list of snapshot names for the given domain Nz#virDomainSnapshotListNames() failed)r ZvirDomainSnapshotListNamesrc r )r r7 r9 r r r �snapshotListNames s zvirDomain.snapshotListNamesc C s0 t j| j||�}|dkr td��t| |d�}|S )z3Try to lookup a domain snapshot based on its name. Nz&virDomainSnapshotLookupByName() failed)r8 )r Z virDomainSnapshotLookupByNamerc r r" )r r; r7 r9 r� r r r �snapshotLookupByName s
z virDomain.snapshotLookupByNamec C s" t j| j|�}|dkr td��|S )aH Provides the number of domain snapshots for this domain.
This function will accept VIR_DOMAIN_SNAPSHOT_LIST_TOPOLOGICAL in
@flags only if virDomainSnapshotListNames() can honor it, although
the flag has no other effect here.
By default, this command covers all snapshots. It is also possible
to limit things to just snapshots with no parents, when @flags
includes VIR_DOMAIN_SNAPSHOT_LIST_ROOTS. Additional filters are
provided via the same @flags values as documented in
virDomainListAllSnapshots(). r z virDomainSnapshotNum() failedrL )r ZvirDomainSnapshotNumrc r )r r7 r9 r r r � snapshotNum$ s zvirDomain.snapshotNumc C s$ t j| j||�}|dkr td��|S )z�Calculate the current domain's memory dirty rate in next @seconds.
The calculated dirty rate information is available by calling
virConnectGetAllDomainStats. r z$virDomainStartDirtyRateCalc() failedrL )r ZvirDomainStartDirtyRateCalcrc r )r Zsecondsr7 r9 r r r �startDirtyRateCalc9 s z virDomain.startDirtyRateCalcc C s" t j| j|�}|dkr td��|S )zExtract domain state. NzvirDomainGetState() failed)r ZvirDomainGetStaterc r )r r7 r9 r r r r F s zvirDomain.statec C s t j| j�}|dkr td��|S )a� Suspends an active domain, the process is frozen without further access
to CPU resources and I/O but the memory used by the domain at the
hypervisor level will stay allocated. Use virDomainResume() to reactivate
the domain.
This function may require privileged access.
Moreover, suspend may not be supported if domain is in some
special state like VIR_DOMAIN_PMSUSPENDED. r zvirDomainSuspend() failedrL )r ZvirDomainSuspendrc r )r r9 r r r �suspendQ s zvirDomain.suspendc C s t j| j�}|dkr td��|S )a Undefine a domain. If the domain is running, it's converted to
transient domain, without stopping it. If the domain is inactive,
the domain configuration is removed.
If the domain has a managed save image (see
virDomainHasManagedSaveImage()), or if it is inactive and has any
snapshot metadata (see virDomainSnapshotNum()) or checkpoint
metadata (see virDomainListAllCheckpoints()), then the undefine
will fail. See virDomainUndefineFlags() for more control. r zvirDomainUndefine() failedrL )r ZvirDomainUndefinerc r )r r9 r r r �undefine^ s
zvirDomain.undefinec C s" t j| j|�}|dkr td��|S )aS Undefine a domain. If the domain is running, it's converted to
transient domain, without stopping it. If the domain is inactive,
the domain configuration is removed.
If the domain has a managed save image (see virDomainHasManagedSaveImage()),
then including VIR_DOMAIN_UNDEFINE_MANAGED_SAVE in @flags will also remove
that file, and omitting the flag will cause the undefine process to fail.
If the domain is inactive and has any snapshot metadata (see
virDomainSnapshotNum()), then including
VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATA in @flags will also remove
that metadata. Omitting the flag will cause the undefine of an
inactive domain with snapshots to fail. Active domains will retain
snapshot metadata until the (now-transient) domain halts,
regardless of whether this flag is present. On hypervisors that
support snapshots, but where snapshots do not use libvirt metadata,
this flag has no effect.
If the domain is inactive and has any checkpoint metadata (see
virDomainListAllCheckpoints()), then including
VIR_DOMAIN_UNDEFINE_CHECKPOINTS_METADATA in @flags will also remove
that metadata. Omitting the flag will cause the undefine of an
inactive domain with checkpoints to fail. Active domains will
retain checkpoint metadata until the (now-transient) domain halts,
regardless of whether this flag is present. On hypervisors that
support checkpoints, but where checkpoints do not use libvirt
metadata, this flag has no effect.
If the domain has any nvram specified, the undefine process will fail
unless VIR_DOMAIN_UNDEFINE_KEEP_NVRAM is specified, or if
VIR_DOMAIN_UNDEFINE_NVRAM is specified to remove the nvram file. r z virDomainUndefineFlags() failedrL )r ZvirDomainUndefineFlagsrc r )r r7 r9 r r r �
undefineFlagsm s zvirDomain.undefineFlagsc C s$ t j| j||�}|dkr td��|S )a� Change a virtual device on a domain, using the flags parameter
to control how the device is changed. VIR_DOMAIN_AFFECT_CURRENT
specifies that the device change is made based on current domain
state. VIR_DOMAIN_AFFECT_LIVE specifies that the device shall be
changed on the active domain instance only and is not added to the
persisted domain configuration. VIR_DOMAIN_AFFECT_CONFIG
specifies that the device shall be changed on the persisted domain
configuration only. Note that the target hypervisor must return an
error if unable to satisfy flags. E.g. the hypervisor driver will
return failure if LIVE is specified but it only supports modifying the
persisted device allocation.
This method is used for actions such changing CDROM/Floppy device
media, altering the graphics configuration such as password,
reconfiguring the NIC device backend connectivity, etc.
The supplied XML description of the device should contain all
the information that is found in the corresponding domain XML.
Leaving out any piece of information may be treated as a
request for its removal, which may be denied. For instance,
when users want to change CDROM media only for live XML, they
must provide live disk XML as found in the corresponding live
domain XML with only the disk path changed. r z#virDomainUpdateDeviceFlags() failedrL )r ZvirDomainUpdateDeviceFlagsrc r )r rq r7 r9 r r r �updateDeviceFlags� s zvirDomain.updateDeviceFlagsc C s" t j| j|�}|dkr td��|S )z=Query the CPU affinity setting of all virtual CPUs of domain Nz virDomainGetVcpuPinInfo() failed)r ZvirDomainGetVcpuPinInforc r )r r7 r9 r r r � vcpuPinInfo� s zvirDomain.vcpuPinInfoc C s t j| j�}|dkr td��|S )z^Extract information about virtual CPUs of domain, store it in info array and also in cpumaps. NzvirDomainGetVcpus() failed)r ZvirDomainGetVcpusrc r )r r9 r r r �vcpus� s zvirDomain.vcpusc C s" t j| j|�}|dkr td��|S )an Query the number of virtual CPUs used by the domain. Note that
this call may fail if the underlying virtualization hypervisor does
not support it. This function may require privileged access to the
hypervisor.
If @flags includes VIR_DOMAIN_AFFECT_LIVE, this will query a
running domain (which will fail if domain is not active); if
it includes VIR_DOMAIN_AFFECT_CONFIG, this will query the XML
description of the domain. It is an error to set both flags.
If neither flag is set (that is, VIR_DOMAIN_AFFECT_CURRENT),
then the configuration queried depends on whether the domain
is currently running.
If @flags includes VIR_DOMAIN_VCPU_MAXIMUM, then the maximum
virtual CPU limit is queried. Otherwise, this call queries the
current virtual CPU count.
If @flags includes VIR_DOMAIN_VCPU_GUEST, then the state of the processors
is queried in the guest instead of the hypervisor. This flag is only usable
on live domains. Guest agent may be needed for this flag to be available. r z virDomainGetVcpusFlags() failedrL )r ZvirDomainGetVcpusFlagsrc r )r r7 r9 r r r �
vcpusFlags� s zvirDomain.vcpusFlagsr" )r7 r c s0 t j� j|�}|dkr td��� fdd�|D �S )z9List all snapshots and returns a list of snapshot objectsNz"virDomainListAllSnapshots() failedc s g | ]}t � |d ��qS ))r8 )r" )�.0�snapptr)r r r �
<listcomp>� s z.virDomain.listAllSnapshots.<locals>.<listcomp>)r ZvirDomainListAllSnapshotsrc r )r r7 r9 r )r r �listAllSnapshots� s zvirDomain.listAllSnapshotsr� c s0 t j� j|�}|dkr td��� fdd�|D �S )z=List all checkpoints and returns a list of checkpoint objectsNz$virDomainListAllCheckpoints() failedc s g | ]}t � |d ��qS ))r8 )r� )r0 �chkptr)r r r r2 � s z0virDomain.listAllCheckpoints.<locals>.<listcomp>)r ZvirDomainListAllCheckpointsrc r )r r7 r9 r )r r �listAllCheckpoints� s z virDomain.listAllCheckpoints)�filesr7 r c C s$ t j| j||�}|dkr td��|S )a Launch a defined domain. If the call succeeds the domain moves from the
defined to the running domains pools.
@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.
If the VIR_DOMAIN_START_PAUSED flag is set, or if the guest domain
has a managed save image that requested paused state (see
virDomainManagedSave()) the guest domain will be started, but its
CPUs will remain paused. The CPUs can later be manually started
using virDomainResume(). In all other cases, the guest domain will
be running.
If the VIR_DOMAIN_START_AUTODESTROY flag is set, the guest
domain will be automatically destroyed when the virConnectPtr
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.
If the VIR_DOMAIN_START_BYPASS_CACHE flag is set, and there is a
managed save file for this domain (created by virDomainManagedSave()),
then libvirt will attempt to bypass the file system cache while restoring
the file, or fail if it cannot do so for the given system; this can allow
less pressure on file system cache, but also risks slowing loads from NFS.
If the VIR_DOMAIN_START_FORCE_BOOT flag is set, then any managed save
file for this domain is discarded, and the domain boots from scratch. r z!virDomainCreateWithFiles() failedrL )r ZvirDomainCreateWithFilesrc r )r r6 r7 r9 r r r �createWithFiles� s !zvirDomain.createWithFiles)� mountpointsr7 r c C s$ t j| j||�}|dkr td��|S )z.Freeze specified filesystems within the guest r zvirDomainFSFreeze() failedrL )r ZvirDomainFSFreezerc r )r r8 r7 r9 r r r �fsFreeze
s zvirDomain.fsFreezec C s$ t j| j||�}|dkr td��|S )z,Thaw specified filesystems within the guest r zvirDomainFSThaw() failedrL )r ZvirDomainFSThawrc r )r r8 r7 r9 r r r �fsThaw
s zvirDomain.fsThawc C s" t j| j|�}|dkr td��|S )z%Extract information about guest time NzvirDomainGetTime() failed)r ZvirDomainGetTimerc r )r r7 r9 r r r �getTime&
s zvirDomain.getTime)�timer7 r c C s$ t j| j||�}|dkr td��|S )z�Set guest time to the given value. @time is a dict containing
'seconds' field for seconds and 'nseconds' field for nanoseconds r zvirDomainSetTime() failedrL )r ZvirDomainSetTimerc r )r r< r7 r9 r r r �setTime-
s zvirDomain.setTime)N)r )r )r )r )r )Nr )r )r )r )r r )Nr )r )r )r )r )r )r )r r )r r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r NNr )Nr NNr )r )r )r )r )r )r )r )r )r Nr )NNNr Nr )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )Nr )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )Nr )Nr )r )Nr )�r- r. r/ r re rf rg rh ri rj rk rl rm ro rp rr rs ru rw rx ry rz r{ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r; r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r
r r r r r r r r r r r r r r r r r r r! r# r$ r% r& r' r( r r) r* r+ r, r- r. r/ r1 r r3 r5 r7 r0 r9 r: r; r= r r r r r sL
= c , % i )
4
=
' $ % t
%! & c @ s� e Zd Zd1dd�Zdd� Zdd� Zdd � Zd2d d �Zd
d� Zdd� Z d3dd�Z
dd� Z dd� Z dd� Z
dd� Zdd � Zd d � Zd d � Zd4d!d"�Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd5d+d,�Zd6eed- d.�d/d0�ZdS )7�
virNetworkNc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r 6
s zvirNetwork.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirNetworkFree)r r r r re <
s
zvirNetwork.__del__c C s | j S )N)ra )r r r r rf A
s zvirNetwork.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirNetwork_pointerrc )r r r r rg D
s zvirNetwork.c_pointerr c C s$ t j| j||�}|dkr td��|S )zTReturns a list of dhcp leases for interfaces connected to the given virtual network Nz virNetworkGetDHCPLeases() failed)r ZvirNetworkGetDHCPLeasesrc r )r Zmacr7 r9 r r r �
DHCPLeasesL
s zvirNetwork.DHCPLeasesc C s t j| j�}|dkr td��|S )z1Extract the UUID unique Identifier of a network. NzvirNetworkGetUUID() failed)r ZvirNetworkGetUUIDrc r )r r9 r r r rj S
s zvirNetwork.UUIDc C s t j| j�}|dkr td��|S )z5Fetch globally unique ID of the network as a string. Nz virNetworkGetUUIDString() failed)r ZvirNetworkGetUUIDStringrc r )r r9 r r r rk Z
s zvirNetwork.UUIDStringc C s" t j| j|�}|dkr td��|S )a� Provide an XML description of the network. The description may be reused
later to relaunch the network with virNetworkCreateXML().
Normally, if a network included a physical function, the output includes
all virtual functions tied to that physical interface. If @flags includes
VIR_NETWORK_XML_INACTIVE, then the expansion of virtual interfaces is
not performed. Nz virNetworkGetXMLDesc() failed)r ZvirNetworkGetXMLDescrc r )r r7 r9 r r r rl e
s zvirNetwork.XMLDescc C s t j| j�}|dkr td��|S )z*Extract the autostart flag for a network. r z virNetworkGetAutostart() failedrL )r ZvirNetworkGetAutostartrc r )r r9 r r r rx v
s zvirNetwork.autostartc C s t j| j�}|dkr td��|S )zyProvides a bridge interface name to which a domain may connect
a network interface in order to join the network. Nz virNetworkGetBridgeName() failed)r ZvirNetworkGetBridgeNamerc r )r r9 r r r �
bridgeName�
s zvirNetwork.bridgeNamec C s t j| j�}|dkr td��|S )z�Create and start a defined network. If the call succeed the network
moves from the defined to the running networks pools. r zvirNetworkCreate() failedrL )r ZvirNetworkCreaterc r )r r9 r r r r� �
s zvirNetwork.createc C s t j| j�}|dkr td��|S )a Destroy the network 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 virNetworkPtr object.
This function may require privileged access r zvirNetworkDestroy() failedrL )r ZvirNetworkDestroyrc r )r r9 r r r r� �
s zvirNetwork.destroyc C s t j| j�}|dkr td��|S )z.Determine if the network is currently running r zvirNetworkIsActive() failedrL )r ZvirNetworkIsActiverc r )r r9 r r r r� �
s zvirNetwork.isActivec C s t j| j�}|dkr td��|S )ztDetermine if the network has a persistent configuration
which means it will still exist after shutting down r z virNetworkIsPersistent() failedrL )r ZvirNetworkIsPersistentrc r )r r9 r r r r� �
s zvirNetwork.isPersistentc C s t j| j�}|S )z%Get the public name for that network )r ZvirNetworkGetNamerc )r r9 r r r r; �
s zvirNetwork.namec C s0 t j| j||�}|dkr td��t| |d�}|S )z�Create a new network port, based on an XML description
similar to the one returned by virNetworkPortGetXMLDesc()
virNetworkPortFree should be used to free the resources after the
network port object is no longer needed. Nz virNetworkPortCreateXML() failed)r8 )r ZvirNetworkPortCreateXMLrc r �virNetworkPort)r Zxmldescr7 r9 �_virNetwork__tmpr r r �
portCreateXML�
s
zvirNetwork.portCreateXMLc C s. t j| j|�}|dkr td��t| |d�}|S )z=Try to lookup a port on the given network based on its UUID. Nz#virNetworkPortLookupByUUID() failed)r8 )r ZvirNetworkPortLookupByUUIDrc r rA )r �uuidr9 rB r r r �portLookupByUUID�
s
zvirNetwork.portLookupByUUIDc C s. t j| j|�}|dkr td��t| |d�}|S )z=Try to lookup a port on the given network based on its UUID. Nz)virNetworkPortLookupByUUIDString() failed)r8 )r Z virNetworkPortLookupByUUIDStringrc r rA )r �uuidstrr9 rB r r r �portLookupByUUIDString�
s
z!virNetwork.portLookupByUUIDStringc C s" t j| j|�}|dkr td��|S )zWConfigure the network to be automatically started
when the host machine boots. r z virNetworkSetAutostart() failedrL )r ZvirNetworkSetAutostartrc r )r rx r9 r r r r �
s zvirNetwork.setAutostartc C s t j| j�}|dkr td��|S )z9Undefine a network but does not stop it if it is running r zvirNetworkUndefine() failedrL )r ZvirNetworkUndefinerc r )r r9 r r r r* �
s zvirNetwork.undefinec C s* t j| j|||||�}|dkr&td��|S )z|Update the definition of an existing network, either its live
running state, its persistent configuration, or both. r zvirNetworkUpdate() failedrL )r ZvirNetworkUpdaterc r )r ZcommandZsectionZ parentIndexrq r7 r9 r r r �update�
s zvirNetwork.updaterA )r7 r c s0 t j� j|�}|dkr td��� fdd�|D �S )zHList all ports on the network and returns a list of network port objectsNz virNetworkListAllPorts() failedc s g | ]}t � |d ��qS ))r8 )rA )r0 �domptr)r r r r2 �
s z+virNetwork.listAllPorts.<locals>.<listcomp>)r ZvirNetworkListAllPortsrc r )r r7 r9 r )r r � listAllPorts�
s zvirNetwork.listAllPorts)N)Nr )r )r )r )r )r- r. r/ r re rf rg r? rj rk rl rx r@ r� r� r� r� r; rC rE rG r r* rH r1 r rJ r r r r r> 5
s,
r> c @ st e Zd Zddd�dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Zdd� Z ddd�Z
d dd�Z d dd�Z d dd�Z
dS ) rA N)r c C s8 || _ |j� | _t|�jdkr.tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )�_netrf ra rb r- r rc )r �netr8 r r r r �
s
zvirNetworkPort.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirNetworkPortFree)r r r r re �
s
zvirNetworkPort.__del__c C s | j S )N)ra )r r r r rf s zvirNetworkPort.connectc C s | j S )N)rK )r r r r �network s zvirNetworkPort.networkc C s t j| j�S )z"Get C pointer to underlying object)r ZvirNetworkPort_pointerrc )r r r r rg s zvirNetworkPort.c_pointerc C s t j| j�}|dkr td��|S )z6Extract the UUID unique Identifier of a network port. Nz virNetworkPortGetUUID() failed)r ZvirNetworkPortGetUUIDrc r )r r9 r r r rj s zvirNetworkPort.UUIDc C s t j| j�}|dkr td��|S )z:Fetch globally unique ID of the network port as a string. Nz$virNetworkPortGetUUIDString() failed)r ZvirNetworkPortGetUUIDStringrc r )r r9 r r r rk s zvirNetworkPort.UUIDStringr c C s" t j| j|�}|dkr td��|S )z�Provide an XML description of the network port. The description may be reused
later to recreate the port with virNetworkPortCreateXML(). Nz!virNetworkPortGetXMLDesc() failed)r ZvirNetworkPortGetXMLDescrc r )r r7 r9 r r r rl " s zvirNetworkPort.XMLDescc C s" t j| j|�}|dkr td��|S )z�Delete the network port. This does not free the
associated virNetworkPortPtr object. It is the
caller's responsibility to ensure the port is not
still in use by a virtual machine before deleting
port. r z virNetworkPortDelete() failedrL )r ZvirNetworkPortDeleterc r )r r7 r9 r r r �delete* s zvirNetworkPort.deletec C s" t j| j|�}|dkr td��|S )zGet the port parameters Nz$virNetworkPortGetParameters() failed)r ZvirNetworkPortGetParametersrc r )r r7 r9 r r r �
parameters9 s zvirNetworkPort.parametersc C s$ t j| j||�}|dkr td��|S )zChange the port tunables r z$virNetworkPortSetParameters() failedrL )r ZvirNetworkPortSetParametersrc r )r r� r7 r9 r r r �
setParameters@ s z virNetworkPort.setParameters)N)r )r )r )r )r- r. r/ r re rf rM rg rj rk rl rN rO rP r r r r rA �
s
rA c @ sl e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zdd
d�Zddd�Z d dd�Z
dd� Z dd� Z dd� Z
dS ) � virInterfaceNc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r H s zvirInterface.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirInterfaceFree)r r r r re N s
zvirInterface.__del__c C s | j S )N)ra )r r r r rf S s zvirInterface.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirInterface_pointerrc )r r r r rg V s zvirInterface.c_pointerc C s t j| j�}|dkr td��|S )z\Get the MAC for an interface as string. For more information about
MAC see RFC4122. Nz!virInterfaceGetMACString() failed)r ZvirInterfaceGetMACStringrc r )r r9 r r r � MACString^ s zvirInterface.MACStringr c C s" t j| j|�}|dkr td��|S )a@ VIR_INTERFACE_XML_INACTIVE - return the static configuration,
suitable for use redefining the
interface via virInterfaceDefineXML()
Provide an XML description of the interface. If
VIR_INTERFACE_XML_INACTIVE is set, the description may be reused
later to redefine the interface with virInterfaceDefineXML(). If it
is not set, the ip address and netmask will be the current live
setting of the interface, not the settings from the config files. Nz virInterfaceGetXMLDesc() failed)r ZvirInterfaceGetXMLDescrc r )r r7 r9 r r r rl f s
zvirInterface.XMLDescc C s" t j| j|�}|dkr td��|S )aK Activate an interface (i.e. call "ifup").
If there was an open network config transaction at the time this
interface was defined (that is, if virInterfaceChangeBegin() had
been called), the interface will be brought back down (and then
undefined) if virInterfaceChangeRollback() is called. r zvirInterfaceCreate() failedrL )r ZvirInterfaceCreaterc r )r r7 r9 r r r r� u s zvirInterface.createc C s" t j| j|�}|dkr td��|S )a deactivate an interface (ie call "ifdown")
This does not remove the interface from the config, and
does not free the associated virInterfacePtr object.
If there is an open network config transaction at the time this
interface is destroyed (that is, if virInterfaceChangeBegin() had
been called), and if the interface is later undefined and then
virInterfaceChangeRollback() is called, the restoral of the
interface definition will also bring the interface back up. r z virInterfaceDestroy() failedrL )r ZvirInterfaceDestroyrc r )r r7 r9 r r r r� � s
zvirInterface.destroyc C s t j| j�}|dkr td��|S )z0Determine if the interface is currently running r z virInterfaceIsActive() failedrL )r ZvirInterfaceIsActiverc r )r r9 r r r r� � s zvirInterface.isActivec C s t j| j�}|S )z'Get the public name for that interface )r ZvirInterfaceGetNamerc )r r9 r r r r; � s zvirInterface.namec C s t j| j�}|dkr td��|S )a� Undefine an interface, ie remove it from the config.
This does not free the associated virInterfacePtr object.
Normally this change in the interface configuration is
permanent/persistent, but if virInterfaceChangeBegin() has been
previously called (i.e. if an interface config transaction is
open), the removal of the interface definition will only become
permanent if virInterfaceChangeCommit() is called prior to the next
reboot of the system running libvirtd. Prior to that time, the
definition can be explicitly restored using
virInterfaceChangeRollback(), or will be automatically restored
during the next reboot of the system running libvirtd. r z virInterfaceUndefine() failedrL )r ZvirInterfaceUndefinerc r )r r9 r r r r* � s
zvirInterface.undefine)N)r )r )r )r- r. r/ r re rf rg rR rl r� r� r� r; r* r r r r rQ G s
rQ c @ s� e Zd Zd7dd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zd8dd�Z dd� Z
d9dd�Z d:dd�Z d;dd�Z
d<dd�Zd=dd �Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd>d+d,�Zd-d.� Zd/d0� Zd1d2� Zd?ee d3 d4�d5d6�Z dS )@�virStoragePoolNc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r � s zvirStoragePool.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirStoragePoolFree)r r r r re � s
zvirStoragePool.__del__c C s | j S )N)ra )r r r r rf � s zvirStoragePool.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirStoragePool_pointerrc )r r r r rg � s zvirStoragePool.c_pointerc C s t j| j�}|dkr td��|S )z6Extract the UUID unique Identifier of a storage pool. Nz virStoragePoolGetUUID() failed)r ZvirStoragePoolGetUUIDrc r )r r9 r r r rj � s zvirStoragePool.UUIDc C s t j| j�}|dkr td��|S )z:Fetch globally unique ID of the storage pool as a string. Nz$virStoragePoolGetUUIDString() failed)r ZvirStoragePoolGetUUIDStringrc r )r r9 r r r rk � s zvirStoragePool.UUIDStringr c C s" t j| j|�}|dkr td��|S )z�Fetch an XML document describing all aspects of the
storage pool. This is suitable for later feeding back
into the virStoragePoolCreateXML method. Nz!virStoragePoolGetXMLDesc() failed)r ZvirStoragePoolGetXMLDescrc r )r r7 r9 r r r rl � s zvirStoragePool.XMLDescc C s t j| j�}|dkr td��|S )z.Extract the autostart flag for a storage pool r z#virStoragePoolGetAutostart() failedrL )r ZvirStoragePoolGetAutostartrc r )r r9 r r r rx � s zvirStoragePool.autostartc C s" t j| j|�}|dkr td��|S )z�Currently only filesystem pool accepts flags VIR_STORAGE_POOL_BUILD_OVERWRITE
and VIR_STORAGE_POOL_BUILD_NO_OVERWRITE.
Build the underlying storage pool r z virStoragePoolBuild() failedrL )r ZvirStoragePoolBuildrc r )r r7 r9 r r r �build� s zvirStoragePool.buildc C s" t j| j|�}|dkr td��|S )z Starts an inactive storage pool r z virStoragePoolCreate() failedrL )r ZvirStoragePoolCreaterc r )r r7 r9 r r r r� � s zvirStoragePool.createc C s2 t j| j||�}|dkr td��t| j|d�}|S )a� Create a storage volume within a pool based
on an XML description. Not all pools support
creation of volumes.
Since 1.0.1 VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA
in flags can be used to get higher performance with
qcow2 image files which don't support full preallocation,
by creating a sparse image file with metadata.
virStorageVolFree should be used to free the resources after the
storage volume object is no longer needed. Nz virStorageVolCreateXML() failed)r8 )r ZvirStorageVolCreateXMLrc r �
virStorageVolra )r r� r7 r9 �_virStoragePool__tmpr r r � createXML s
zvirStoragePool.createXMLc C sH |dkrd}n|j }tj| j |||�}|dkr6td��t| j|d�}|S )aI Create a storage volume in the parent pool, using the
'clonevol' volume as input. Information for the new
volume (name, perms) are passed via a typical volume
XML description.
Since 1.0.1 VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA
in flags can be used to get higher performance with
qcow2 image files which don't support full preallocation,
by creating a sparse image file with metadata.
virStorageVolFree should be used to free the resources after the
storage volume object is no longer needed. Nz#virStorageVolCreateXMLFrom() failed)r8 )rc r ZvirStorageVolCreateXMLFromr rU ra )r r� Zclonevolr7 Z clonevol__or9 rV r r r �
createXMLFrom s
z virStoragePool.createXMLFromc C s" t j| j|�}|dkr td��|S )z�Delete the underlying pool resources. This is
a non-recoverable operation. The virStoragePoolPtr object
itself is not free'd. r z virStoragePoolDelete() failedrL )r ZvirStoragePoolDeleterc r )r r7 r9 r r r rN ) s zvirStoragePool.deletec C s t j| j�}|dkr td��|S )a/ Destroy an active storage pool. This will deactivate the
pool on the host, but keep any persistent config associated
with it. If it has a persistent config it can later be
restarted with virStoragePoolCreate(). This does not free
the associated virStoragePoolPtr object. r z virStoragePoolDestroy() failedrL )r ZvirStoragePoolDestroyrc r )r r9 r r r r� 2 s zvirStoragePool.destroyc C s t j| j�}|dkr td��|S )z�Extract information about a storage pool. Note that if the connection used to get the domain is limited only a partial set of the information can be extracted. Nz virStoragePoolGetInfo() failed)r ZvirStoragePoolGetInforc r )r r9 r r r r� A s zvirStoragePool.infoc C s t j| j�}|dkr td��|S )z3Determine if the storage pool is currently running r z virStoragePoolIsActive() failedrL )r ZvirStoragePoolIsActiverc r )r r9 r r r r� L s zvirStoragePool.isActivec C s t j| j�}|dkr td��|S )zyDetermine if the storage pool has a persistent configuration
which means it will still exist after shutting down r z#virStoragePoolIsPersistent() failedrL )r ZvirStoragePoolIsPersistentrc r )r r9 r r r r� S s zvirStoragePool.isPersistentc C s t j| j�}|dkr td��|S )zElist the storage volumes, stores the pointers to the names in @names Nz"virStoragePoolListVolumes() failed)r ZvirStoragePoolListVolumesrc r )r r9 r r r � listVolumes_ s zvirStoragePool.listVolumesc C s t j| j�}|S )z2Fetch the locally unique name of the storage pool )r ZvirStoragePoolGetNamerc )r r9 r r r r; j s zvirStoragePool.namec C s t j| j�}|dkr td��|S )z2Fetch the number of storage volumes within a pool r z#virStoragePoolNumOfVolumes() failedrL )r ZvirStoragePoolNumOfVolumesrc r )r r9 r r r � numOfVolumeso s zvirStoragePool.numOfVolumesc C s" t j| j|�}|dkr td��|S )z�Request that the pool refresh its list of volumes. This may
involve communicating with a remote server, and/or initializing
new devices at the OS layer r z virStoragePoolRefresh() failedrL )r ZvirStoragePoolRefreshrc r )r r7 r9 r r r �refreshv s zvirStoragePool.refreshc C s" t j| j|�}|dkr td��|S )z\Configure the storage pool to be automatically started
when the host machine boots. r z#virStoragePoolSetAutostart() failedrL )r ZvirStoragePoolSetAutostartrc r )r rx r9 r r r r s zvirStoragePool.setAutostartc C s0 t j| j|�}|dkr td��t| j|d�}|S )z�Fetch a pointer to a storage volume based on its name
within a pool
virStorageVolFree should be used to free the resources after the
storage volume object is no longer needed. Nz"virStorageVolLookupByName() failed)r8 )r ZvirStorageVolLookupByNamerc r rU ra )r r; r9 rV r r r �storageVolLookupByName� s
z%virStoragePool.storageVolLookupByNamec C s t j| j�}|dkr td��|S )z"Undefine an inactive storage pool r z virStoragePoolUndefine() failedrL )r ZvirStoragePoolUndefinerc r )r r9 r r r r* � s zvirStoragePool.undefinerU )r7 r c s0 t j� j|�}|dkr td��� fdd�|D �S )zEList all storage volumes and returns a list of storage volume objectsNz%virStoragePoolListAllVolumes() failedc s g | ]}t � j|d ��qS ))r8 )rU ra )r0 Zvolptr)r r r r2 � s z1virStoragePool.listAllVolumes.<locals>.<listcomp>)r Z virStoragePoolListAllVolumesrc r )r r7 r9 r )r r �listAllVolumes� s z virStoragePool.listAllVolumes)N)r )r )r )r )r )r )r )r ) r- r. r/ r re rf rg rj rk rl rx rT r� rW rX rN r� r� r� r� rY r; rZ r[ r r\ r* r1 r r] r r r r rS � s2
rS c @ s� e Zd ZdZd&dd�Zdd� Zdd� Zd d
� Zd'd d
�Zd(dd�Z d)dd�Z
dd� Z d*dd�Z dd� Z
dd� Zdd� Zd+d d �Zd d � Zd,d d!�Zd-d"d#�Zd.d$d%�ZdS )/rU i� Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r � s zvirStorageVol.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirStorageVolFree)r r r r re � s
zvirStorageVol.__del__c C s | j S )N)ra )r r r r rf � s zvirStorageVol.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirStorageVol_pointerrc )r r r r rg � s zvirStorageVol.c_pointerr c C s" t j| j|�}|dkr td��|S )zKFetch an XML document describing all aspects of
the storage volume Nz virStorageVolGetXMLDesc() failed)r ZvirStorageVolGetXMLDescrc r )r r7 r9 r r r rl � s zvirStorageVol.XMLDescc C s" t j| j|�}|dkr td��|S )z(Delete the storage volume from the pool r z virStorageVolDelete() failedrL )r ZvirStorageVolDeleterc r )r r7 r9 r r r rN � s zvirStorageVol.deletec C s< |dkrd}n|j }tj| j ||||�}|dkr8td��|S )a' Download the content of the volume as a stream. If @length
is zero, then the remaining contents of the volume after
@offset will be downloaded. Please note that the stream
transports the volume itself as is, so the downloaded data may
not correspond to guest OS visible state in cases when a
complex storage format such as qcow2 or vmdk is used.
If VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM is set in @flags
effective transmission of holes is enabled. This assumes using
the @stream with combination of virStreamSparseRecvAll() or
virStreamRecvFlags(stream, ..., flags =
VIR_STREAM_RECV_STOP_AT_HOLE) for honouring holes sent by
server.
This call sets up an asynchronous stream; subsequent use of
stream APIs is necessary to transfer the actual data,
determine how much data is successfully transferred, and
detect any errors. The results will be unpredictable if
another active stream is writing to the storage volume. Nr z virStorageVolDownload() failedrL )rc r ZvirStorageVolDownloadr )r r� r� �lengthr7 r� r9 r r r �download� s zvirStorageVol.downloadc C s t j| j�}|dkr td��|S )z�Extract information about a storage volume. Note that if the connection used to get the domain is limited only a partial set of the information can be extracted. Nz virStorageVolGetInfo() failed)r ZvirStorageVolGetInforc r )r r9 r r r r� � s zvirStorageVol.infoc C s" t j| j|�}|dkr td��|S )z�Extract information about a storage volume. Note that if the connection used to get the domain is limited only a partial set of the information can be extracted. Nz"virStorageVolGetInfoFlags() failed)r ZvirStorageVolGetInfoFlagsrc r )r r7 r9 r r r � infoFlags� s zvirStorageVol.infoFlagsc C s t j| j�}|dkr td��|S )z�Fetch the storage volume key. This is globally
unique, so the same volume will have the same
key no matter what host it is accessed from Nz virStorageVolGetKey() failed)r ZvirStorageVolGetKeyrc r )r r9 r r r r s zvirStorageVol.keyc C s t j| j�}|S )zQFetch the storage volume name. This is unique
within the scope of a pool )r ZvirStorageVolGetNamerc )r r9 r r r r;
s zvirStorageVol.namec C s t j| j�}|dkr td��|S )a Fetch the storage volume path. Depending on the pool
configuration this is either persistent across hosts,
or dynamically assigned at pool startup. Consult
pool documentation for information on getting the
persistent naming Nz virStorageVolGetPath() failed)r ZvirStorageVolGetPathrc r )r r9 r r r r� s zvirStorageVol.pathc C s$ t j| j||�}|dkr td��|S )aX Changes the capacity of the storage volume @vol to @capacity. The
operation will fail if the new capacity requires allocation that would
exceed the remaining free space in the parent pool. The contents of
the new capacity will appear as all zero bytes. The capacity value will
be rounded to the granularity supported by the hypervisor.
Normally, the operation will attempt to affect capacity with a minimum
impact on allocation (that is, the default operation favors a sparse
resize). If @flags contains VIR_STORAGE_VOL_RESIZE_ALLOCATE, then the
operation will ensure that allocation is sufficient for the new
capacity; this may make the operation take noticeably longer.
Normally, the operation treats @capacity as the new size in bytes;
but if @flags contains VIR_STORAGE_VOL_RESIZE_DELTA, then @capacity
represents the size difference to add to the current size. It is
up to the storage pool implementation whether unaligned requests are
rounded up to the next valid boundary, or rejected.
Normally, this operation should only be used to enlarge capacity;
but if @flags contains VIR_STORAGE_VOL_RESIZE_SHRINK, it is possible to
attempt a reduction in capacity even though it might cause data loss.
If VIR_STORAGE_VOL_RESIZE_DELTA is also present, then @capacity is
subtracted from the current size; without it, @capacity represents
the absolute new size regardless of whether it is larger or smaller
than the current size. r z virStorageVolResize() failedrL )r ZvirStorageVolResizerc r )r Zcapacityr7 r9 r r r �resize s zvirStorageVol.resizec C s. t j| j�}|dkr td��t| j|d�}|S )z�Fetch a storage pool which contains a particular volume
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz%virStoragePoolLookupByVolume() failed)r8 )r Z virStoragePoolLookupByVolumerc r rS ra )r r9 Z_virStorageVol__tmpr r r �storagePoolLookupByVolume= s
z'virStorageVol.storagePoolLookupByVolumec C s< |dkrd}n|j }tj| j ||||�}|dkr8td��|S )ap Upload new content to the volume from a stream. This call
will fail if @offset + @length exceeds the size of the
volume. Otherwise, if @length is non-zero, an error
will be raised if an attempt is made to upload greater
than @length bytes of data. Please note that the stream
transports the volume itself as is, so the downloaded data may
not correspond to guest OS visible state in cases when a
complex storage format such as qcow2 or vmdk is used.
If VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM is set in @flags
effective transmission of holes is enabled. This assumes using
the @stream with combination of virStreamSparseSendAll() or
virStreamSendHole() to preserve source file sparseness.
This call sets up an asynchronous stream; subsequent use of
stream APIs is necessary to transfer the actual data,
determine how much data is successfully transferred, and
detect any errors. The results will be unpredictable if
another active stream is writing to the storage volume.
When the data stream is closed whether the upload is successful
or not an attempt will be made to refresh the target storage pool
if an asynchronous build is not running in order to reflect pool
and volume changes as a result of the upload. Depending on
the target volume storage backend and the source stream type
for a successful upload, the target volume may take on the
characteristics from the source stream such as format type,
capacity, and allocation. Nr z virStorageVolUpload() failedrL )rc r ZvirStorageVolUploadr )r r� r� r^ r7 r� r9 r r r �uploadH s zvirStorageVol.uploadc C s" t j| j|�}|dkr td��|S )a� Ensure data previously on a volume is not accessible to future reads.
The data to be wiped may include the format and possibly size information,
so non-raw images might become raw with a different size. It is storage
backend dependent whether the format and size information is regenerated
once the initial volume wipe is completed.
Depending on the actual volume representation, this call may not
overwrite the physical location of the volume. For instance, files
stored journaled, log structured, copy-on-write, versioned, and
network file systems are known to be problematic. r zvirStorageVolWipe() failedrL )r ZvirStorageVolWiperc r )r r7 r9 r r r �wipen s zvirStorageVol.wipec C s$ t j| j||�}|dkr td��|S )a� Similar to virStorageVolWipe, but one can choose between
different wiping algorithms. Also note, that depending on the
actual volume representation, this call may not really
overwrite the physical location of the volume. For instance,
files stored journaled, log structured, copy-on-write,
versioned, and network file systems are known to be
problematic. r z!virStorageVolWipePattern() failedrL )r ZvirStorageVolWipePatternrc r )r � algorithmr7 r9 r r r � wipePattern s zvirStorageVol.wipePattern)N)r )r )r )r )r )r )r )r )r- r. r/ �
streamBufSizer re rf rg rl rN r_ r� r` r r; r� ra rb rc rd rf r r r r rU � s$
!
&
rU c
@ s
e Zd Z�d�dd�Zdd� Z�d�dd�Z�d�d d
�Z�d�d d �Z�d�d
d�Z�d�dd�Z �d�dd�Z
dd� Z �d�dd�Z �d�dd�Z
�d�dd�Z�d�dd �Zd d � Z�d�d d �Z�d�d!d"�Z�d�d#d$�Z�d�d%d&�Z�d�d'd(�Z�d�d)d*�Z�d�d+d,�Zd-d.� Zd/d0� Z�d�d1d2�Zd3d4� Z�d�d5d6�Z d7d8� Z d9d:� Z d;d<� Z d=d>� Z �d�d?d@�Z!�d�dAdB�Z"�d�dCdD�Z#dEdF� Z$�d�dGdH�Z%�d�dIdJ�Z&dKdL� Z'dMdN� Z(dOdP� Z)�d�dQdR�Z*dSdT� Z+dUdV� Z,dWdX� Z-dYdZ� Z.d[d\� Z/d]d^� Z0d_d`� Z1dadb� Z2dcdd� Z3�d�dedf�Z4dgdh� Z5didj� Z6dkdl� Z7dmdn� Z8dodp� Z9dqdr� Z:dsdt� Z;dudv� Z<dwdx� Z=dydz� Z>d{d|� Z?�d�d}d~�Z@dd�� ZA�d�d�d��ZBd�d�� ZCd�d�� ZDd�d�� ZE�d�d�d��ZF�d�d�d��ZG�d�d�d��ZHd�d�� ZI�d�d�d��ZJd�d�� ZKd�d�� ZLd�d�� ZMd�d�� ZN�d�d�d��ZOd�d�� ZPd�d�� ZQd�d�� ZRd�d�� ZSd�d�� ZTd�d�� ZU�d�d�d��ZVd�d�� ZWd�d�� ZX�d�d�d��ZYd�d�� ZZd�d�� Z[d�d�� Z\d�d�� Z]�d�d�d��Z^�d�d�d��Z_�d�d�d��Z`�d�d�d��Zad�d Zbd�dĄ Zcd�dƄ Zd�d�d�dȄZed�dʄ Zf�d�d�d̄Zg�d�d�d΄Zh�d�d�dЄZid�d҄ Zjd�dԄ Zkd�dք Zld�d Zmd�dڄ Znd�d܄ Zo�d�d�dބZpd�d� Zqd�d� Zrdd�d�d�Zsd d�d�d�Zteuevew euew euex dd�d�d�Zyezdd�d�d�Z{eze|dd�d�d�Z}d�e~e~dd�d�d�Zd�e~e~e�e�e�f e~d��d�d��Z�d�e�e�e�f e~d��d�d��Z�d�e~e�e�e�f e~d��d�d��Z�d�e~e�e�e�f e~d��d��d �Z�d�e�e�e~e�e�e�f e~�d��d�d�Z�d�e�e�e~e~e�e�e�f e~�d��d�d�Z�d�e~e�e�e�e�e�e�e�f e~�d��d�d �Z�d�e�e~e~e�e�e�f d�d
��d �d �Z�d�e�e�e�e~e�e�e�f e~�d
��d�d�Z�d�e�e~e�e�e�f e~�d��d�d�Z�d�e~e�e�e�f e~�d��d�d�Z�d�e~e�e�e�f e~�d��d�d�Z�d�e~e�e�e�f e~�d��d�d�Z�d�e~e�e�e�f e~�d��d�d �Z�d�e�e�e�e�f e~�d ��d �d �Z�d�e�e�e�e�f e~�d ��d!�d"�Z�d�e~e~e�e�e�f e~�d#��d$�d%�Z�d�e�e�e�e�f e~�d ��d&�d'�Z�d�e~e�e�e�f e~�d(��d)�d*�Z�d�e�e�e�f e�e�e�f e~�d ��d+�d,�Z�d�e�e�e�e�f e~�d ��d-�d.�Z�d�e~e�e�e�e�f e~�d/��d0�d1�Z�d�e�e�e~e~e�e�e�f e~�d2��d3�d4�Z�d�e~e~e~e�e�e�f e~�d5��d6�d7�Z�d�e�e~e�e�e�f e~�d8��d9�d:�Z�e~d�d;��d<�d=�Z��d>e~e~e�e�e�f e~�d?��d@�dA�Z�e~d�d;��dB�dC�Z�eu�d> e~e�e|e~�dD��dE�dF�Z�eud� e~e�e|e~�dG��dH�dI�Z��dJe~e~e�e�e�f e~�dK��dL�dM�Z��dJe�e�e�f e~�dN��dO�dP�Z�e~d�d;��dQ�dR�Z�eu�dJ e~e�e|e~�dS��dT�dU�Z��dVe~e~e�e�e�f e~�dW��dX�dY�Z��dVe�e�e�f e~�dZ��d[�d\�Z�e~d�d;��d]�d^�Z�eu�dV e~e�e|e~�d_��d`�da�Z��dbe~e~e�e�e�f e~�dc��dd�de�Z��dbe�e�e�f e~�df��dg�dh�Z�e~d�d;��di�dj�Z�eu�db e~e�e|e~�dk��dl�dm�Z��d�e~e�d� �dn��do�dp�Z��d�e~e��dJ �dn��dq�dr�Z��d�e~e��d> �dn��ds�dt�Z��d�e~e��du �dn��dv�dw�Z��d�e~e��dV �dn��dx�dy�Z��d�e~e��dz �dn��d{�d|�Z��d�e~e��d} �dn��d~�d�Z��d�e~e��db �dn��d��d��Z�e~e�e�e�f e~�d���d��d��Z�dd��d��d��Z�e�e|e~d��d��d��Z��d�e�e�e~ e~d�d���d��d��Z��d�e~e~e�e�d�e�e�e�f f �d���d��d��Z��d�e�d� e~e~e�e�d�e�e�e�f f �d���d��d��Z�dS (� r Nc C s( t |�jdkr tdt |� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )rb r- r rc )r r8 r r r r � s zvirConnect.__init__c C s t j| j�S )z"Get C pointer to underlying object)r ZvirConnect_pointerrc )r r r r rg � s zvirConnect.c_pointerr c C s( t j| j||||�}|dkr$td��|S )z3Allocate or free some pages in the huge pages pool r zvirNodeAllocPages() failedrL )r ZvirNodeAllocPagesrc r )r �pages� startCellZ cellCountr7 r9 r r r �
allocPages� s zvirConnect.allocPagesc C s$ t j| j||�}|dkr td��|S )zQComputes the most feature-rich CPU which is compatible with all given host CPUs. Nz virConnectBaselineCPU() failed)r ZvirConnectBaselineCPUrc r )r �xmlCPUsr7 r9 r r r � baselineCPU� s zvirConnect.baselineCPUc C s, t j| j||||||�}|dkr(td��|S )z|Computes the most feature-rich CPU which is compatible with all given CPUs and can be provided by the specified hypervisor. Nz(virConnectBaselineHypervisorCPU() failed)r Z virConnectBaselineHypervisorCPUrc r )r �emulator�arch�machine�virttyperk r7 r9 r r r �baselineHypervisorCPU� s z virConnect.baselineHypervisorCPUc C s" t j| j|�}|dkr td��|S )a This function creates a restore point to which one can return
later by calling virInterfaceChangeRollback(). This function should
be called before any transaction with interface configuration.
Once it is known that a new configuration works, it can be committed via
virInterfaceChangeCommit(), which frees the restore point.
If virInterfaceChangeBegin() is called when a transaction is
already opened, this function will fail, and a
VIR_ERR_INVALID_OPERATION will be logged. r z virInterfaceChangeBegin() failedrL )r ZvirInterfaceChangeBeginrc r )r r7 r9 r r r � changeBegin� s
zvirConnect.changeBeginc C s" t j| j|�}|dkr td��|S )a* This commits the changes made to interfaces and frees the restore point
created by virInterfaceChangeBegin().
If virInterfaceChangeCommit() is called when a transaction is not
opened, this function will fail, and a VIR_ERR_INVALID_OPERATION
will be logged. r z!virInterfaceChangeCommit() failedrL )r ZvirInterfaceChangeCommitrc r )r r7 r9 r r r � changeCommit� s zvirConnect.changeCommitc C s" t j| j|�}|dkr td��|S )a1 This cancels changes made to interfaces settings by restoring previous
state created by virInterfaceChangeBegin().
If virInterfaceChangeRollback() is called when a transaction is not
opened, this function will fail, and a VIR_ERR_INVALID_OPERATION
will be logged. r z#virInterfaceChangeRollback() failedrL )r ZvirInterfaceChangeRollbackrc r )r r7 r9 r r r �changeRollback� s zvirConnect.changeRollbackc C s& t j| j�}d| _|dkr"td��|S )a� This function closes the connection to the Hypervisor. This should
not be called if further interaction with the Hypervisor are needed
especially if there is running domain which need further monitoring by
the application.
Connections are reference counted; the count is explicitly
increased by the initial open (virConnectOpen, virConnectOpenAuth,
and the like) as well as virConnectRef; it is also temporarily
increased by other API that depend on the connection remaining
alive. The open and every virConnectRef call should have a
matching virConnectClose, and all other references will be released
after the corresponding operation completes. Nr zvirConnectClose() failedrL )r �virConnectCloserc r )r r9 r r r �close� s
zvirConnect.closec C s$ t j| j||�}|dkr td��|S )z�Compares the given CPU description with the host CPU.
See virConnectCompareHypervisorCPU() if you want to consider hypervisor
abilities and compare the CPU to the CPU which a hypervisor is able to
provide on the host. r z virConnectCompareCPU() failedrL )r ZvirConnectCompareCPUrc r )r r� r7 r9 r r r �
compareCPU� s zvirConnect.compareCPUc C s, t j| j||||||�}|dkr(td��|S )a� Compares the given CPU description with the CPU the specified hypervisor is
able to provide on the host. Any of @emulator, @arch, @machine, and
@virttype parameters may be None; libvirt will choose sensible defaults
tailored to the host and its current configuration.
This is different from virConnectCompareCPU() which compares the CPU
definition with the host CPU without considering any specific hypervisor and
its abilities. r z'virConnectCompareHypervisorCPU() failedrL )r Z virConnectCompareHypervisorCPUrc r )r rm rn ro rp ZxmlCPUr7 r9 r r r �compareHypervisorCPU� s z virConnect.compareHypervisorCPUc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Deprecated after 0.4.6.
Renamed to virDomainCreateXML() providing identical functionality.
This existing name will be left indefinitely for API compatibility. Nz virDomainCreateLinux() failed)r8 )r ZvirDomainCreateLinuxrc r r )r r� r7 r9 �_virConnect__tmpr r r � createLinux s
zvirConnect.createLinuxc C s0 t j| j||�}|dkr td��t| |d�}|S )a~ Launch a new guest domain, based on an XML description similar
to the one returned by virDomainGetXMLDesc()
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 virDomainDefineXML() to
define persistent domains).
If the VIR_DOMAIN_START_PAUSED flag is set, the guest domain
will be started, but its CPUs will remain paused. The CPUs
can later be manually started using virDomainResume.
If the VIR_DOMAIN_START_AUTODESTROY flag is set, the guest
domain will be automatically destroyed when the virConnectPtr
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. Hypervisors may also block save-to-file,
or snapshots.
virDomainFree should be used to free the resources after the
domain object is no longer needed. NzvirDomainCreateXML() failed)r8 )r ZvirDomainCreateXMLrc r r )r r� r7 r9 ry r r r rW s
zvirConnect.createXMLc C s. t j| j|�}|dkr td��t| |d�}|S )ay Define a domain, but does not start it.
This definition is persistent, until explicitly undefined with
virDomainUndefine(). A previous definition for this domain with the same
UUID and name would be overridden if it already exists.
virDomainFree should be used to free the resources after the
domain object is no longer needed. NzvirDomainDefineXML() failed)r8 )r ZvirDomainDefineXMLrc r r )r rq r9 ry r r r � defineXML4 s
zvirConnect.defineXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )az Defines a domain, but does not start it.
This definition is persistent, until explicitly undefined with
virDomainUndefine(). A previous definition for this domain with the same
UUID and name would be overridden if it already exists.
virDomainFree should be used to free the resources after the
domain object is no longer needed. Nz virDomainDefineXMLFlags() failed)r8 )r ZvirDomainDefineXMLFlagsrc r r )r rq r7 r9 ry r r r �defineXMLFlagsB s
zvirConnect.defineXMLFlagsc C s& t j| j|||�}|dkr"td��|S )z�Reads native configuration data describing a domain, and
generates libvirt domain XML. The format of the native
data is hypervisor dependent. Nz&virConnectDomainXMLFromNative() failed)r Z virConnectDomainXMLFromNativerc r )r � nativeFormatZ nativeConfigr7 r9 r r r �domainXMLFromNativeP s z virConnect.domainXMLFromNativec C s& t j| j|||�}|dkr"td��|S )z�Reads a domain XML configuration document, and generates
a native configuration file describing the domain.
The format of the native data is hypervisor dependent. Nz$virConnectDomainXMLToNative() failed)r ZvirConnectDomainXMLToNativerc r )r r} Z domainXmlr7 r9 r r r �domainXMLToNativeY s z virConnect.domainXMLToNativec C s& t j| j|||�}|dkr"td��|S )a Talks to a storage backend and attempts to auto-discover the set of
available storage pool sources. e.g. For iSCSI this would be a set of
iSCSI targets. For NFS this would be a list of exported paths. The
srcSpec (optional for some storage pool types, e.g. local ones) is
an instance of the storage pool's source element specifying where
to look for the pools.
srcSpec is not required for some types (e.g., those querying
local storage resources only) Nz)virConnectFindStoragePoolSources() failed)r Z virConnectFindStoragePoolSourcesrc r )r rb ZsrcSpecr7 r9 r r r �findStoragePoolSourcesf s
z!virConnect.findStoragePoolSourcesc C s" t j| j|�}|dkr td��|S )zGet node CPU information NzvirNodeGetCPUMap() failed)r ZvirNodeGetCPUMaprc r )r r7 r9 r r r � getCPUMapy s zvirConnect.getCPUMapc C s$ t j| j||�}|dkr td��|S )z&Get the list of supported CPU models. Nz#virConnectGetCPUModelNames() failed)r ZvirConnectGetCPUModelNamesrc r )r rn r7 r9 r r r �getCPUModelNames� s zvirConnect.getCPUModelNamesc C s$ t j| j||�}|dkr td��|S )z Extract node's CPU statistics. NzvirNodeGetCPUStats() failed)r ZvirNodeGetCPUStatsrc r )r ZcpuNumr7 r9 r r r r� � s zvirConnect.getCPUStatsc C s t j| j�}|dkr td��|S )z2Provides capabilities of the hypervisor / driver. Nz"virConnectGetCapabilities() failed)r ZvirConnectGetCapabilitiesrc r )r r9 r r r �getCapabilities� s zvirConnect.getCapabilitiesc C s$ t j| j||�}|dkr td��|S )z1Returns the available memory for a list of cells Nz"virNodeGetCellsFreeMemory() failed)r ZvirNodeGetCellsFreeMemoryrc r )r ri �maxCellsr9 r r r �getCellsFreeMemory� s z virConnect.getCellsFreeMemoryc C s* t j| j|||||�}|dkr&td��|S )zQuery domain capabilities Nz(virConnectGetDomainCapabilities() failed)r Z virConnectGetDomainCapabilitiesrc r )r Z emulatorbinrn ro rp r7 r9 r r r �getDomainCapabilities� s z virConnect.getDomainCapabilitiesc C s t j| j�}|S )z�provides the free memory available on the Node
Note: most libvirt APIs provide memory sizes in kibibytes, but in this
function the returned value is in bytes. Divide by 1024 as necessary. )r ZvirNodeGetFreeMemoryrc )r r9 r r r �
getFreeMemory� s zvirConnect.getFreeMemoryc C s( t j| j||||�}|dkr$td��|S )zIReturns the number of available pages for a list of cells and page sizes Nz virNodeGetFreePages() failed)r ZvirNodeGetFreePagesrc r )r rh ri r� r7 r9 r r r � getFreePages� s zvirConnect.getFreePagesc C s t j| j�}|dkr td��|S )a= This returns a system hostname on which the hypervisor is
running (based on the result of the gethostname system call, but
possibly expanded to a fully-qualified domain name via getaddrinfo).
If we are connected to a remote system, then this returns the
hostname of the remote system. Nz virConnectGetHostname() failed)r ZvirConnectGetHostnamerc r )r r9 r r r � getHostname� s zvirConnect.getHostnamec C s t j| j�}|dkr td��|S )zjExtract hardware information about the Node. Note that the memory size is reported in MiB instead of KiB. NzvirNodeGetInfo() failed)r ZvirNodeGetInforc r )r r9 r r r �getInfo� s zvirConnect.getInfoc C s t j| j�}|dkr td��|S )z3Returns the libvirt version of the connection host r z virConnectGetLibVersion() failedrL )r ZvirConnectGetLibVersionrc r )r r9 r r r �
getLibVersion� s zvirConnect.getLibVersionc C s" t j| j|�}|dkr td��|S )a� Provides the maximum number of virtual CPUs supported for a guest VM of a
specific type. The 'type' parameter here corresponds to the 'type'
attribute in the <domain> element of the XML. This API doesn't take emulator
limits into consideration, hence the returned value is not guaranteed to be
usable. It is recommended to use virConnectGetDomainCapabilities() and look
for "<vcpu max='...'>" in its output instead. r z virConnectGetMaxVcpus() failedrL )r ZvirConnectGetMaxVcpusrc r )r rb r9 r r r � getMaxVcpus� s zvirConnect.getMaxVcpusc C s" t j| j|�}|dkr td��|S )z Get the node memory parameters Nz#virNodeGetMemoryParameters() failed)r ZvirNodeGetMemoryParametersrc r )r r7 r9 r r r �getMemoryParameters� s z virConnect.getMemoryParametersc C s$ t j| j||�}|dkr td��|S )z"Extract node's memory statistics. Nz virNodeGetMemoryStats() failed)r ZvirNodeGetMemoryStatsrc r )r ZcellNumr7 r9 r r r �getMemoryStats s zvirConnect.getMemoryStatsc C s" t j| j|�}|dkr td��|S )z8Get platform specific information from the SEV firmware NzvirNodeGetSEVInfo() failed)r ZvirNodeGetSEVInforc r )r r7 r9 r r r �
getSEVInfo s zvirConnect.getSEVInfoc C s t j| j�}|dkr td��|S )z8Extract information about the hypervisor security model Nz virNodeGetSecurityModel() failed)r ZvirNodeGetSecurityModelrc r )r r9 r r r �getSecurityModel s zvirConnect.getSecurityModelc C s" t j| j|�}|dkr td��|S )z�Prior creating a storage pool (for instance via virStoragePoolCreateXML
or virStoragePoolDefineXML) it may be suitable to know what pool types
are supported along with the file/disk formats for each pool. Nz-virConnectGetStoragePoolCapabilities() failed)r Z$virConnectGetStoragePoolCapabilitiesrc r )r r7 r9 r r r �getStoragePoolCapabilities s z%virConnect.getStoragePoolCapabilitiesc C s" t j| j|�}|dkr td��|S )a This returns the XML description of the sysinfo details for the
host on which the hypervisor is running, in the same format as the
<sysinfo> element of a domain XML. This information is generally
available only for hypervisors running with root privileges. Nz virConnectGetSysinfo() failed)r ZvirConnectGetSysinforc r )r r7 r9 r r r �
getSysinfo' s zvirConnect.getSysinfoc C s t j| j�}|dkr td��|S )aX Get the name of the Hypervisor driver used. This is merely the driver
name; for example, both KVM and QEMU guests are serviced by the
driver for the qemu:// URI, so a return of "QEMU" does not indicate
whether KVM acceleration is present. For more details about the
hypervisor, use virConnectGetCapabilities(). NzvirConnectGetType() failed)r ZvirConnectGetTyperc r )r r9 r r r �getType1 s zvirConnect.getTypec C s t j| j�}|dkr td��|S )a� This returns the URI (name) of the hypervisor connection.
Normally this is the same as or similar to the string passed
to the virConnectOpen/virConnectOpenReadOnly call, but
the driver may make the URI canonical. If name == None
was passed to virConnectOpen, then the driver will return
a non-None URI which can be used to connect to the same
hypervisor later. NzvirConnectGetURI() failed)r ZvirConnectGetURIrc r )r r9 r r r �getURI< s zvirConnect.getURIc C s t j| j�}|dkr td��|S )z>Returns the running hypervisor version of the connection host r z virConnectGetVersion() failedrL )r ZvirConnectGetVersionrc r )r r9 r r r r< M s zvirConnect.getVersionc C s0 t j| j||�}|dkr td��t| |d�}|S )a[ Define an inactive persistent physical host interface or modify an existing
persistent one from the XML description.
Normally this change in the interface configuration is immediately
permanent/persistent, but if virInterfaceChangeBegin() has been
previously called (i.e. if an interface config transaction is
open), the new interface definition will only become permanent if
virInterfaceChangeCommit() is called prior to the next reboot of
the system running libvirtd. Prior to that time, it can be
explicitly removed using virInterfaceChangeRollback(), or will be
automatically removed during the next reboot of the system running
libvirtd.
virInterfaceFree should be used to free the resources after the
interface object is no longer needed. Nz virInterfaceDefineXML() failed)r8 )r ZvirInterfaceDefineXMLrc r rQ )r rq r7 r9 ry r r r �interfaceDefineXMLX s
z virConnect.interfaceDefineXMLc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup an interface on the given hypervisor based on its MAC.
virInterfaceFree should be used to free the resources after the
interface object is no longer needed. Nz&virInterfaceLookupByMACString() failed)r8 )r Z virInterfaceLookupByMACStringrc r rQ )r Zmacstrr9 ry r r r �interfaceLookupByMACStringn s
z%virConnect.interfaceLookupByMACStringc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup an interface on the given hypervisor based on its name.
virInterfaceFree should be used to free the resources after the
interface object is no longer needed. Nz!virInterfaceLookupByName() failed)r8 )r ZvirInterfaceLookupByNamerc r rQ )r r; r9 ry r r r �interfaceLookupByNamey s
z virConnect.interfaceLookupByNamec C s t j| j�}|dkr td��|S )z�Determine if the connection to the hypervisor is still alive
A connection will be classed as alive if it is either local, or running
over a channel (TCP or UNIX socket) which is not closed. r zvirConnectIsAlive() failedrL )r ZvirConnectIsAliverc r )r r9 r r r �isAlive� s zvirConnect.isAlivec C s t j| j�}|dkr td��|S )z;Determine if the connection to the hypervisor is encrypted r z virConnectIsEncrypted() failedrL )r ZvirConnectIsEncryptedrc r )r r9 r r r � isEncrypted� s zvirConnect.isEncryptedc C s t j| j�}|dkr td��|S )z�Determine if the connection to the hypervisor is secure
A connection will be classed as secure if it is either
encrypted, or running over a channel which is not exposed
to eavesdropping (eg a UNIX domain socket, or pipe) r zvirConnectIsSecure() failedrL )r ZvirConnectIsSecurerc r )r r9 r r r �isSecure� s zvirConnect.isSecurec C s t j| j�}|dkr td��|S )zElist the defined domains, stores the pointers to the names in @names Nz%virConnectListDefinedDomains() failed)r Z virConnectListDefinedDomainsrc r )r r9 r r r �listDefinedDomains� s z virConnect.listDefinedDomainsc C s t j| j�}|dkr td��|S )zHlist the defined interfaces, stores the pointers to the names in @names Nz(virConnectListDefinedInterfaces() failed)r Z virConnectListDefinedInterfacesrc r )r r9 r r r �listDefinedInterfaces� s z virConnect.listDefinedInterfacesc C s t j| j�}|dkr td��|S )zFlist the defined networks, stores the pointers to the names in @names Nz&virConnectListDefinedNetworks() failed)r Z virConnectListDefinedNetworksrc r )r r9 r r r �listDefinedNetworks� s z virConnect.listDefinedNetworksc C s t j| j�}|dkr td��|S )zJlist the defined storage pool, stores the pointers to the names in @names Nz*virConnectListDefinedStoragePools() failed)r Z!virConnectListDefinedStoragePoolsrc r )r r9 r r r �listDefinedStoragePools� s z"virConnect.listDefinedStoragePoolsc C s$ t j| j||�}|dkr td��|S )zlist the node devices NzvirNodeListDevices() failed)r ZvirNodeListDevicesrc r )r �capr7 r9 r r r � listDevices� s zvirConnect.listDevicesc C s t j| j�}|dkr td��|S )z<Returns the list of the ID of the domains on the hypervisor Nz virConnectListDomainsID() failed)r ZvirConnectListDomainsIDrc r )r r9 r r r �
listDomainsID� s zvirConnect.listDomainsIDc C s t j| j�}|dkr td��|S )zHlist the running interfaces, stores the pointers to the names in @names Nz!virConnectListInterfaces() failed)r ZvirConnectListInterfacesrc r )r r9 r r r �listInterfaces� s zvirConnect.listInterfacesc C s t j| j�}|dkr td��|S )z!List the defined network filters Nz virConnectListNWFilters() failed)r ZvirConnectListNWFiltersrc r )r r9 r r r �
listNWFilters� s zvirConnect.listNWFiltersc C s t j| j�}|dkr td��|S )z>list the networks, stores the pointers to the names in @names Nz virConnectListNetworks() failed)r ZvirConnectListNetworksrc r )r r9 r r r � listNetworks� s zvirConnect.listNetworksc C s t j| j�}|dkr td��|S )z List the defined secret IDs Nz virConnectListSecrets() failed)r ZvirConnectListSecretsrc r )r r9 r r r � listSecrets� s zvirConnect.listSecretsc C s t j| j�}|dkr td��|S )zClist the storage pools, stores the pointers to the names in @names Nz#virConnectListStoragePools() failed)r ZvirConnectListStoragePoolsrc r )r r9 r r r �listStoragePools� s zvirConnect.listStoragePoolsc C s. t j| j|�}|dkr td��t| |d�}|S )aP Try to find a domain based on the hypervisor ID number
Note that this won't work for inactive domains which have an ID of -1,
in that case a lookup based on the Name or UUID need to be done instead.
virDomainFree should be used to free the resources after the
domain object is no longer needed. Nz virDomainLookupByID() failed)r8 )r ZvirDomainLookupByIDrc r r )r �idr9 ry r r r �
lookupByID s
zvirConnect.lookupByIDc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup a domain on the given hypervisor based on its name.
virDomainFree should be used to free the resources after the
domain object is no longer needed. Nz virDomainLookupByName() failed)r8 )r ZvirDomainLookupByNamerc r r )r r; r9 ry r r r � lookupByName s
zvirConnect.lookupByNamec C s. t j| j|�}|dkr td��t| |d�}|S )zBTry to lookup a domain on the given hypervisor based on its UUID. Nz virDomainLookupByUUID() failed)r8 )r ZvirDomainLookupByUUIDrc r r )r rD r9 ry r r r � lookupByUUID% s
zvirConnect.lookupByUUIDc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup a domain on the given hypervisor based on its UUID.
virDomainFree should be used to free the resources after the
domain object is no longer needed. Nz$virDomainLookupByUUIDString() failed)r8 )r ZvirDomainLookupByUUIDStringrc r r )r rF r9 ry r r r �lookupByUUIDString1 s
z virConnect.lookupByUUIDStringc C s. t j| j|�}|dkr td��t| |d�}|S )z�Create and start a new virtual network, based on an XML description
similar to the one returned by virNetworkGetXMLDesc()
virNetworkFree should be used to free the resources after the
network object is no longer needed. Nz virNetworkCreateXML() failed)r8 )r ZvirNetworkCreateXMLrc r r> )r r� r9 ry r r r �networkCreateXML@ s
zvirConnect.networkCreateXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Create and start a new virtual network, based on an XML description
similar to the one returned by virNetworkGetXMLDesc()
virNetworkFree should be used to free the resources after the
network object is no longer needed. Nz!virNetworkCreateXMLFlags() failed)r8 )r ZvirNetworkCreateXMLFlagsrc r r> )r r� r7 r9 ry r r r �networkCreateXMLFlagsL s
z virConnect.networkCreateXMLFlagsc C s. t j| j|�}|dkr td��t| |d�}|S )z�Define an inactive persistent virtual network or modify an existing
persistent one from the XML description.
virNetworkFree should be used to free the resources after the
network object is no longer needed. Nz virNetworkDefineXML() failed)r8 )r ZvirNetworkDefineXMLrc r r> )r rq r9 ry r r r �networkDefineXMLX s
zvirConnect.networkDefineXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Define an inactive persistent virtual network or modify an existing
persistent one from the XML description.
virNetworkFree should be used to free the resources after the
network object is no longer needed. Nz!virNetworkDefineXMLFlags() failed)r8 )r ZvirNetworkDefineXMLFlagsrc r r> )r rq r7 r9 ry r r r �networkDefineXMLFlagsd s
z virConnect.networkDefineXMLFlagsc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup a network on the given hypervisor based on its name.
virNetworkFree should be used to free the resources after the
network object is no longer needed. Nz virNetworkLookupByName() failed)r8 )r ZvirNetworkLookupByNamerc r r> )r r; r9 ry r r r �networkLookupByNamep s
z virConnect.networkLookupByNamec C s. t j| j|�}|dkr td��t| |d�}|S )zCTry to lookup a network on the given hypervisor based on its UUID. Nz virNetworkLookupByUUID() failed)r8 )r ZvirNetworkLookupByUUIDrc r r> )r rD r9 ry r r r �networkLookupByUUID s
z virConnect.networkLookupByUUIDc C s. t j| j|�}|dkr td��t| |d�}|S )zCTry to lookup a network on the given hypervisor based on its UUID. Nz%virNetworkLookupByUUIDString() failed)r8 )r Z virNetworkLookupByUUIDStringrc r r> )r rF r9 ry r r r �networkLookupByUUIDString� s
z$virConnect.networkLookupByUUIDStringc C s. t j| j|�}|dkr td��t| |d�}|S )a Creates a new stream object which can be used to perform
streamed I/O with other public API function.
When no longer needed, a stream object must be released
with virStreamFree. If a data stream has been used,
then the application must call virStreamFinish or
virStreamAbort before free'ing to, in order to notify
the driver of termination.
If a non-blocking data stream is required passed
VIR_STREAM_NONBLOCK for flags, otherwise pass 0. NzvirStreamNew() failed)r8 )r Z virStreamNewrc r � virStream)r r7 r9 ry r r r � newStream� s
zvirConnect.newStreamc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Create a new device on the VM host machine, for example, virtual
HBAs created using vport_create.
virNodeDeviceFree should be used to free the resources after the
node device object is no longer needed. Nz virNodeDeviceCreateXML() failed)r8 )r ZvirNodeDeviceCreateXMLrc r �
virNodeDevice)r r� r7 r9 ry r r r �nodeDeviceCreateXML� s
z virConnect.nodeDeviceCreateXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Define a new device on the VM host machine, for example, a mediated device
virNodeDeviceFree should be used to free the resources after the
node device object is no longer needed. Nz virNodeDeviceDefineXML() failed)r8 )r ZvirNodeDeviceDefineXMLrc r r� )r r� r7 r9 ry r r r �nodeDeviceDefineXML� s
z virConnect.nodeDeviceDefineXMLc C s. t j| j|�}|dkr td��t| |d�}|S )z�Lookup a node device by its name.
virNodeDeviceFree should be used to free the resources after the
node device object is no longer needed. Nz"virNodeDeviceLookupByName() failed)r8 )r ZvirNodeDeviceLookupByNamerc r r� )r r; r9 ry r r r �nodeDeviceLookupByName� s
z!virConnect.nodeDeviceLookupByNamec C s2 t j| j|||�}|dkr"td��t| |d�}|S )z�Lookup SCSI Host which is capable with 'fc_host' by its WWNN and WWPN.
virNodeDeviceFree should be used to free the resources after the
node device object is no longer needed. Nz)virNodeDeviceLookupSCSIHostByWWN() failed)r8 )r Z virNodeDeviceLookupSCSIHostByWWNrc r r� )r ZwwnnZwwpnr7 r9 ry r r r � nodeDeviceLookupSCSIHostByWWN� s
z(virConnect.nodeDeviceLookupSCSIHostByWWNc C s t j| j�}|dkr td��|S )z5Provides the number of defined but inactive domains. r z&virConnectNumOfDefinedDomains() failedrL )r Z virConnectNumOfDefinedDomainsrc r )r r9 r r r �numOfDefinedDomains� s z virConnect.numOfDefinedDomainsc C s t j| j�}|dkr td��|S )zKProvides the number of defined (inactive) interfaces on the physical host. r z)virConnectNumOfDefinedInterfaces() failedrL )r Z virConnectNumOfDefinedInterfacesrc r )r r9 r r r �numOfDefinedInterfaces� s z!virConnect.numOfDefinedInterfacesc C s t j| j�}|dkr td��|S )z*Provides the number of inactive networks. r z'virConnectNumOfDefinedNetworks() failedrL )r Z virConnectNumOfDefinedNetworksrc r )r r9 r r r �numOfDefinedNetworks� s z virConnect.numOfDefinedNetworksc C s t j| j�}|dkr td��|S )z.Provides the number of inactive storage pools r z+virConnectNumOfDefinedStoragePools() failedrL )r Z"virConnectNumOfDefinedStoragePoolsrc r )r r9 r r r �numOfDefinedStoragePools� s z#virConnect.numOfDefinedStoragePoolsc C s$ t j| j||�}|dkr td��|S )z�Provides the number of node devices.
If the optional 'cap' argument is non-None, then the count
will be restricted to devices with the specified capability r z virNodeNumOfDevices() failedrL )r ZvirNodeNumOfDevicesrc r )r r� r7 r9 r r r � numOfDevices
s zvirConnect.numOfDevicesc C s t j| j�}|dkr td��|S )z'Provides the number of active domains. r z virConnectNumOfDomains() failedrL )r ZvirConnectNumOfDomainsrc r )r r9 r r r � numOfDomains s zvirConnect.numOfDomainsc C s t j| j�}|dkr td��|S )z?Provides the number of active interfaces on the physical host. r z"virConnectNumOfInterfaces() failedrL )r ZvirConnectNumOfInterfacesrc r )r r9 r r r �numOfInterfaces# s zvirConnect.numOfInterfacesc C s t j| j�}|dkr td��|S )z"Provides the number of nwfilters. r z!virConnectNumOfNWFilters() failedrL )r ZvirConnectNumOfNWFiltersrc r )r r9 r r r �numOfNWFilters. s zvirConnect.numOfNWFiltersc C s t j| j�}|dkr td��|S )z(Provides the number of active networks. r z virConnectNumOfNetworks() failedrL )r ZvirConnectNumOfNetworksrc r )r r9 r r r �
numOfNetworks9 s zvirConnect.numOfNetworksc C s t j| j�}|dkr td��|S )z+Fetch number of currently defined secrets. r z virConnectNumOfSecrets() failedrL )r ZvirConnectNumOfSecretsrc r )r r9 r r r � numOfSecretsD s zvirConnect.numOfSecretsc C s t j| j�}|dkr td��|S )z,Provides the number of active storage pools r z$virConnectNumOfStoragePools() failedrL )r ZvirConnectNumOfStoragePoolsrc r )r r9 r r r �numOfStoragePoolsO s z virConnect.numOfStoragePoolsc C s0 t j| j||�}|dkr td��t| |d�}|S )a� Define a new network filter, based on an XML description
similar to the one returned by virNWFilterGetXMLDesc(). This
API may be used to associate a filter with a currently running
guest that does not have a filter defined for a specific network
port. Since the bindings are generally automatically managed by
the hypervisor, using this command to define a filter for a network
port and then starting the guest afterwards may prevent the guest
from starting if it attempts to use the network port and finds a
filter already defined.
virNWFilterFree should be used to free the resources after the
binding object is no longer needed. Nz$virNWFilterBindingCreateXML() failed)r8 )r ZvirNWFilterBindingCreateXMLrc r �virNWFilterBinding)r rq r7 r9 ry r r r �nwfilterBindingCreateXMLZ s
z#virConnect.nwfilterBindingCreateXMLc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup a network filter binding on the given hypervisor based
on network port device name.
virNWFilterBindingFree should be used to free the resources after the
binding object is no longer needed. Nz*virNWFilterBindingLookupByPortDev() failed)r8 )r Z!virNWFilterBindingLookupByPortDevrc r r� )r Zportdevr9 ry r r r � nwfilterBindingLookupByPortDevm s
z)virConnect.nwfilterBindingLookupByPortDevc C s. t j| j|�}|dkr td��t| |d�}|S )z�Define a new network filter, based on an XML description
similar to the one returned by virNWFilterGetXMLDesc()
virNWFilterFree should be used to free the resources after the
nwfilter object is no longer needed. Nz virNWFilterDefineXML() failed)r8 )r ZvirNWFilterDefineXMLrc r � virNWFilter)r r� r9 ry r r r �nwfilterDefineXMLy s
z virConnect.nwfilterDefineXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Define a new network filter, based on an XML description
similar to the one returned by virNWFilterGetXMLDesc()
virNWFilterFree should be used to free the resources after the
nwfilter object is no longer needed. Nz"virNWFilterDefineXMLFlags() failed)r8 )r ZvirNWFilterDefineXMLFlagsrc r r� )r r� r7 r9 ry r r r �nwfilterDefineXMLFlags� s
z!virConnect.nwfilterDefineXMLFlagsc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup a network filter on the given hypervisor based on its name.
virNWFilterFree should be used to free the resources after the
nwfilter object is no longer needed. Nz virNWFilterLookupByName() failed)r8 )r ZvirNWFilterLookupByNamerc r r� )r r; r9 ry r r r �nwfilterLookupByName� s
z virConnect.nwfilterLookupByNamec C s. t j| j|�}|dkr td��t| |d�}|S )zJTry to lookup a network filter on the given hypervisor based on its UUID. Nz virNWFilterLookupByUUID() failed)r8 )r ZvirNWFilterLookupByUUIDrc r r� )r rD r9 ry r r r �nwfilterLookupByUUID� s
z virConnect.nwfilterLookupByUUIDc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup an nwfilter on the given hypervisor based on its UUID.
virNWFilterFree should be used to free the resources after the
nwfilter object is no longer needed. Nz&virNWFilterLookupByUUIDString() failed)r8 )r Z virNWFilterLookupByUUIDStringrc r r� )r rF r9 ry r r r �nwfilterLookupByUUIDString� s
z%virConnect.nwfilterLookupByUUIDStringc C s" t j| j|�}|dkr td��|S )z�This method will restore a domain saved to disk by virDomainSave().
See virDomainRestoreFlags() for more control. r zvirDomainRestore() failedrL )r ZvirDomainRestorerc r )r �frmr9 r r r �restore� s zvirConnect.restorec C s& t j| j|||�}|dkr"td��|S )ae This method will restore a domain saved to disk by virDomainSave().
If the hypervisor supports it, @dxml can be used to alter
host-specific portions of the domain XML that will be used when
restoring an image. For example, it is possible to alter the
backing filename that is associated with a disk device, in order to
prepare for file renaming done as part of backing up the disk
device while the domain is stopped.
If @flags includes VIR_DOMAIN_SAVE_BYPASS_CACHE, then libvirt will
attempt to bypass the file system cache while restoring the file, or
fail if it cannot do so for the given system; this can allow less
pressure on file system cache, but also risks slowing restores from NFS.
Normally, the saved state file will remember whether the domain was
running or paused, and restore defaults to the same state.
Specifying VIR_DOMAIN_SAVE_RUNNING or VIR_DOMAIN_SAVE_PAUSED in
@flags will override the default read from the file. These two
flags are mutually exclusive. r z virDomainRestoreFlags() failedrL )r ZvirDomainRestoreFlagsrc r )r r� r� r7 r9 r r r � restoreFlags� s zvirConnect.restoreFlagsc C s& t j| j|||�}|dkr"td��|S )a� This updates the definition of a domain stored in a saved state
file. @file must be a file created previously by virDomainSave()
or virDomainSaveFlags().
@dxml can be used to alter host-specific portions of the domain XML
that will be used when restoring an image. For example, it is
possible to alter the backing filename that is associated with a
disk device, to match renaming done as part of backing up the disk
device while the domain is stopped.
Normally, the saved state file will remember whether the domain was
running or paused, and restore defaults to the same state.
Specifying VIR_DOMAIN_SAVE_RUNNING or VIR_DOMAIN_SAVE_PAUSED in
@flags will override the default saved into the file; omitting both
leaves the file's default unchanged. These two flags are mutually
exclusive. r z$virDomainSaveImageDefineXML() failedrL )r ZvirDomainSaveImageDefineXMLrc r )r �filer� r7 r9 r r r �saveImageDefineXML� s z virConnect.saveImageDefineXMLc C s$ t j| j||�}|dkr td��|S )aF This method will extract the XML describing the domain at the time
a saved state file was created. @file must be a file created
previously by virDomainSave() or virDomainSaveFlags().
No security-sensitive data will be included unless @flags contains
VIR_DOMAIN_SAVE_IMAGE_XML_SECURE. Nz%virDomainSaveImageGetXMLDesc() failed)r Z virDomainSaveImageGetXMLDescrc r )r r� r7 r9 r r r �saveImageGetXMLDesc� s z virConnect.saveImageGetXMLDescc C s0 t j| j||�}|dkr td��t| |d�}|S )a� If XML specifies a UUID, locates the specified secret and replaces all
attributes of the secret specified by UUID by attributes specified in xml
(any attributes not specified in xml are discarded).
Otherwise, creates a new secret with an automatically chosen UUID, and
initializes its attributes from xml.
virSecretFree should be used to free the resources after the
secret object is no longer needed. NzvirSecretDefineXML() failed)r8 )r ZvirSecretDefineXMLrc r � virSecret)r rq r7 r9 ry r r r �secretDefineXML s
zvirConnect.secretDefineXMLc C s. t j| j|�}|dkr td��t| |d�}|S )zBTry to lookup a secret on the given hypervisor based on its UUID. Nz virSecretLookupByUUID() failed)r8 )r ZvirSecretLookupByUUIDrc r r� )r rD r9 ry r r r �secretLookupByUUID s
z virConnect.secretLookupByUUIDc C s. t j| j|�}|dkr td��t| |d�}|S )z�Try to lookup a secret on the given hypervisor based on its UUID.
Uses the printable string value to describe the UUID
virSecretFree should be used to free the resources after the
secret object is no longer needed. Nz$virSecretLookupByUUIDString() failed)r8 )r ZvirSecretLookupByUUIDStringrc r r� )r rF r9 ry r r r �secretLookupByUUIDString# s
z#virConnect.secretLookupByUUIDStringc C s0 t j| j||�}|dkr td��t| |d�}|S )a Try to lookup a secret on the given hypervisor based on its usage
The usageID is unique within the set of secrets sharing the
same usageType value.
virSecretFree should be used to free the resources after the
secret object is no longer needed. Nz virSecretLookupByUsage() failed)r8 )r ZvirSecretLookupByUsagerc r r� )r � usageType�usageIDr9 ry r r r �secretLookupByUsage/ s
z virConnect.secretLookupByUsagec C s$ t j| j||�}|dkr td��|S )zJOverride the default identity information associated with the connection. r z virConnectSetIdentity() failedrL )r ZvirConnectSetIdentityrc r )r r� r7 r9 r r r � setIdentity@ s zvirConnect.setIdentityc C s$ t j| j||�}|dkr td��|S )a Start sending keepalive messages after @interval seconds of inactivity and
consider the connection to be broken when no response is received after
@count keepalive messages sent in a row. In other words, sending count + 1
keepalive message results in closing the connection. When @interval is
<= 0, no keepalive messages will be sent. When @count is 0, the connection
will be automatically closed after @interval seconds of inactivity without
sending any keepalive messages.
Note: The client has to implement and run an event loop with
virEventRegisterImpl() or virEventRegisterDefaultImpl() to be able to
use keepalive messages. Failure to do so may result in connections
being closed unexpectedly.
Note: This API function controls only keepalive messages sent by the client.
If the server is configured to use keepalive you still need to run the event
loop to respond to them, even if you disable keepalives by this function. r z virConnectSetKeepAlive() failedrL )r ZvirConnectSetKeepAliverc r )r Zinterval�countr9 r r r � setKeepAliveG s zvirConnect.setKeepAlivec C s$ t j| j||�}|dkr td��|S )z Change the node memory tunables r z#virNodeSetMemoryParameters() failedrL )r ZvirNodeSetMemoryParametersrc r )r r� r7 r9 r r r r a s z virConnect.setMemoryParametersc C s0 t j| j||�}|dkr td��t| |d�}|S )a6 Create a new storage based on its XML description. The
pool is not persistent, so its definition will disappear
when it is destroyed, or if the host is restarted
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz virStoragePoolCreateXML() failed)r8 )r ZvirStoragePoolCreateXMLrc r rS )r r� r7 r9 ry r r r �storagePoolCreateXMLl s
z virConnect.storagePoolCreateXMLc C s0 t j| j||�}|dkr td��t| |d�}|S )z�Define an inactive persistent storage pool or modify an existing persistent
one from the XML description.
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz virStoragePoolDefineXML() failed)r8 )r ZvirStoragePoolDefineXMLrc r rS )r rq r7 r9 ry r r r �storagePoolDefineXMLy s
z virConnect.storagePoolDefineXMLc C s. t j| j|�}|dkr td��t| |d�}|S )z�Fetch a storage pool based on its unique name
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz#virStoragePoolLookupByName() failed)r8 )r ZvirStoragePoolLookupByNamerc r rS )r r; r9 ry r r r �storagePoolLookupByName� s
z"virConnect.storagePoolLookupByNamec C s. t j| j|�}|dkr td��t| |d�}|S )a, Fetch a storage pool which maps to a particular target directory.
If more than one pool maps to the path, it is undefined which
will be returned first.
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz)virStoragePoolLookupByTargetPath() failed)r8 )r Z virStoragePoolLookupByTargetPathrc r rS )r r� r9 ry r r r � storagePoolLookupByTargetPath� s
z(virConnect.storagePoolLookupByTargetPathc C s. t j| j|�}|dkr td��t| |d�}|S )z�Fetch a storage pool based on its globally unique id
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz#virStoragePoolLookupByUUID() failed)r8 )r ZvirStoragePoolLookupByUUIDrc r rS )r rD r9 ry r r r �storagePoolLookupByUUID� s
z"virConnect.storagePoolLookupByUUIDc C s. t j| j|�}|dkr td��t| |d�}|S )z�Fetch a storage pool based on its globally unique id
virStoragePoolFree should be used to free the resources after the
storage pool object is no longer needed. Nz)virStoragePoolLookupByUUIDString() failed)r8 )r Z virStoragePoolLookupByUUIDStringrc r rS )r rF r9 ry r r r � storagePoolLookupByUUIDString� s
z(virConnect.storagePoolLookupByUUIDStringc C s. t j| j|�}|dkr td��t| |d�}|S )z�Fetch a pointer to a storage volume based on its
globally unique key
virStorageVolFree should be used to free the resources after the
storage volume object is no longer needed. Nz!virStorageVolLookupByKey() failed)r8 )r ZvirStorageVolLookupByKeyrc r rU )r r r9 ry r r r �storageVolLookupByKey� s
z virConnect.storageVolLookupByKeyc C s. t j| j|�}|dkr td��t| |d�}|S )z�Fetch a pointer to a storage volume based on its
locally (host) unique path
virStorageVolFree should be used to free the resources after the
storage volume object is no longer needed. Nz"virStorageVolLookupByPath() failed)r8 )r ZvirStorageVolLookupByPathrc r rU )r r� r9 ry r r r �storageVolLookupByPath� s
z!virConnect.storageVolLookupByPathc C s& t j| j|||�}|dkr"td��|S )a Attempt to suspend the node (host machine) for the given duration of
time in the specified state (Suspend-to-RAM, Suspend-to-Disk or
Hybrid-Suspend). Schedule the node's Real-Time-Clock interrupt to
resume the node after the duration is complete. r z"virNodeSuspendForDuration() failedrL )r ZvirNodeSuspendForDurationrc r )r r� r� r7 r9 r r r �suspendForDuration� s z virConnect.suspendForDurationc C s t j| j�}|S )a� Provide a pointer to the last error caught on that connection
This method is not protected against access from multiple
threads. In a multi-threaded application, always use the
global virGetLastError() API which is backed by thread
local storage.
If the connection object was discovered to be invalid by
an API call, then the error will be reported against the
global error object.
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 virGetLastError(). This method
remains for backwards compatibility. )r �virConnGetLastErrorrc )r r9 r r r r� � s z virConnect.virConnGetLastErrorc C s t j| j� dS )z�The error object is kept in thread local storage, so separate
threads can safely access this concurrently.
Reset the last error caught on that connection N)r �virConnResetLastErrorrc )r r r r r� � s z virConnect.virConnResetLastError)r c C sV y | j j� | ` tj| j| � W n tk
r4 Y nX | jd k rLtj| j� d | _d S )N)�domainEventCallbacks�clearr � virConnectDomainEventDeregisterrc �AttributeErrorru )r r r r re � s
zvirConnect.__del__c C s | S )Nr )r r r r � __enter__ s zvirConnect.__enter__)� exc_type_�
exc_value_�
traceback_r c C s | j � d S )N)rv )r r� r� r� r r r �__exit__ s zvirConnect.__exit__)rI r c C sV y<| j |= t| j �dkr:| ` tj| j| �}|dkr:td��W n tk
rP Y nX dS )zzRemoves a Domain Event Callback. De-registering for a
domain callback will disable delivery of this event type r r z(virConnectDomainEventDeregister() failedNrL )r� �lenr r� rc r r� )r rI r9 r r r �domainEventDeregister s z virConnect.domainEventDeregister)rI r@ r c C sP y|| j |< W n< tk
rJ ||i| _ tj| j| �}|dkrFtd��Y nX dS )znAdds a Domain Event Callback. Registering for a domain
callback will enable delivery of the events r z&virConnectDomainEventRegister() failedNrL )r� r� r Z virConnectDomainEventRegisterrc r )r rI r@ r9 r r r �domainEventRegister s
z virConnect.domainEventRegisterr )�domr? �detailr c
C sN y4x.| j j� D ] \}}|| t| |d�|||� qW W n tk
rH Y nX dS )z@Dispatches events to python user domain event callbacks
)r8 N)r� �itemsr r� )r r� r? r� rI r@ r r r � _dispatchDomainEventCallbacks$ s
z(virConnect._dispatchDomainEventCallbacks)r� r? r� rH r c C s, |d }|d }|| t | |d�|||� dS )zJDispatches events to python user domain lifecycle event callbacks
rI r@ )r8 r )r )r r� r? r� rH rI r@ r r r �%_dispatchDomainEventLifecycleCallback- s z0virConnect._dispatchDomainEventLifecycleCallback)r� rH r c C s( |d }|d }|| t | |d�|� dS )zHDispatches events to python user domain generic event callbacks
rI r@ )r8 r )r )r r� rH rI r@ r r r �#_dispatchDomainEventGenericCallback6 s z.virConnect._dispatchDomainEventGenericCallback)r� r� rH r c C s* |d }|d }|| t | |d�||� dS )zKDispatches events to python user domain RTC change event callbacks
rI r@ )r8 r )r )r r� r� rH rI r@ r r r �%_dispatchDomainEventRTCChangeCallback? s z0virConnect._dispatchDomainEventRTCChangeCallback)r� r
rH r c C s* |d }|d }|| t | |d�||� dS )zIDispatches events to python user domain watchdog event callbacks
rI r@ )r8 r )r )r r� r
rH rI r@ r r r �$_dispatchDomainEventWatchdogCallbackH s z/virConnect._dispatchDomainEventWatchdogCallback)r� �srcPath�devAliasr
rH r c C s. |d }|d }|| t | |d�||||� dS )zIDispatches events to python user domain IO error event callbacks
rI r@ )r8 r )r )r r� r� r� r
rH rI r@ r r r �#_dispatchDomainEventIOErrorCallbackQ s z.virConnect._dispatchDomainEventIOErrorCallback)r� r� r� r
�reasonrH r c C s0 |d }|d }|| t | |d�|||||� dS )zIDispatches events to python user domain IO error event callbacks
rI r@ )r8 r )r ) r r� r� r� r
r rH rI r@ r r r �)_dispatchDomainEventIOErrorReasonCallbackZ s
z4virConnect._dispatchDomainEventIOErrorReasonCallback)r� �phase� localAddr�
remoteAddr�
authScheme�subjectrH r c
C s2 |d }|d } || t | |d�|||||| � dS )zIDispatches events to python user domain graphics event callbacks
rI r@ )r8 r )r )
r r� r r r r r rH rI r@ r r r �$_dispatchDomainEventGraphicsCallbackd s
z/virConnect._dispatchDomainEventGraphicsCallback)r� r| rb �statusrH r c
C sH y.|d }|d }|| t | |d�||||� W n tk
rB Y nX dS )zSDispatches events to python user domain blockJob/blockJob2 event callbacks
rI r@ )r8 N)r r� )r r� r| rb r rH rI r@ r r r �$_dispatchDomainEventBlockJobCallbackn s z/virConnect._dispatchDomainEventBlockJobCallback)r� �
oldSrcPath�
newSrcPathr� r rH r c C s0 |d }|d }|| t | |d�|||||� dS )zJDispatches event to python user domain diskChange event callbacks
rI r@ )r8 r )r ) r r� r
r r� r rH rI r@ r r r �&_dispatchDomainEventDiskChangeCallbacky s z1virConnect._dispatchDomainEventDiskChangeCallback)r� r� r rH r c C s, |d }|d }|| t | |d�|||� dS )zJDispatches event to python user domain trayChange event callbacks
rI r@ )r8 r )r )r r� r� r rH rI r@ r r r �&_dispatchDomainEventTrayChangeCallback� s z1virConnect._dispatchDomainEventTrayChangeCallback)r� r rH r c C s* |d }|d }|| t | |d�||� dS )zHDispatches event to python user domain pmwakeup event callbacks
rI r@ )r8 r )r )r r� r rH rI r@ r r r �$_dispatchDomainEventPMWakeupCallback� s z/virConnect._dispatchDomainEventPMWakeupCallbackc C s* |d }|d }|| t | |d�||� dS )zIDispatches event to python user domain pmsuspend event callbacks
rI r@ )r8 r )r )r r� r rH rI r@ r r r �%_dispatchDomainEventPMSuspendCallback� s z0virConnect._dispatchDomainEventPMSuspendCallback)r� �actualrH r c C s* |d }|d }|| t | |d�||� dS )zODispatches events to python user domain balloon change event callbacks
rI r@ )r8 r )r )r r� r rH rI r@ r r r �)_dispatchDomainEventBalloonChangeCallback� s z4virConnect._dispatchDomainEventBalloonChangeCallbackc C s* |d }|d }|| t | |d�||� dS )zNDispatches event to python user domain pmsuspend-disk event callbacks
rI r@ )r8 r )r )r r� r rH rI r@ r r r �)_dispatchDomainEventPMSuspendDiskCallback� s z4virConnect._dispatchDomainEventPMSuspendDiskCallback)r� r� rH r c C s* |d }|d }|| t | |d�||� dS )zNDispatches event to python user domain device removed event callbacks
rI r@ )r8 r )r )r r� r� rH rI r@ r r r �)_dispatchDomainEventDeviceRemovedCallback� s z4virConnect._dispatchDomainEventDeviceRemovedCallback)r� r� rH r c C s* |d }|d }|| t | |d�||� dS )zGDispatches event to python user domain tunable event callbacks
rI r@ )r8 r )r )r r� r� rH rI r@ r r r �#_dispatchDomainEventTunableCallback� s z.virConnect._dispatchDomainEventTunableCallback)r� r r rH r c C s, |d }|d }|| t | |d�|||� dS )zNDispatches event to python user domain agent lifecycle event callback
rI r@ )r8 r )r )r r� r r rH rI r@ r r r �*_dispatchDomainEventAgentLifecycleCallback� s z5virConnect._dispatchDomainEventAgentLifecycleCallbackc C s* |d }|d }|| t | |d�||� dS )zLDispatches event to python user domain device added event callbacks
rI r@ )r8 r )r )r r� r� rH rI r@ r r r �'_dispatchDomainEventDeviceAddedCallback� s z2virConnect._dispatchDomainEventDeviceAddedCallback)r� � iterationrH r c C s* |d }|d }|| t | |d�||� dS )zSDispatches event to python user domain migration iteration event callbacks
rI r@ )r8 r )r )r r� r rH rI r@ r r r �._dispatchDomainEventMigrationIterationCallback� s z9virConnect._dispatchDomainEventMigrationIterationCallbackc C s* |d }|d }|| t | |d�||� dS )zGDispatches event to python user domain job completed callbacks
rI r@ )r8 r )r )r r� r� rH rI r@ r r r �(_dispatchDomainEventJobCompletedCallback� s z3virConnect._dispatchDomainEventJobCompletedCallbackc C s* |d }|d }|| t | |d�||� dS )zUDispatches event to python user domain device removal failed event callbacks
rI r@ )r8 r )r )r r� r� rH rI r@ r r r �/_dispatchDomainEventDeviceRemovalFailedCallback� s z:virConnect._dispatchDomainEventDeviceRemovalFailedCallback)r� �mtype�nsurirH r c C s, |d }|d }|| t | |d�|||� dS )zODispatches event to python user domain metadata change event callbacks
rI r@ )r8 r )r )r r� r r rH rI r@ r r r �*_dispatchDomainEventMetadataChangeCallback� s z5virConnect._dispatchDomainEventMetadataChangeCallback)r� r r� r �excessrH r c C s0 |d }|d }|| t | |d�|||||� dS )zVDispatches event to python user domain block device threshold event callbacks
rI r@ )r8 r )r ) r r� r r� r r rH rI r@ r r r �*_dispatchDomainEventBlockThresholdCallback� s z5virConnect._dispatchDomainEventBlockThresholdCallback)r� � recipientr
r7 rH r c C s. |d }|d }|| t | |d�||||� dS )zNDispatches event to python user domain memory failure event callbacks
rI r@ )r8 r )r )r r� r r
r7 rH rI r@ r r r �)_dispatchDomainEventMemoryFailureCallback s z4virConnect._dispatchDomainEventMemoryFailureCallback)r� r� r� rH r c C s, |d }|d }|| t | |d�|||� dS )zYDispatches event to python user domain memory device size change event callbacks
rI r@ )r8 r )r )r r� r� r� rH rI r@ r r r �2_dispatchDomainEventMemoryDeviceSizeChangeCallback
s z=virConnect._dispatchDomainEventMemoryDeviceSizeChangeCallback)�
callbackIDr c C sD y*t j| j|�}|dkr td��| j|= W n tk
r> Y nX dS )zzRemoves a Domain Event Callback. De-registering for a
domain callback will disable delivery of this event type r z+virConnectDomainEventDeregisterAny() failedNrL )r Z"virConnectDomainEventDeregisterAnyrc r �domainEventCallbackIDr� )r r# r9 r r r �domainEventDeregisterAny s z#virConnect.domainEventDeregisterAnyr> )rL r? r� rH r c C s, |d }|d }|| t | |d�|||� dS )zKDispatches events to python user network lifecycle event callbacks
rI r@ )r8 r )r> )r rL r? r� rH rI r@ r r r �&_dispatchNetworkEventLifecycleCallback s z1virConnect._dispatchNetworkEventLifecycleCallbackc C sD y*t j| j|�}|dkr td��| j|= W n tk
r> Y nX dS )z{Removes a Network Event Callback. De-registering for a
network callback will disable delivery of this event typer z,virConnectNetworkEventDeregisterAny() failedNrL )r Z#virConnectNetworkEventDeregisterAnyrc r �networkEventCallbackIDr� )r r# r9 r r r �networkEventDeregisterAny' s z$virConnect.networkEventDeregisterAny)rL �eventIDrI r@ r c C sj t | d�si | _|| |d�}|dkr8tj| jd||�}ntj| j|j||�}|dkr\td��|| j|< |S )zoAdds a Network Event Callback. Registering for a network
callback will enable delivery of the eventsr' )rI rd r@ Nr z*virConnectNetworkEventRegisterAny() failedrL )�hasattrr' r Z!virConnectNetworkEventRegisterAnyrc r )r rL r) rI r@ rH r9 r r r �networkEventRegisterAny2 s
z"virConnect.networkEventRegisterAny)r� r) rI r@ r c C sj t | d�si | _|| |d�}|dkr8tj| jd||�}ntj| j|j||�}|dkr\td��|| j|< |S )znAdds a Domain Event Callback. Registering for a domain
callback will enable delivery of the events r$ )rI rd r@ Nr z)virConnectDomainEventRegisterAny() failedrL )r* r$ r Z virConnectDomainEventRegisterAnyrc r )r r� r) rI r@ rH r9 r r r �domainEventRegisterAnyA s
z!virConnect.domainEventRegisterAnyrS )�poolr? r� rH r c C s, |d }|d }|| t | |d�|||� dS )z[Dispatches events to python user storage pool
lifecycle event callbacks
rI r@ )r8 r )rS )r r- r? r� rH rI r@ r r r �*_dispatchStoragePoolEventLifecycleCallbackP s z5virConnect._dispatchStoragePoolEventLifecycleCallback)r- rH r c C s( |d }|d }|| t | |d�|� dS )zYDispatches events to python user storage pool
generic event callbacks
rI r@ )r8 r )rS )r r- rH rI r@ r r r �(_dispatchStoragePoolEventGenericCallbackZ s z3virConnect._dispatchStoragePoolEventGenericCallbackc C sD y*t j| j|�}|dkr td��| j|= W n tk
r> Y nX dS )z�Removes a Storage Pool Event Callback. De-registering for a
storage pool callback will disable delivery of this event typer z0virConnectStoragePoolEventDeregisterAny() failedNrL )r Z'virConnectStoragePoolEventDeregisterAnyrc r �storagePoolEventCallbackIDr� )r r# r9 r r r � storagePoolEventDeregisterAnyd s z(virConnect.storagePoolEventDeregisterAny)r- r) rI r@ r c C sj t | d�si | _|| |d�}|dkr8tj| jd||�}ntj| j|j||�}|dkr\td��|| j|< |S )zyAdds a Storage Pool Event Callback. Registering for a storage pool
callback will enable delivery of the eventsr0 )rI rd r@ Nr z.virConnectStoragePoolEventRegisterAny() failedrL )r* r0 r Z%virConnectStoragePoolEventRegisterAnyrc r )r r- r) rI r@ rH r9 r r r �storagePoolEventRegisterAnyo s
z&virConnect.storagePoolEventRegisterAnyr� )r r? r� rH r c C s, |d }|d }|| t | |d�|||� dS )zZDispatches events to python user node device
lifecycle event callbacks
rI r@ )r8 r )r� )r r r? r� rH rI r@ r r r �)_dispatchNodeDeviceEventLifecycleCallback~ s z4virConnect._dispatchNodeDeviceEventLifecycleCallback)r rH r c C s( |d }|d }|| t | |d�|� dS )zXDispatches events to python user node device
generic event callbacks
rI r@ )r8 r )r� )r r rH rI r@ r r r �'_dispatchNodeDeviceEventGenericCallback� s z2virConnect._dispatchNodeDeviceEventGenericCallbackc C sD y*t j| j|�}|dkr td��| j|= W n tk
r> Y nX dS )z�Removes a Node Device Event Callback. De-registering for a
node device callback will disable delivery of this event typer z/virConnectNodeDeviceEventDeregisterAny() failedNrL )r Z&virConnectNodeDeviceEventDeregisterAnyrc r �nodeDeviceEventCallbackIDr� )r r# r9 r r r � nodeDeviceEventDeregisterAny� s z'virConnect.nodeDeviceEventDeregisterAny)r r) rI r@ r c C sj t | d�si | _|| |d�}|dkr8tj| jd||�}ntj| j|j||�}|dkr\td��|| j|< |S )zwAdds a Node Device Event Callback. Registering for a node device
callback will enable delivery of the eventsr5 )rI rd r@ Nr z-virConnectNodeDeviceEventRegisterAny() failedrL )r* r5 r Z$virConnectNodeDeviceEventRegisterAnyrc r )r r r) rI r@ rH r9 r r r �nodeDeviceEventRegisterAny� s
z%virConnect.nodeDeviceEventRegisterAnyr� )�secretr? r� rH r c C s, |d }|d }|| t | |d�|||� dS )zJDispatches events to python user secret lifecycle event callbacks
rI r@ )r8 r )r� )r r8 r? r� rH rI r@ r r r �%_dispatchSecretEventLifecycleCallback� s z0virConnect._dispatchSecretEventLifecycleCallback)r8 rH r c C s( |d }|d }|| t | |d�|� dS )zHDispatches events to python user secret generic event callbacks
rI r@ )r8 r )r� )r r8 rH rI r@ r r r �#_dispatchSecretEventGenericCallback� s z.virConnect._dispatchSecretEventGenericCallbackc C sD y*t j| j|�}|dkr td��| j|= W n tk
r> Y nX dS )zyRemoves a Secret Event Callback. De-registering for a
secret callback will disable delivery of this event typer z+virConnectSecretEventDeregisterAny() failedNrL )r Z"virConnectSecretEventDeregisterAnyrc r �secretEventCallbackIDr� )r r# r9 r r r �secretEventDeregisterAny� s z#virConnect.secretEventDeregisterAny)r8 r) rI r@ r c C sj t | d�si | _|| |d�}|dkr8tj| jd||�}ntj| j|j||�}|dkr\td��|| j|< |S )zmAdds a Secret Event Callback. Registering for a secret
callback will enable delivery of the eventsr; )rI rd r@ Nr z)virConnectSecretEventRegisterAny() failedrL )r* r; r Z virConnectSecretEventRegisterAnyrc r )r r8 r) rI r@ rH r9 r r r �secretEventRegisterAny� s
z!virConnect.secretEventRegisterAny)r7 r c s0 t j� j|�}|dkr td��� fdd�|D �S )z5List all domains and returns a list of domain objectsNz!virConnectListAllDomains() failedc s g | ]}t � |d ��qS ))r8 )r )r0 rI )r r r r2 � s z-virConnect.listAllDomains.<locals>.<listcomp>)r ZvirConnectListAllDomainsrc r )r r7 r9 r )r r �listAllDomains� s zvirConnect.listAllDomainsc s0 t j� j|�}|dkr td��� fdd�|D �S )z&Returns a list of storage pool objectsNz&virConnectListAllStoragePools() failedc s g | ]}t � |d ��qS ))r8 )rS )r0 Zpoolptr)r r r r2 � s z2virConnect.listAllStoragePools.<locals>.<listcomp>)r Z virConnectListAllStoragePoolsrc r )r r7 r9 r )r r �listAllStoragePools� s z virConnect.listAllStoragePoolsc s0 t j� j|�}|dkr td��� fdd�|D �S )z!Returns a list of network objectsNz"virConnectListAllNetworks() failedc s g | ]}t � |d ��qS ))r8 )r> )r0 Znetptr)r r r r2 � s z.virConnect.listAllNetworks.<locals>.<listcomp>)r ZvirConnectListAllNetworksrc r )r r7 r9 r )r r �listAllNetworks� s zvirConnect.listAllNetworksrQ c s0 t j� j|�}|dkr td��� fdd�|D �S )z#Returns a list of interface objectsNz$virConnectListAllInterfaces() failedc s g | ]}t � |d ��qS ))r8 )rQ )r0 Zifaceptr)r r r r2 � s z0virConnect.listAllInterfaces.<locals>.<listcomp>)r ZvirConnectListAllInterfacesrc r )r r7 r9 r )r r �listAllInterfaces� s z virConnect.listAllInterfacesc s0 t j� j|�}|dkr td��� fdd�|D �S )z*Returns a list of host node device objectsNz%virConnectListAllNodeDevices() failedc s g | ]}t � |d ��qS ))r8 )r� )r0 Zdevptr)r r r r2 � s z-virConnect.listAllDevices.<locals>.<listcomp>)r Z virConnectListAllNodeDevicesrc r )r r7 r9 r )r r �listAllDevices� s zvirConnect.listAllDevicesr� c s0 t j� j|�}|dkr td��� fdd�|D �S )z(Returns a list of network filter objectsNz#virConnectListAllNWFilters() failedc s g | ]}t � |d ��qS ))r8 )r� )r0 �
filter_ptr)r r r r2 s z/virConnect.listAllNWFilters.<locals>.<listcomp>)r ZvirConnectListAllNWFiltersrc r )r r7 r9 r )r r �listAllNWFilters s zvirConnect.listAllNWFiltersr� c s0 t j� j|�}|dkr td��� fdd�|D �S )z0Returns a list of network filter binding objectsNz*virConnectListAllNWFilterBindings() failedc s g | ]}t � |d ��qS ))r8 )r� )r0 rC )r r r r2 s z6virConnect.listAllNWFilterBindings.<locals>.<listcomp>)r Z!virConnectListAllNWFilterBindingsrc r )r r7 r9 r )r r �listAllNWFilterBindings s z"virConnect.listAllNWFilterBindingsc s0 t j� j|�}|dkr td��� fdd�|D �S )z Returns a list of secret objectsNz!virConnectListAllSecrets() failedc s g | ]}t � |d ��qS ))r8 )r� )r0 Z
secret_ptr)r r r r2 s z-virConnect.listAllSecrets.<locals>.<listcomp>)r ZvirConnectListAllSecretsrc r )r r7 r9 r )r r �listAllSecrets s zvirConnect.listAllSecrets)r rH r c C s |d }|d }|| ||� dS )z/Dispatches events to python user close callbackrI r@ r r )r r rH rI r@ r r r �_dispatchCloseCallback s z!virConnect._dispatchCloseCallbackc C s t j| j�}|dkr td��dS )z Removes a close event callbackr z*virConnectUnregisterCloseCallback() failedNrL )r Z!virConnectUnregisterCloseCallbackrc r )r r9 r r r �unregisterCloseCallback s z"virConnect.unregisterCloseCallbackc C s. || |d�}t j| j|�}|dkr*td��|S )z_Adds a close event callback, providing a notification
when a connection fails / closes)rI rd r@ r z(virConnectRegisterCloseCallback() failedrL )r Z virConnectRegisterCloseCallbackrc r )r rI r@ rH r9 r r r �registerCloseCallback& s
z virConnect.registerCloseCallback)r� r6 r7 r c C s2 t j| j|||�}|dkr"td��t| |d�}|S )a4 Launch a new guest domain, based on an XML description similar
to the one returned by virDomainGetXMLDesc()
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 virDomainDefineXML() to
define persistent domains).
@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.
If the VIR_DOMAIN_START_PAUSED flag is set, the guest domain
will be started, but its CPUs will remain paused. The CPUs
can later be manually started using virDomainResume.
If the VIR_DOMAIN_START_AUTODESTROY flag is set, the guest
domain will be automatically destroyed when the virConnectPtr
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. Nz$virDomainCreateXMLWithFiles() failed)r8 )r ZvirDomainCreateXMLWithFilesrc r r )r r� r6 r7 r9 ry r r r �createXMLWithFiles/ s
z virConnect.createXMLWithFiles)�statsr7 r c s2 t j� j||�}|dkr td��� fdd�|D �S )a� Query statistics for all domains on a given connection.
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.
The statistic groups are enabled using the @stats parameter which is a
binary-OR of enum virDomainStatsTypes. The following groups are available
(although not necessarily implemented for each hypervisor):
VIR_DOMAIN_STATS_STATE: 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 virDomainState enum
"state.reason" - reason for entering given state, returned as int from
virDomain*Reason enum corresponding to given state.
Using 0 for @stats returns all stats groups supported by the given
hypervisor.
Specifying VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS as @flags makes
the function return error in case some of the stat types in @stats were
not recognized by the daemon.
Similarly to virConnectListAllDomains, @flags can contain various flags to
filter the list of domains to provide stats for.
VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE selects online domains while
VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE selects offline ones.
VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT and
VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT allow to filter the list
according to their persistence.
To filter the list of VMs by domain state @flags can contain
VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING,
VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED,
VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF and/or
VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER for all other states. Nz$virConnectGetAllDomainStats() failedc s$ g | ] }t � |d d�|d f�qS )r )r8 r )r )r0 �elem)r r r r2 | s z0virConnect.getAllDomainStats.<locals>.<listcomp>)r ZvirConnectGetAllDomainStatsrc r )r rK r7 r9 r )r r �getAllDomainStatsN s *z virConnect.getAllDomainStats)�domsrK r7 r c sf t � }x*|D ]"}t|t�s"td��|j|j� q W tj� j|||�}|dkrTtd��� fdd�|D �S )a" Query statistics for given domains.
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.
The statistic groups are enabled using the @stats parameter which is a
binary-OR of enum virDomainStatsTypes. The following groups are available
(although not necessarily implemented for each hypervisor):
VIR_DOMAIN_STATS_STATE: 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 virDomainState enum
"state.reason" - reason for entering given state, returned as int from
virDomain*Reason enum corresponding to given state.
Using 0 for @stats returns all stats groups supported by the given
hypervisor.
Specifying VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS as @flags makes
the function return error in case some of the stat types in @stats were
not recognized by the daemon.
Get statistics about domains provided as a list in @doms. @stats is
a bit field selecting requested statistics types.z(domain list contains non-domain elementsNz virDomainListGetStats() failedc s$ g | ] }t � |d d�|d f�qS )r )r8 r )r )r0 rL )r r r r2 � s z1virConnect.domainListGetStats.<locals>.<listcomp>)�list�
isinstancer r �appendrc r ZvirDomainListGetStats)r rN rK r7 Zdomlistr� r9 r )r r �domainListGetStats~ s
z virConnect.domainListGetStats)N)r r r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )NNNNr )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )Nr )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r )r r )r r )�r- r. r/ r rg rj rl rq rr rs rt rv rw rx rz rW r{ r| r~ r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r< r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r� r� r� r� r� r� r� r� r� r� re r� r r
�
BaseExceptionr r� � _DomainCBr� r
r� r1 r� r r0 r r� r� r� r� r� r r r r r
r r r r r r r r r r r r r r! r" r% r& r( r r+ r, r. r/ r1 r2 r3 r4 r6 r7 r9 r: r< r= r r> r? r@ rA rB rD rE rF rG rH rI rJ r rM rR r r r r r � s\
$
& (
*
& ( $ " " " " " " $
" " * " $ ( & $ & " &
"
"&
"
"& " " " 00c @ s� e Zd Zd+dd�Zdd� Zdd� Zdd � Zd,d d �Zd
d� Zd-dd�Z dd� Z
d.dd�Z dd� Z dd� Z
dd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd/d)d*�ZdS )0r� Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r � s zvirNodeDevice.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirNodeDeviceFree)r r r r re � s
zvirNodeDevice.__del__c C s | j S )N)ra )r r r r rf � s zvirNodeDevice.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirNodeDevice_pointerrc )r r r r rg � s zvirNodeDevice.c_pointerr c C s" t j| j|�}|dkr td��|S )zDFetch an XML document describing all aspects of
the device. Nz virNodeDeviceGetXMLDesc() failed)r ZvirNodeDeviceGetXMLDescrc r )r r7 r9 r r r rl � s zvirNodeDevice.XMLDescc C s t j| j�}|dkr td��|S )z.Extract the autostart flag for a node device. r z"virNodeDeviceGetAutostart() failedrL )r ZvirNodeDeviceGetAutostartrc r )r r9 r r r rx � s zvirNodeDevice.autostartc C s" t j| j|�}|dkr td��|S )z Start a defined node device: r z virNodeDeviceCreate() failedrL )r ZvirNodeDeviceCreaterc r )r r7 r9 r r r r� � s zvirNodeDevice.createc C s t j| j�}|dkr td��|S )z�Destroy the device object. The virtual device (only works for vHBA
currently) is removed from the host operating system. This function
may require privileged access. r z virNodeDeviceDestroy() failedrL )r ZvirNodeDeviceDestroyrc r )r r9 r r r r� � s zvirNodeDevice.destroyc C s$ t j| j||�}|dkr td��|S )aN Detach the node device from the node itself so that it may be
assigned to a guest domain.
Depending on the hypervisor, this may involve operations such as
unbinding any device drivers from the device, binding the device to
a dummy device driver and resetting the device. Different backend
drivers expect the device to be bound to different dummy
devices. For example, QEMU's "kvm" backend driver (the default)
expects the device to be bound to "pci-stub", but its "vfio"
backend driver expects the device to be bound to "vfio-pci".
If the device is currently in use by the node, this method may
fail.
Once the device is not assigned to any guest, it may be re-attached
to the node using the virNodeDeviceReAttach() method. r z!virNodeDeviceDetachFlags() failedrL )r ZvirNodeDeviceDetachFlagsrc r )r Z
driverNamer7 r9 r r r � detachFlags� s zvirNodeDevice.detachFlagsc C s t j| j�}|dkr td��|S )a0 Detach the node device from the node itself so that it may be
assigned to a guest domain.
Depending on the hypervisor, this may involve operations such
as unbinding any device drivers from the device, binding the
device to a dummy device driver and resetting the device.
If the device is currently in use by the node, this method may
fail.
Once the device is not assigned to any guest, it may be re-attached
to the node using the virNodeDeviceReattach() method.
If the caller needs control over which backend driver will be used
during PCI device assignment (to use something other than the
default, for example VFIO), the newer virNodeDeviceDetachFlags()
API should be used instead. r z virNodeDeviceDettach() failedrL )r ZvirNodeDeviceDettachrc r )r r9 r r r �dettach� s zvirNodeDevice.dettachc C s t j| j�}|dkr td��|S )z1Determine if the node device is currently active r z virNodeDeviceIsActive() failedrL )r ZvirNodeDeviceIsActiverc r )r r9 r r r r� s zvirNodeDevice.isActivec C s t j| j�}|dkr td��|S )zxDetermine if the node device has a persistent configuration
which means it will still exist after shutting down r z"virNodeDeviceIsPersistent() failedrL )r ZvirNodeDeviceIsPersistentrc r )r r9 r r r r� s zvirNodeDevice.isPersistentc C s t j| j�}|dkr td��|S )z$list the node device's capabilities Nz virNodeDeviceListCaps() failed)r ZvirNodeDeviceListCapsrc r )r r9 r r r �listCaps& s zvirNodeDevice.listCapsc C s t j| j�}|S )z Just return the device name )r ZvirNodeDeviceGetNamerc )r r9 r r r r; 1 s zvirNodeDevice.namec C s t j| j�}|dkr td��|S )zAAccessor for the number of capabilities supported by the device. r z virNodeDeviceNumOfCaps() failedrL )r ZvirNodeDeviceNumOfCapsrc r )r r9 r r r � numOfCaps6 s zvirNodeDevice.numOfCapsc C s t j| j�}|S )z&Accessor for the parent of the device )r ZvirNodeDeviceGetParentrc )r r9 r r r �parent= s zvirNodeDevice.parentc C s t j| j�}|dkr td��|S )a� Re-attach a previously detached node device to the node so that it
may be used by the node again.
Depending on the hypervisor, this may involve operations such
as resetting the device, unbinding it from a dummy device driver
and binding it to its appropriate driver.
If the device is currently in use by a guest, this method may fail. r z virNodeDeviceReAttach() failedrL )r ZvirNodeDeviceReAttachrc r )r r9 r r r �reAttachB s zvirNodeDevice.reAttachc C s t j| j�}|dkr td��|S )a� Reset a previously detached node device to the node before or
after assigning it to a guest.
The exact reset semantics depends on the hypervisor and device
type but, for example, KVM will attempt to reset PCI devices with
a Function Level Reset, Secondary Bus Reset or a Power Management
D-State reset.
If the reset will affect other devices which are currently in use,
this function may fail. r zvirNodeDeviceReset() failedrL )r ZvirNodeDeviceResetrc r )r r9 r r r r� P s zvirNodeDevice.resetc C s" t j| j|�}|dkr td��|S )z�Configure the node device to be automatically started when the host machine
boots or the parent device becomes available. r z"virNodeDeviceSetAutostart() failedrL )r ZvirNodeDeviceSetAutostartrc r )r rx r9 r r r r ` s zvirNodeDevice.setAutostartc C s" t j| j|�}|dkr td��|S )z�Undefine the device object. The virtual device is removed from the host
operating system. This function may require privileged access. r z virNodeDeviceUndefine() failedrL )r ZvirNodeDeviceUndefinerc r )r r7 r9 r r r r* h s zvirNodeDevice.undefine)N)r )r )r )r )r- r. r/ r re rf rg rl rx r� r� rU rV r� r� rW r; rX rY rZ r� r r* r r r r r� � s(
r� c @ st e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zd dd�Z d dd�Z
dd� Z dd� Z dd� Z
d dd�ZdS ) r� Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r q s zvirSecret.__init__c C s | j d k rtj| j � d | _ d S )N)rc r Z
virSecretFree)r r r r re w s
zvirSecret.__del__c C s | j S )N)ra )r r r r rf | s zvirSecret.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirSecret_pointerrc )r r r r rg s zvirSecret.c_pointerc C s t j| j�}|dkr td��|S )z0Extract the UUID unique Identifier of a secret. NzvirSecretGetUUID() failed)r ZvirSecretGetUUIDrc r )r r9 r r r rj � s zvirSecret.UUIDc C s t j| j�}|dkr td��|S )z4Fetch globally unique ID of the secret as a string. Nz virSecretGetUUIDString() failed)r ZvirSecretGetUUIDStringrc r )r r9 r r r rk � s zvirSecret.UUIDStringr c C s" t j| j|�}|dkr td��|S )z=Fetches an XML document describing attributes of the secret. Nz virSecretGetXMLDesc() failed)r ZvirSecretGetXMLDescrc r )r r7 r9 r r r rl � s zvirSecret.XMLDescc C s$ t j| j||�}|dkr td��|S )z"Associates a value with a secret. r zvirSecretSetValue() failedrL )r ZvirSecretSetValuerc r )r �valuer7 r9 r r r �setValue� s zvirSecret.setValuec C s t j| j�}|dkr td��|S )z^Deletes the specified secret. This does not free the associated
virSecretPtr object. r zvirSecretUndefine() failedrL )r ZvirSecretUndefinerc r )r r9 r r r r* � s zvirSecret.undefinec C s t j| j�}|S )a� Get the unique identifier of the object with which this
secret is to be used. The format of the identifier is
dependent on the usage type of the secret. For a secret
with a usage type of VIR_SECRET_USAGE_TYPE_VOLUME the
identifier will be a fully qualified path name. The
identifiers are intended to be unique within the set of
all secrets sharing the same usage type. ie, there shall
only ever be one secret for each volume path. )r ZvirSecretGetUsageIDrc )r r9 r r r r� � s zvirSecret.usageIDc C s t j| j�}|S )a4 Get the type of object which uses this secret. The returned
value is one of the constants defined in the virSecretUsageType
enumeration. More values may be added to this enumeration in
the future, so callers should expect to see usage types they
do not explicitly know about. )r ZvirSecretGetUsageTyperc )r r9 r r r r� � s zvirSecret.usageTypec C s" t j| j|�}|dkr td��|S )z,Fetches the value associated with a secret. NzvirSecretGetValue() failed)r ZvirSecretGetValuerc r )r r7 r9 r r r r[ � s zvirSecret.value)N)r )r )r )r- r. r/ r re rf rg rj rk rl r\ r* r� r� r[ r r r r r� p s
r� c @ sX e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zddd�Z dd� Z
dd� Z dS )r� Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r � s zvirNWFilter.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirNWFilterFree)r r r r re � s
zvirNWFilter.__del__c C s | j S )N)ra )r r r r rf � s zvirNWFilter.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirNWFilter_pointerrc )r r r r rg � s zvirNWFilter.c_pointerc C s t j| j�}|dkr td��|S )z8Extract the UUID unique Identifier of a network filter. NzvirNWFilterGetUUID() failed)r ZvirNWFilterGetUUIDrc r )r r9 r r r rj � s zvirNWFilter.UUIDc C s t j| j�}|dkr td��|S )z<Fetch globally unique ID of the network filter as a string. Nz!virNWFilterGetUUIDString() failed)r ZvirNWFilterGetUUIDStringrc r )r r9 r r r rk � s zvirNWFilter.UUIDStringr c C s" t j| j|�}|dkr td��|S )z�Provide an XML description of the network filter. The description may be
reused later to redefine the network filter with virNWFilterCreateXML(). Nz virNWFilterGetXMLDesc() failed)r ZvirNWFilterGetXMLDescrc r )r r7 r9 r r r rl s zvirNWFilter.XMLDescc C s t j| j�}|S )z+Get the public name for the network filter )r ZvirNWFilterGetNamerc )r r9 r r r r; s zvirNWFilter.namec C s t j| j�}|dkr td��|S )z�Undefine the nwfilter object. This call will not succeed if
a running VM is referencing the filter. This does not free the
associated virNWFilterPtr object. r z virNWFilterUndefine() failedrL )r ZvirNWFilterUndefinerc r )r r9 r r r r*
s zvirNWFilter.undefine)N)r ) r- r. r/ r re rf rg rj rk rl r; r* r r r r r� � s
r� c @ sP e Zd Zddd�Zdd� Zdd� Zdd � Zdd d �Zd
d� Zdd� Z dd� Z
dS )r� Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r s zvirNWFilterBinding.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirNWFilterBindingFree)r r r r re s
zvirNWFilterBinding.__del__c C s | j S )N)ra )r r r r rf " s zvirNWFilterBinding.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirNWFilterBinding_pointerrc )r r r r rg % s z virNWFilterBinding.c_pointerr c C s" t j| j|�}|dkr td��|S )z�Provide an XML description of the network filter. The description may be
reused later to redefine the network filter with virNWFilterCreateXML(). Nz%virNWFilterBindingGetXMLDesc() failed)r Z virNWFilterBindingGetXMLDescrc r )r r7 r9 r r r rl - s zvirNWFilterBinding.XMLDescc C s t j| j�}|dkr td��|S )a� Delete the binding object. This does not free the
associated virNWFilterBindingPtr object. This API
may be used to remove the network port binding filter
currently in use for the guest while the guest is
running without needing to restart the guest. Restoring
the network port binding filter for the running guest
would be accomplished by using virNWFilterBindingCreateXML. r z!virNWFilterBindingDelete() failedrL )r ZvirNWFilterBindingDeleterc r )r r9 r r r rN 5 s zvirNWFilterBinding.deletec C s t j| j�}|S )z3Get the filter name for the network filter binding )r Z virNWFilterBindingGetFilterNamerc )r r9 r r r �
filterNameB s z virNWFilterBinding.filterNamec C s t j| j�}|S )z5Get the port dev name for the network filter binding )r Z virNWFilterBindingGetPortDevrc )r r9 r r r �portDevG s zvirNWFilterBinding.portDev)N)r ) r- r. r/ r re rf rg rl rN r] r^ r r r r r� s
r� c @ s� e Zd Zd4dd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd�dd�Z
e e e
ef e d�dd�Ze ed e egdf edd�dd�Zed eege f edd�dd�Zed e egef edd�d d �Ze ed �d d �Zee d!�d"d#�Zd5e e d%�d&d'�Zd6e e e d(�d)d*�Zd7e e eee f d+�d,d-�Zed eegeee f f ed e ege e f edd.�d/d0�Z ed e egeee f f ed ege e e f f ed e ege f edd1�d2d3�Z dS )8r� Nc C s. || _ t|�jdkr$tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )ra rb r- r rc )r rd r8 r r r r M s zvirStream.__init__c C s | j S )N)ra )r r r r rf S s zvirStream.connectc C s t j| j�S )z"Get C pointer to underlying object)r ZvirStream_pointerrc )r r r r rg V s zvirStream.c_pointerc C s t j| j�}|dkr td��|S )a� Request that the in progress data transfer be cancelled
abnormally before the end of the stream has been reached.
For output streams this can be used to inform the driver
that the stream is being terminated early. For input
streams this can be used to inform the driver that it
should stop sending data.
If the stream is non-blocking, any callback must be removed
beforehand. r zvirStreamAbort() failedrL )r ZvirStreamAbortrc r )r r9 r r r �abort^ s
zvirStream.abortc C s t j| j�}|dkr td��|S )z)Remove an event callback from the stream r z%virStreamEventRemoveCallback() failedrL )r � virStreamEventRemoveCallbackrc r )r r9 r r r �eventRemoveCallbackm s z virStream.eventRemoveCallbackc C s" t j| j|�}|dkr td��|S )a Changes the set of events to monitor for a stream. This allows
for event notification to be changed without having to
unregister & register the callback completely. This method
is guaranteed to succeed if a callback is already registered r z%virStreamEventUpdateCallback() failedrL )r Z virStreamEventUpdateCallbackrc r )r rG r9 r r r �eventUpdateCallbackt s z virStream.eventUpdateCallbackc C s t j| j�}|dkr td��|S )a, Indicate that there is no further data to be transmitted
on the stream. For output streams this should be called once
all data has been written. For input streams this should be
called once virStreamRecv returns end-of-file.
This method is a synchronization point for all asynchronous
errors, so if this returns a success code the application can
be sure that all data has been successfully processed.
If the stream is non-blocking, any callback must be removed
beforehand. r zvirStreamFinish() failedrL )r ZvirStreamFinishrc r )r r9 r r r �finish~ s zvirStream.finish)r c C sL y| j rtj| j� W n tk
r* Y nX | jd k rBtj| j� d | _d S )N)rI r r` rc r� Z
virStreamFree)r r r r re � s
zvirStream.__del__)rG rH r c C s |d }|d }|| ||� dS )zK
Dispatches events to python user's stream event callbacks
rI r@ r r )r rG rH rI r@ r r r � _dispatchStreamEventCallback� s z&virStream._dispatchStreamEventCallback)rG rI r@ r c C s6 || _ | ||d�}tj| j||�}|dkr2td��d S )N)r� rI r@ r z"virStreamEventAddCallback() failedrL )rI r ZvirStreamEventAddCallbackrc r )r rG rI r@ rH r9 r r r �eventAddCallback� s
zvirStream.eventAddCallback)�handlerr@ r c C s� x�| j tj�}|dkr td��t|�dkr,P y.|| ||�}t|t�rX|dk rXtd| ��W q tk
r� y | j � W n t
k
r� Y nX � Y qX qW dS )a� Receive the entire data stream, sending the data to the
requested data sink. This is simply a convenient alternative
to virStreamRecv, for apps that do blocking-I/O.
A hypothetical handler function looks like:
def handler(stream, # virStream instance
buf, # string containing received data
opaque): # extra data passed to recvAll as opaque
fd = opaque
return os.write(fd, buf)
r z*cannot use recvAll with nonblocking streamr zrecvAll handler returned %dN���) �recvrU rg r r� rP r1 � RuntimeErrorrS r_ r )r rf r@ �gotr9 r r r �recvAll� s
zvirStream.recvAllc C sv xpy|| t j|�}W n8 tk
rL y | j� W n tk
rD Y nX � Y nX |sTP | j|�}|dkrtd��qW dS )a�
Send the entire data stream, reading the data from the
requested data source. This is simply a convenient alternative
to virStreamSend, for apps that do blocking-I/O.
A hypothetical handler function looks like:
def handler(stream, # virStream instance
nbytes, # int amt of data to read
opaque): # extra data passed to recvAll as opaque
fd = opaque
return os.read(fd, nbytes)
r z*cannot use sendAll with nonblocking streamNrg )rU rg rS r_ r �sendr )r rf r@ rj r9 r r r �sendAll� s
zvirStream.sendAll)�nbytesr c C s" t j| j|�}|dkr td��|S )a� Reads a series of bytes from the stream. This method may
block the calling application for an arbitrary amount
of time.
Errors are not guaranteed to be reported synchronously
with the call, but may instead be delayed until a
subsequent call.
On success, the received data is returned. On failure, an
exception is raised. If the stream is a NONBLOCK stream and
the request would block, integer -2 is returned.
NzvirStreamRecv() failed)r Z
virStreamRecvrc r )r rn r9 r r r rh � s
zvirStream.recv)�datar c C s" t j| j|�}|dkr td��|S )a Write a series of bytes to the stream. This method may
block the calling application for an arbitrary amount
of time. Once an application has finished sending data
it should call virStreamFinish to wait for successful
confirmation from the driver, or detect any error
This method may not be used if a stream source has been
registered
Errors are not guaranteed to be reported synchronously
with the call, but may instead be delayed until a
subsequent call.
r zvirStreamSend() failedrL )r Z
virStreamSendrc r )r ro r9 r r r rl s zvirStream.sendr )r7 r c C s" t j| j|�}|dkr td��|S )z�This method is used to determine the length in bytes
of the empty space to be created in a stream's target
file when uploading or downloading sparsely populated
files. This is the counterpart to sendHole.
NzvirStreamRecvHole() failed)r ZvirStreamRecvHolerc r )r r7 r9 r r r �recvHole s zvirStream.recvHole)r^ r7 r c C s$ t j| j||�}|dkr td��|S )a" Rather than transmitting empty file space, this method
directs the stream target to create length bytes of empty
space. This method would be used when uploading or
downloading sparsely populated files to avoid the
needless copy of empty file space.
r zvirStreamSendHole() failedrL )r ZvirStreamSendHolerc r )r r^ r7 r9 r r r �sendHole s zvirStream.sendHole)rn r7 r c C s$ t j| j||�}|dkr td��|S )a Reads a series of bytes from the stream. This method may
block the calling application for an arbitrary amount
of time. This is just like recv except it has flags
argument.
Errors are not guaranteed to be reported synchronously
with the call, but may instead be delayed until a
subsequent call.
On success, the received data is returned. On failure, an
exception is raised. If the stream is a NONBLOCK stream and
the request would block, integer -2 is returned.
NzvirStreamRecvFlags() failed)r ZvirStreamRecvFlagsrc r )r rn r7 r9 r r r � recvFlags* s zvirStream.recvFlags)rf � holeHandlerr@ r c C s� x�t j}| j|t�}|d kr&td��n�|d
kr�| j� }|dkrN| j� td��|| ||�}t|t �r|dk r| j� td| ��qn*t|t �r�t
|��nt|t �s�t t
|���t|�dkr�P || ||�}t|t �r|dk r| j� td| ��qW dS ) a1 Receive the entire data stream, sending the data to
the requested data sink handler and calling the skip
holeHandler to generate holes for sparse stream targets.
This is simply a convenient alternative to recvFlags, for
apps that do blocking-I/O and want to preserve sparseness.
Hypothetical callbacks can look like this:
def handler(stream, # virStream instance
buf, # string containing received data
opaque): # extra data passed to sparseRecvAll as opaque
fd = opaque
return os.write(fd, buf)
def holeHandler(stream, # virStream instance
length, # number of bytes to skip
opaque): # extra data passed to sparseRecvAll as opaque
fd = opaque
cur = os.lseek(fd, length, os.SEEK_CUR)
return os.ftruncate(fd, cur) # take this extra step to
# actually allocate the hole
r z0cannot use sparseRecvAll with nonblocking streamr! NzrecvHole handler failedr z holeHandler handler returned %dz!sparseRecvAll handler returned %drg ���)rU rg rr � VIR_STREAM_RECV_STOP_AT_HOLEr rp r_ ri rP r1 �
ValueError�bytes� TypeErrorrb r� ) r rf rs r@ �wantrj r^ Zret_holeZret_datar r r �
sparseRecvAll= s2
zvirStream.sparseRecvAll)rf rs � skipHandlerr@ r c
C s� x�|| |�\}}| rF|dkrF| j |�dk s<|| ||�dk r| j� qtj}||krX|}|| ||�}t|t�r�|dk r�| j� td| ��|s�P | j|�} | dkrtd��qW dS )a Send the entire data stream, reading the data from the
requested data source. This is simply a convenient
alternative to virStreamSend, for apps that do
blocking-I/O and want to preserve sparseness.
Hypothetical callbacks can look like this:
def handler(stream, # virStream instance
nbytes, # int amt of data to read
opaque): # extra data passed to sparseSendAll as opaque
fd = opaque
return os.read(fd, nbytes)
def holeHandler(stream, # virStream instance
opaque): # extra data passed to sparseSendAll as opaque
fd = opaque
cur = os.lseek(fd, 0, os.SEEK_CUR)
# ... find out current section and its boundaries
# and set inData = True/False and sectionLen correspondingly
os.lseek(fd, cur, os.SEEK_SET)
return [inData, sectionLen]
def skipHandler(stream, # virStream instance
length, # number of bytes to skip
opaque): # extra data passed to sparseSendAll as opaque
fd = opaque
return os.lseek(fd, length, os.SEEK_CUR)
r z!sparseSendAll handler returned %dr z0cannot use sparseSendAll with nonblocking streamNrg ) rq r_ rU rg rP r1 ri rl r )
r rf rs r{ r@ ZinDataZ
sectionLenry rj r9 r r r �
sparseSendAllq s&
zvirStream.sparseSendAll)N)r )r )r )!r- r. r/ r rf rg r_ ra rb rc re r1 r r0 r rd r r
re rw rk rm rh rl rp rq r rr r rz r �boolr| r r r r r� L s&
" <4r� c @ s� e Zd Zd dd�Zdd� Zdd� Zdd � Zd
d � Zd d
d�Zdd� Z d!dd�Z
d"dd�Z dd�dd�Z dd�dd�Z
d#eed d �d d �ZdS )$r� Nc C s8 || _ |j� | _t|�jdkr.tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )�_domrf ra rb r- r rc )r r� r8 r r r r � s
z virDomainCheckpoint.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirDomainCheckpointFree)r r r r re � s
zvirDomainCheckpoint.__del__c C s | j S )N)ra )r r r r rf � s zvirDomainCheckpoint.connectc C s | j S )N)r~ )r r r r �domain� s zvirDomainCheckpoint.domainc C s t j| j�S )z"Get C pointer to underlying object)r ZvirDomainCheckpoint_pointerrc )r r r r rg � s z virDomainCheckpoint.c_pointerr c C s" t j| j|�}|dkr td��|S )a� Removes a checkpoint from the domain.
When removing a checkpoint, the record of which portions of the
disk were dirtied after the checkpoint will be merged into the
record tracked by the parent checkpoint, if any.
If @flags includes VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN, then any
descendant checkpoints are also deleted. If @flags includes
VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN_ONLY, then any descendant
checkepoints are deleted, but this checkpoint remains. These two
flags are mutually exclusive.
If @flags includes VIR_DOMAIN_CHECKPOINT_DELETE_METADATA_ONLY, then
any checkpoint metadata tracked by libvirt is removed while keeping
the checkpoint contents intact; if a hypervisor does not require
any libvirt metadata to track checkpoints, then this flag is
silently ignored. r z"virDomainCheckpointDelete() failedrL )r ZvirDomainCheckpointDeleterc r )r r7 r9 r r r rN � s zvirDomainCheckpoint.deletec C s t j| j�}|dkr td��|S )z(Get the public name for that checkpoint Nz#virDomainCheckpointGetName() failed)r ZvirDomainCheckpointGetNamerc r )r r9 r r r �getName� s zvirDomainCheckpoint.getNamec C s0 t j| j|�}|dkr td��t| j|d�}|S )z�Get the parent checkpoint for @checkpoint, if any.
virDomainCheckpointFree should be used to free the resources after the
checkpoint object is no longer needed. Nz%virDomainCheckpointGetParent() failed)r8 )r Z virDomainCheckpointGetParentrc r r� r~ )r r7 r9 Z_virDomainCheckpoint__tmpr r r � getParent� s
z virDomainCheckpoint.getParentc C s" t j| j|�}|dkr td��|S )a� Provide an XML description of the domain checkpoint.
No security-sensitive data will be included unless @flags contains
VIR_DOMAIN_CHECKPOINT_XML_SECURE; this flag is rejected on read-only
connections.
Normally, the XML description includes an element giving a full
description of the domain at the time the checkpoint was created; to
reduce parsing time, it will be suppressed when @flags contains
VIR_DOMAIN_CHECKPOINT_XML_NO_DOMAIN.
By default, the XML description contains only static information that
does not change over time. However, when @flags contains
VIR_DOMAIN_CHECKPOINT_XML_SIZE, each <disk> listing adds an additional
attribute that shows an estimate of the current size in bytes that
have been dirtied between the time the checkpoint was created and the
current point in time. Note that updating the size may be expensive and
data will be inaccurate once guest OS writes to the disk. Also note that
hypervisors may require that the domain associated with @checkpoint is
running when VIR_DOMAIN_CHECKPOINT_XML_SIZE is used. Nz&virDomainCheckpointGetXMLDesc() failed)r Z virDomainCheckpointGetXMLDescrc r )r r7 r9 r r r �
getXMLDesc� s z virDomainCheckpoint.getXMLDescr )r c C s | j � S )zIGet the connection that owns the domain that a checkpoint was created for)rf )r r r r �
getConnect
s z virDomainCheckpoint.getConnectr c C s | j � S )z0Get the domain that a checkpoint was created for)r )r r r r � getDomain s z virDomainCheckpoint.getDomain)r7 r c s0 t j� j|�}|dkr td��� fdd�|D �S )zCList all child checkpoints and returns a list of checkpoint objectsNz+virDomainCheckpointListAllChildren() failedc s g | ]}t � j� |d ��qS ))r8 )r� r )r0 r4 )r r r r2 s z7virDomainCheckpoint.listAllChildren.<locals>.<listcomp>)r Z"virDomainCheckpointListAllChildrenrc r )r r7 r9 r )r r �listAllChildren s z#virDomainCheckpoint.listAllChildren)N)r )r )r )r )r- r. r/ r re rf r rg rN r� r� r� r� r� r1 r r� r r r r r� � s
r� c @ s� e Zd Zd'dd�Zdd� Zdd� Zdd � Zd
d � Zd(d
d�Zdd� Z d)dd�Z
d*dd�Z d+dd�Z d,dd�Z
d-dd�Zd.dd �Zd d �d d �Zd!d �d"d#�Zd/eed d$�d%d&�ZdS )0r" Nc C s8 || _ |j� | _t|�jdkr.tdt|� ��|| _d S )Nr_ r` z&Expected a wrapped C Object but got %s)r_ r` )r~ rf ra rb r- r rc )r r� r8 r r r r s
zvirDomainSnapshot.__init__c C s | j d k rtj| j � d | _ d S )N)rc r ZvirDomainSnapshotFree)r r r r re " s
zvirDomainSnapshot.__del__c C s | j S )N)ra )r r r r rf ' s zvirDomainSnapshot.connectc C s | j S )N)r~ )r r r r r * s zvirDomainSnapshot.domainc C s t j| j�S )z"Get C pointer to underlying object)r ZvirDomainSnapshot_pointerrc )r r r r rg - s zvirDomainSnapshot.c_pointerr c C s" t j| j|�}|dkr td��|S )a? Delete the snapshot.
If @flags is 0, then just this snapshot is deleted, and changes
from this snapshot are automatically merged into children
snapshots. If @flags includes VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN,
then this snapshot and any descendant snapshots are deleted. If
@flags includes VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLY, then any
descendant snapshots are deleted, but this snapshot remains. These
two flags are mutually exclusive.
If @flags includes VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY, then
any snapshot metadata tracked by libvirt is removed while keeping
the snapshot contents intact; if a hypervisor does not require any
libvirt metadata to track snapshots, then this flag is silently
ignored. r z virDomainSnapshotDelete() failedrL )r ZvirDomainSnapshotDeleterc r )r r7 r9 r r r rN 5 s zvirDomainSnapshot.deletec C s t j| j�}|dkr td��|S )z&Get the public name for that snapshot Nz!virDomainSnapshotGetName() failed)r ZvirDomainSnapshotGetNamerc r )r r9 r r r r� J s zvirDomainSnapshot.getNamec C s0 t j| j|�}|dkr td��t| j|d�}|S )z�Get the parent snapshot for @snapshot, if any.
virDomainSnapshotFree should be used to free the resources after the
snapshot object is no longer needed. Nz#virDomainSnapshotGetParent() failed)r8 )r ZvirDomainSnapshotGetParentrc r r" r~ )r r7 r9 Z_virDomainSnapshot__tmpr r r r� Q s
zvirDomainSnapshot.getParentc C s" t j| j|�}|dkr td��|S )a Provide an XML description of the domain snapshot, with a top-level
element of <domainsnapshot>.
No security-sensitive data will be included unless @flags contains
VIR_DOMAIN_SNAPSHOT_XML_SECURE; this flag is rejected on read-only
connections. Nz$virDomainSnapshotGetXMLDesc() failed)r ZvirDomainSnapshotGetXMLDescrc r )r r7 r9 r r r r� \ s z virDomainSnapshot.getXMLDescc C s" t j| j|�}|dkr td��|S )z{Determine if the given snapshot is associated with libvirt metadata
that would prevent the deletion of the domain. r z%virDomainSnapshotHasMetadata() failedrL )r Z virDomainSnapshotHasMetadatarc r )r r7 r9 r r r � hasMetadatah s z virDomainSnapshot.hasMetadatac C s" t j| j|�}|dkr td��|S )zsDetermine if the given snapshot is the domain's current snapshot. See
also virDomainHasCurrentSnapshot(). r z#virDomainSnapshotIsCurrent() failedrL )r ZvirDomainSnapshotIsCurrentrc r )r r7 r9 r r r � isCurrentp s zvirDomainSnapshot.isCurrentc C s" t j| j|�}|dkr td��|S )z@collect the list of child snapshot names for the given snapshot Nz+virDomainSnapshotListChildrenNames() failed)r Z"virDomainSnapshotListChildrenNamesrc r )r r7 r9 r r r �listChildrenNames| s z#virDomainSnapshot.listChildrenNamesc C s" t j| j|�}|dkr td��|S )ac Provides the number of child snapshots for this domain snapshot.
This function will accept VIR_DOMAIN_SNAPSHOT_LIST_TOPOLOGICAL in
@flags only if virDomainSnapshotListChildrenNames() can honor it,
although the flag has no other effect here.
By default, this command covers only direct children. It is also
possible to expand things to cover all descendants, when @flags
includes VIR_DOMAIN_SNAPSHOT_LIST_DESCENDANTS. Additional filters
are provided via the same @flags values as documented in
virDomainSnapshotListAllChildren(). r z%virDomainSnapshotNumChildren() failedrL )r Z virDomainSnapshotNumChildrenrc r )r r7 r9 r r r � numChildren� s z virDomainSnapshot.numChildrenr )r c C s | j � S )zGGet the connection that owns the domain that a snapshot was created for)rf )r r r r r� � s z virDomainSnapshot.getConnectr c C s | j � S )z.Get the domain that a snapshot was created for)r )r r r r r� � s zvirDomainSnapshot.getDomain)r7 r c s0 t j� j|�}|dkr td��� fdd�|D �S )z?List all child snapshots and returns a list of snapshot objectsNz)virDomainSnapshotListAllChildren() failedc s g | ]}t � j� |d ��qS ))r8 )r" r )r0 r1 )r r r r2 � s z5virDomainSnapshot.listAllChildren.<locals>.<listcomp>)r Z virDomainSnapshotListAllChildrenrc r )r r7 r9 r )r r r� � s z!virDomainSnapshot.listAllChildren)N)r )r )r )r )r )r )r )r )r- r. r/ r re rf r rg rN r� r� r� r� r� r� r� r� r� r1 r r� r r r r r" s
r" r r r! r# r% r' r) r+ � � � �@ � i i @l � i i i i i i @ i � i i i i i i �
� � �
� � � � � � � � � � � � � � � � � �! �" �# �$ �% �& �' �( �) �* �+ �, �- �. �/ �0 �1 �2 �3 �4 �5 �6 �7 �8 �9 �: �; �< �= �> �? �A �B �C �D �E �F �G �H �I �J �K �L �M �N �O �P �Q �R �S �T �U �V �W �X �Y �Z �[ �\ �] �^ �_ �` �a �b �c �d �e �f �g �h �i �j �k �l �m �n z
group-namez
process-idz process-timezsasl-user-namezselinux-contextz
unix-group-idz unix-user-idz user-namezx509-distinguished-namezinbound.averagez
inbound.burstz
inbound.floorz inbound.peakzoutbound.averagezoutbound.burstz
outbound.peakZdevice_read_bytes_secZdevice_read_iops_secZ
device_weightZdevice_write_bytes_secZdevice_write_iops_secZweightr zbuf-sizeZ granularityZ
group_nameZread_bytes_secZread_bytes_sec_maxZread_bytes_sec_max_lengthZ
read_iops_secZread_iops_sec_maxZread_iops_sec_max_lengthZ
size_iops_secZtotal_bytes_secZtotal_bytes_sec_maxZtotal_bytes_sec_max_lengthZtotal_iops_secZtotal_iops_sec_maxZtotal_iops_sec_max_lengthZwrite_bytes_secZwrite_bytes_sec_maxZwrite_bytes_sec_max_lengthZwrite_iops_secZwrite_iops_sec_maxZwrite_iops_sec_max_lengthZerrsZflush_operationsZflush_total_timesZrd_bytesZ
rd_operationsZrd_total_timesZwr_bytesZ
wr_operationsZwr_total_timesZcpu_timeZ system_timeZ user_timeZ vcpu_timeZ poll_growZ poll_max_nsZ poll_shrinkZauto_converge_throttleZcompression_bytesZcompression_cacheZcompression_cache_missesZcompression_overflowZcompression_pagesZdata_processedZdata_remainingZ
data_totalZdisk_bpsZdisk_processedZdisk_remainingZdisk_temp_totalZdisk_temp_usedZ
disk_totalr� Z downtime_net�errmsgZ
memory_bpsZmemory_constantZmemory_dirty_rateZmemory_iterationZ
memory_normalZmemory_normal_bytesZmemory_page_sizeZmemory_postcopy_requestsZmemory_processedZmemory_remainingZ memory_totalZ operationZ
setup_time�successZ time_elapsedZtime_elapsed_netZtime_remainingz
sev-api-majorz
sev-api-minorz sev-build-idzsev-measurementz
sev-policyz
sev-secretzsev-secret-headerzsev-secret-set-addressZ
hard_limitZ
min_guaranteeZ
soft_limitZswap_hard_limitZ numa_modeZ numa_nodesetr� Z
cpu_sharesZemulator_periodZemulator_quotaZ
global_periodZ global_quotaZiothread_periodZiothread_quota�limitZ reservationZsharesZ vcpu_periodZ
vcpu_quotazblkdeviotune.diskzblkdeviotune.group_namezblkdeviotune.read_bytes_secz blkdeviotune.read_bytes_sec_maxz&blkdeviotune.read_bytes_sec_max_lengthzblkdeviotune.read_iops_secz blkdeviotune.read_iops_sec_maxz%blkdeviotune.read_iops_sec_max_lengthzblkdeviotune.size_iops_secz blkdeviotune.total_bytes_secz blkdeviotune.total_bytes_sec_maxz'blkdeviotune.total_bytes_sec_max_lengthzblkdeviotune.total_iops_secz blkdeviotune.total_iops_sec_maxz&blkdeviotune.total_iops_sec_max_lengthz blkdeviotune.write_bytes_secz blkdeviotune.write_bytes_sec_maxz'blkdeviotune.write_bytes_sec_max_lengthzblkdeviotune.write_iops_secz blkdeviotune.write_iops_sec_maxz&blkdeviotune.write_iops_sec_max_lengthzcputune.cpu_shareszcputune.emulatorpinzcputune.emulator_periodzcputune.emulator_quotazcputune.global_periodzcputune.global_quotazcputune.iothreadpin%uzcputune.iothread_periodzcputune.iothread_quotazcputune.vcpupin%uzcputune.vcpu_periodzcputune.vcpu_quotazauto_converge.incrementzauto_converge.initialzbandwidth.postcopyZ compressionzcompression.mt.dthreadszcompression.mt.levelzcompression.mt.threadszcompression.xbzrle.cacheZdestination_nameZdestination_xmlZ
disks_portZ disks_uriZ graphics_uriZlisten_addressZ
migrate_diskszparallel.connectionsZpersistent_xmlztls.destinationZ migrate_uriZidleZintrZiowaitZkernelrt Z utilizationZshm_full_scansZshm_merge_across_nodesZshm_pages_sharedZshm_pages_sharingZshm_pages_to_scanZshm_pages_unsharedZshm_pages_volatileZshm_sleep_millisecsZbuffers�cachedZfreer� Zcbitposz
cert-chainz
max-es-guestsz
max-guestsZpdhzreduced-phys-bitsZalignment_faultsZbranch_instructionsZ
branch_missesZ
bus_cyclesZ cache_missesZcache_referencesZcmtZcontext_switchesZ cpu_clockZ
cpu_cyclesZcpu_migrationsZemulation_faultsZ instructionsZmbmlZmbmtZ page_faultsZpage_faults_majZpage_faults_minZref_cpu_cyclesZstalled_cycles_backendZstalled_cycles_frontendZ
task_clock)r )N)N)N)N)N)N)NrL rg rL rL rL rg rL (� r � ImportErrorZlib_eZ
cygvirtmodZcyg_er0 r� r Ztypingr r r r r r r r
r r r
r1 Z_EventCBZ_EventAddHandleFuncZ_EventUpdateHandleFuncZ_EventRemoveHandleFuncZ_TimerCBZ_EventAddTimeoutFuncZ_EventUpdateTimeoutFuncZ_EventRemoveTimeoutFuncrT Z_BlkioParameterZ_MemoryParameterZ_SchedParameterZ_TypedParameterr r r4 r: r< rB rF rJ rK rM rO rP rQ rR rS rT rU rV rW rX rY r rZ r[ r\ r] r^ �objectr r> rA rQ rS rU r r� r� r� r� r� r� r" ZVIR_DOMAIN_BLKIO_PARAM_INTZVIR_DOMAIN_BLKIO_PARAM_UINTZ VIR_DOMAIN_BLKIO_PARAM_LLONGZ VIR_DOMAIN_BLKIO_PARAM_ULLONGZ VIR_DOMAIN_BLKIO_PARAM_DOUBLEZ VIR_DOMAIN_BLKIO_PARAM_BOOLEANZVIR_CPU_COMPARE_ERRORZ VIR_CPU_COMPARE_INCOMPATIBLEZVIR_CPU_COMPARE_IDENTICALZVIR_CPU_COMPARE_SUPERSETZ(VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURESZ#VIR_CONNECT_BASELINE_CPU_MIGRATABLEZ VIR_CONNECT_CLOSE_REASON_ERRORZ VIR_CONNECT_CLOSE_REASON_EOFZ"VIR_CONNECT_CLOSE_REASON_KEEPALIVEZ VIR_CONNECT_CLOSE_REASON_CLIENTZ)VIR_CONNECT_COMPARE_CPU_FAIL_INCOMPATIBLEZ$VIR_CONNECT_COMPARE_CPU_VALIDATE_XMLZVIR_CRED_USERNAMEZVIR_CRED_AUTHNAMEZVIR_CRED_LANGUAGEZVIR_CRED_CNONCEZVIR_CRED_PASSPHRASEZVIR_CRED_ECHOPROMPTZVIR_CRED_NOECHOPROMPTZVIR_CRED_REALMZVIR_CRED_EXTERNALZ7VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_UNKNOWNZ>VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_DOMAIN_STARTEDZ7VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_CHANNELZ8VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_CONNECTEDZ;VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTEDZ VIR_DOMAIN_BLOCK_JOB_COMPLETEDZVIR_DOMAIN_BLOCK_JOB_FAILEDZ VIR_DOMAIN_BLOCK_JOB_CANCELEDZVIR_DOMAIN_BLOCK_JOB_READYZ-VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_STARTZ+VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_STARTZVIR_CONNECT_ROZVIR_CONNECT_NO_ALIASESZ(VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVEZ*VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVEZ,VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENTZ+VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENTZ)VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNINGZ(VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSEDZ)VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFFZ'VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHERZ(VIR_CONNECT_GET_ALL_DOMAINS_STATS_NOWAITZ)VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKINGZ/VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATSZ VIR_CONNECT_LIST_DOMAINS_ACTIVEZ!VIR_CONNECT_LIST_DOMAINS_INACTIVEZ#VIR_CONNECT_LIST_DOMAINS_PERSISTENTZ"VIR_CONNECT_LIST_DOMAINS_TRANSIENTZ VIR_CONNECT_LIST_DOMAINS_RUNNINGZ VIR_CONNECT_LIST_DOMAINS_PAUSEDZ VIR_CONNECT_LIST_DOMAINS_SHUTOFFZ VIR_CONNECT_LIST_DOMAINS_OTHERZ$VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVEZ'VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVEZ"VIR_CONNECT_LIST_DOMAINS_AUTOSTARTZ%VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTARTZ%VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOTZ$VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOTZ'VIR_CONNECT_LIST_DOMAINS_HAS_CHECKPOINTZ&VIR_CONNECT_LIST_DOMAINS_NO_CHECKPOINTZ$VIR_CONNECT_LIST_INTERFACES_INACTIVEZ"VIR_CONNECT_LIST_INTERFACES_ACTIVEZ"VIR_CONNECT_LIST_NETWORKS_INACTIVEZ VIR_CONNECT_LIST_NETWORKS_ACTIVEZ$VIR_CONNECT_LIST_NETWORKS_PERSISTENTZ#VIR_CONNECT_LIST_NETWORKS_TRANSIENTZ#VIR_CONNECT_LIST_NETWORKS_AUTOSTARTZ&VIR_CONNECT_LIST_NETWORKS_NO_AUTOSTARTZ(VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEMZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEVZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_DEVZ/VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_INTERFACEZ%VIR_CONNECT_LIST_NODE_DEVICES_CAP_NETZ+VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_HOSTZ-VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_TARGETZ&VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSIZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_STORAGEZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_FC_HOSTZ(VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPORTSZ.VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_GENERICZ%VIR_CONNECT_LIST_NODE_DEVICES_CAP_DRMZ,VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV_TYPESZ&VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEVZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCW_DEVZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_CSS_DEVZ&VIR_CONNECT_LIST_NODE_DEVICES_CAP_VDPAZ)VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_CARDZ*VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_QUEUEZ+VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_MATRIXZ%VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPDZ&VIR_CONNECT_LIST_NODE_DEVICES_INACTIVEZ$VIR_CONNECT_LIST_NODE_DEVICES_ACTIVEZ"VIR_CONNECT_LIST_SECRETS_EPHEMERALZ%VIR_CONNECT_LIST_SECRETS_NO_EPHEMERALZ VIR_CONNECT_LIST_SECRETS_PRIVATEZ#VIR_CONNECT_LIST_SECRETS_NO_PRIVATEZ'VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVEZ%VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVEZ)VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENTZ(VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENTZ(VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTARTZ+VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTARTZ"VIR_CONNECT_LIST_STORAGE_POOLS_DIRZ!VIR_CONNECT_LIST_STORAGE_POOLS_FSZ$VIR_CONNECT_LIST_STORAGE_POOLS_NETFSZ&VIR_CONNECT_LIST_STORAGE_POOLS_LOGICALZ#VIR_CONNECT_LIST_STORAGE_POOLS_DISKZ$VIR_CONNECT_LIST_STORAGE_POOLS_ISCSIZ#VIR_CONNECT_LIST_STORAGE_POOLS_SCSIZ$VIR_CONNECT_LIST_STORAGE_POOLS_MPATHZ"VIR_CONNECT_LIST_STORAGE_POOLS_RBDZ'VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOGZ&VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTERZ"VIR_CONNECT_LIST_STORAGE_POOLS_ZFSZ'VIR_CONNECT_LIST_STORAGE_POOLS_VSTORAGEZ+VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI_DIRECTZ'VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCKZ)VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULTZ(VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAITZ)VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_APPENDZ)VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_REMOVEZ&VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNALZ VIR_DOMAIN_BLOCK_COMMIT_SHALLOWZ VIR_DOMAIN_BLOCK_COMMIT_DELETEZ VIR_DOMAIN_BLOCK_COMMIT_ACTIVEZ VIR_DOMAIN_BLOCK_COMMIT_RELATIVEZ'VIR_DOMAIN_BLOCK_COMMIT_BANDWIDTH_BYTESZ VIR_DOMAIN_BLOCK_COPY_SHALLOWZ VIR_DOMAIN_BLOCK_COPY_REUSE_EXTZ#VIR_DOMAIN_BLOCK_COPY_TRANSIENT_JOBZ(VIR_DOMAIN_BLOCK_COPY_SYNCHRONOUS_WRITESZ VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNCZ VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOTZ)VIR_DOMAIN_BLOCK_JOB_INFO_BANDWIDTH_BYTESZ*VIR_DOMAIN_BLOCK_JOB_SPEED_BANDWIDTH_BYTESZ!VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWNZ VIR_DOMAIN_BLOCK_JOB_TYPE_PULLZ VIR_DOMAIN_BLOCK_JOB_TYPE_COPYZ VIR_DOMAIN_BLOCK_JOB_TYPE_COMMITZ'VIR_DOMAIN_BLOCK_JOB_TYPE_ACTIVE_COMMITZ VIR_DOMAIN_BLOCK_JOB_TYPE_BACKUPZ%VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTESZ VIR_DOMAIN_BLOCK_REBASE_SHALLOWZ!VIR_DOMAIN_BLOCK_REBASE_REUSE_EXTZ VIR_DOMAIN_BLOCK_REBASE_COPY_RAWZ VIR_DOMAIN_BLOCK_REBASE_COPYZ VIR_DOMAIN_BLOCK_REBASE_RELATIVEZ VIR_DOMAIN_BLOCK_REBASE_COPY_DEVZ'VIR_DOMAIN_BLOCK_REBASE_BANDWIDTH_BYTESZ VIR_DOMAIN_BLOCK_RESIZE_BYTESZVIR_DOMAIN_BLOCKED_UNKNOWNZVIR_DOMAIN_CHANNEL_FORCEZ%VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINEZ$VIR_DOMAIN_CHECKPOINT_CREATE_QUIESCEZ.VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE_VALIDATEZ%VIR_DOMAIN_CHECKPOINT_DELETE_CHILDRENZ*VIR_DOMAIN_CHECKPOINT_DELETE_METADATA_ONLYZ*VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN_ONLYZ&VIR_DOMAIN_CHECKPOINT_LIST_DESCENDANTSZ VIR_DOMAIN_CHECKPOINT_LIST_ROOTSZ&VIR_DOMAIN_CHECKPOINT_LIST_TOPOLOGICALZ!VIR_DOMAIN_CHECKPOINT_LIST_LEAVESZ$VIR_DOMAIN_CHECKPOINT_LIST_NO_LEAVESZ VIR_DOMAIN_CHECKPOINT_XML_SECUREZ#VIR_DOMAIN_CHECKPOINT_XML_NO_DOMAINZ VIR_DOMAIN_CHECKPOINT_XML_SIZEZVIR_DOMAIN_CONSOLE_FORCEZVIR_DOMAIN_CONSOLE_SAFEZ$VIR_DOMAIN_CONTROL_ERROR_REASON_NONEZ'VIR_DOMAIN_CONTROL_ERROR_REASON_UNKNOWNZ'VIR_DOMAIN_CONTROL_ERROR_REASON_MONITORZ(VIR_DOMAIN_CONTROL_ERROR_REASON_INTERNALZVIR_DOMAIN_CONTROL_OKZVIR_DOMAIN_CONTROL_JOBZVIR_DOMAIN_CONTROL_OCCUPIEDZVIR_DOMAIN_CONTROL_ERRORZVIR_DUMP_CRASHZ
VIR_DUMP_LIVEZVIR_DUMP_BYPASS_CACHEZVIR_DUMP_RESETZVIR_DUMP_MEMORY_ONLYZ VIR_DOMAIN_CORE_DUMP_FORMAT_RAWZ&VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_ZLIBZ%VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_LZOZ(VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_SNAPPYZ#VIR_DOMAIN_CORE_DUMP_FORMAT_WIN_DMPZVIR_DOMAIN_CRASHED_UNKNOWNZVIR_DOMAIN_CRASHED_PANICKEDZVIR_DOMAIN_NONEZVIR_DOMAIN_START_PAUSEDZ VIR_DOMAIN_START_AUTODESTROYZ VIR_DOMAIN_START_BYPASS_CACHEZVIR_DOMAIN_START_FORCE_BOOTZVIR_DOMAIN_START_VALIDATEZVIR_DOMAIN_DEFINE_VALIDATEZVIR_DOMAIN_DESTROY_DEFAULTZVIR_DOMAIN_DESTROY_GRACEFULZ VIR_DOMAIN_DEVICE_MODIFY_CURRENTZ VIR_DOMAIN_DEVICE_MODIFY_LIVEZ VIR_DOMAIN_DEVICE_MODIFY_CONFIGZ VIR_DOMAIN_DEVICE_MODIFY_FORCEZ VIR_DOMAIN_DIRTYRATE_UNSTARTEDZ VIR_DOMAIN_DIRTYRATE_MEASURINGZ VIR_DOMAIN_DIRTYRATE_MEASUREDZVIR_DOMAIN_DISK_ERROR_NONEZ VIR_DOMAIN_DISK_ERROR_UNSPECZ VIR_DOMAIN_DISK_ERROR_NO_SPACEZ!VIR_DOMAIN_EVENT_CRASHED_PANICKEDZ$VIR_DOMAIN_EVENT_CRASHED_CRASHLOADEDZ VIR_DOMAIN_EVENT_DEFINED_ADDEDZ VIR_DOMAIN_EVENT_DEFINED_UPDATEDZ VIR_DOMAIN_EVENT_DEFINED_RENAMEDZ&VIR_DOMAIN_EVENT_DEFINED_FROM_SNAPSHOTZ&VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4Z&VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6Z&VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIXZ!VIR_DOMAIN_EVENT_GRAPHICS_CONNECTZ$VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZEZ$VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECTZ VIR_DOMAIN_EVENT_ID_LIFECYCLEZVIR_DOMAIN_EVENT_ID_REBOOTZ VIR_DOMAIN_EVENT_ID_RTC_CHANGEZ VIR_DOMAIN_EVENT_ID_WATCHDOGZ VIR_DOMAIN_EVENT_ID_IO_ERRORZ VIR_DOMAIN_EVENT_ID_GRAPHICSZ#VIR_DOMAIN_EVENT_ID_IO_ERROR_REASONZ!VIR_DOMAIN_EVENT_ID_CONTROL_ERRORZ VIR_DOMAIN_EVENT_ID_BLOCK_JOBZ VIR_DOMAIN_EVENT_ID_DISK_CHANGEZ VIR_DOMAIN_EVENT_ID_TRAY_CHANGEZ VIR_DOMAIN_EVENT_ID_PMWAKEUPZ VIR_DOMAIN_EVENT_ID_PMSUSPENDZ"VIR_DOMAIN_EVENT_ID_BALLOON_CHANGEZ"VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISKZ"VIR_DOMAIN_EVENT_ID_DEVICE_REMOVEDZ VIR_DOMAIN_EVENT_ID_BLOCK_JOB_2ZVIR_DOMAIN_EVENT_ID_TUNABLEZ#VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLEZ VIR_DOMAIN_EVENT_ID_DEVICE_ADDEDZ'VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATIONZ!VIR_DOMAIN_EVENT_ID_JOB_COMPLETEDZ)VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILEDZ#VIR_DOMAIN_EVENT_ID_METADATA_CHANGEZ#VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLDZ"VIR_DOMAIN_EVENT_ID_MEMORY_FAILUREZ-VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGEZ VIR_DOMAIN_EVENT_IO_ERROR_NONEZ VIR_DOMAIN_EVENT_IO_ERROR_PAUSEZ VIR_DOMAIN_EVENT_IO_ERROR_REPORTZ#VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORYZ!VIR_DOMAIN_EVENT_PMSUSPENDED_DISKZ!VIR_DOMAIN_EVENT_RESUMED_UNPAUSEDZ!VIR_DOMAIN_EVENT_RESUMED_MIGRATEDZ&VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOTZ!VIR_DOMAIN_EVENT_RESUMED_POSTCOPYZ"VIR_DOMAIN_EVENT_SHUTDOWN_FINISHEDZ VIR_DOMAIN_EVENT_SHUTDOWN_GUESTZ VIR_DOMAIN_EVENT_SHUTDOWN_HOSTZ VIR_DOMAIN_EVENT_STARTED_BOOTEDZ!VIR_DOMAIN_EVENT_STARTED_MIGRATEDZ!VIR_DOMAIN_EVENT_STARTED_RESTOREDZ&VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOTZ VIR_DOMAIN_EVENT_STARTED_WAKEUPZ!VIR_DOMAIN_EVENT_STOPPED_SHUTDOWNZ"VIR_DOMAIN_EVENT_STOPPED_DESTROYEDZ VIR_DOMAIN_EVENT_STOPPED_CRASHEDZ!VIR_DOMAIN_EVENT_STOPPED_MIGRATEDZ VIR_DOMAIN_EVENT_STOPPED_SAVEDZ VIR_DOMAIN_EVENT_STOPPED_FAILEDZ&VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOTZ!VIR_DOMAIN_EVENT_SUSPENDED_PAUSEDZ#VIR_DOMAIN_EVENT_SUSPENDED_MIGRATEDZ"VIR_DOMAIN_EVENT_SUSPENDED_IOERRORZ#VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOGZ#VIR_DOMAIN_EVENT_SUSPENDED_RESTOREDZ(VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOTZ$VIR_DOMAIN_EVENT_SUSPENDED_API_ERRORZ#VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPYZ*VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY_FAILEDZ!VIR_DOMAIN_EVENT_TRAY_CHANGE_OPENZ"VIR_DOMAIN_EVENT_TRAY_CHANGE_CLOSEZVIR_DOMAIN_EVENT_DEFINEDZVIR_DOMAIN_EVENT_UNDEFINEDZVIR_DOMAIN_EVENT_STARTEDZVIR_DOMAIN_EVENT_SUSPENDEDZVIR_DOMAIN_EVENT_RESUMEDZVIR_DOMAIN_EVENT_STOPPEDZVIR_DOMAIN_EVENT_SHUTDOWNZ VIR_DOMAIN_EVENT_PMSUSPENDEDZVIR_DOMAIN_EVENT_CRASHEDZ"VIR_DOMAIN_EVENT_UNDEFINED_REMOVEDZ"VIR_DOMAIN_EVENT_UNDEFINED_RENAMEDZ VIR_DOMAIN_EVENT_WATCHDOG_NONEZ VIR_DOMAIN_EVENT_WATCHDOG_PAUSEZ VIR_DOMAIN_EVENT_WATCHDOG_RESETZ"VIR_DOMAIN_EVENT_WATCHDOG_POWEROFFZ"VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWNZ VIR_DOMAIN_EVENT_WATCHDOG_DEBUGZ#VIR_DOMAIN_EVENT_WATCHDOG_INJECTNMIZ VIR_DOMAIN_GET_HOSTNAME_LEASEZ VIR_DOMAIN_GET_HOSTNAME_AGENTZ VIR_DOMAIN_JOB_STATS_COMPLETEDZ#VIR_DOMAIN_JOB_STATS_KEEP_COMPLETEDZVIR_DOMAIN_GUEST_INFO_USERSZVIR_DOMAIN_GUEST_INFO_OSZ VIR_DOMAIN_GUEST_INFO_TIMEZONEZ VIR_DOMAIN_GUEST_INFO_HOSTNAMEZ VIR_DOMAIN_GUEST_INFO_FILESYSTEMZVIR_DOMAIN_GUEST_INFO_DISKSZ VIR_DOMAIN_GUEST_INFO_INTERFACESZ(VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASEZ(VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENTZ&VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_ARPZ VIR_DOMAIN_JOB_OPERATION_UNKNOWNZ VIR_DOMAIN_JOB_OPERATION_STARTZ VIR_DOMAIN_JOB_OPERATION_SAVEZ VIR_DOMAIN_JOB_OPERATION_RESTOREZ%VIR_DOMAIN_JOB_OPERATION_MIGRATION_INZ&VIR_DOMAIN_JOB_OPERATION_MIGRATION_OUTZ!VIR_DOMAIN_JOB_OPERATION_SNAPSHOTZ(VIR_DOMAIN_JOB_OPERATION_SNAPSHOT_REVERTZ VIR_DOMAIN_JOB_OPERATION_DUMPZ VIR_DOMAIN_JOB_OPERATION_BACKUPZVIR_DOMAIN_JOB_NONEZVIR_DOMAIN_JOB_BOUNDEDZVIR_DOMAIN_JOB_UNBOUNDEDZVIR_DOMAIN_JOB_COMPLETEDZVIR_DOMAIN_JOB_FAILEDZVIR_DOMAIN_JOB_CANCELLEDZ VIR_DOMAIN_LIFECYCLE_POWEROFFZVIR_DOMAIN_LIFECYCLE_REBOOTZVIR_DOMAIN_LIFECYCLE_CRASHZ#VIR_DOMAIN_LIFECYCLE_ACTION_DESTROYZ#VIR_DOMAIN_LIFECYCLE_ACTION_RESTARTZ*VIR_DOMAIN_LIFECYCLE_ACTION_RESTART_RENAMEZ$VIR_DOMAIN_LIFECYCLE_ACTION_PRESERVEZ,VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_DESTROYZ,VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_RESTARTZ-VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_IGNOREZ-VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_INJECTZ,VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_FATALZ,VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_RESETZ)VIR_DOMAIN_MEMORY_FAILURE_ACTION_REQUIREDZ#VIR_DOMAIN_MEMORY_FAILURE_RECURSIVEZ4VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_HYPERVISORZ/VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_GUESTZVIR_MEMORY_VIRTUALZVIR_MEMORY_PHYSICALZVIR_DOMAIN_MEM_CURRENTZVIR_DOMAIN_MEM_LIVEZVIR_DOMAIN_MEM_CONFIGZVIR_DOMAIN_MEM_MAXIMUMZ VIR_DOMAIN_MEMORY_STAT_SWAP_INZ VIR_DOMAIN_MEMORY_STAT_SWAP_OUTZ"VIR_DOMAIN_MEMORY_STAT_MAJOR_FAULTZ"VIR_DOMAIN_MEMORY_STAT_MINOR_FAULTZ VIR_DOMAIN_MEMORY_STAT_UNUSEDZ VIR_DOMAIN_MEMORY_STAT_AVAILABLEZ%VIR_DOMAIN_MEMORY_STAT_ACTUAL_BALLOONZVIR_DOMAIN_MEMORY_STAT_RSSZ VIR_DOMAIN_MEMORY_STAT_USABLEZ"VIR_DOMAIN_MEMORY_STAT_LAST_UPDATEZ"VIR_DOMAIN_MEMORY_STAT_DISK_CACHESZ&VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGALLOCZ%VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGFAILZVIR_DOMAIN_MEMORY_STAT_LASTZVIR_DOMAIN_MEMORY_STAT_NRZ VIR_DOMAIN_MESSAGE_DEPRECATIONZVIR_DOMAIN_MESSAGE_TAINTINGZ VIR_DOMAIN_METADATA_DESCRIPTIONZVIR_DOMAIN_METADATA_TITLEZVIR_DOMAIN_METADATA_ELEMENTZVIR_MIGRATE_LIVEZVIR_MIGRATE_PEER2PEERZVIR_MIGRATE_TUNNELLEDZVIR_MIGRATE_PERSIST_DESTZVIR_MIGRATE_UNDEFINE_SOURCEZVIR_MIGRATE_PAUSEDZVIR_MIGRATE_NON_SHARED_DISKZVIR_MIGRATE_NON_SHARED_INCZ VIR_MIGRATE_CHANGE_PROTECTIONZVIR_MIGRATE_UNSAFEZVIR_MIGRATE_OFFLINEZVIR_MIGRATE_COMPRESSEDZVIR_MIGRATE_ABORT_ON_ERRORZVIR_MIGRATE_AUTO_CONVERGEZVIR_MIGRATE_RDMA_PIN_ALLZVIR_MIGRATE_POSTCOPYZVIR_MIGRATE_TLSZVIR_MIGRATE_PARALLELZ)VIR_MIGRATE_NON_SHARED_SYNCHRONOUS_WRITESZVIR_MIGRATE_ZEROCOPYZ%VIR_DOMAIN_MIGRATE_MAX_SPEED_POSTCOPYZVIR_DOMAIN_AFFECT_CURRENTZVIR_DOMAIN_AFFECT_LIVEZVIR_DOMAIN_AFFECT_CONFIGZVIR_DOMAIN_NOSTATE_UNKNOWNZ VIR_DOMAIN_NUMATUNE_MEM_STRICTZ!VIR_DOMAIN_NUMATUNE_MEM_PREFERREDZ"VIR_DOMAIN_NUMATUNE_MEM_INTERLEAVEZ#VIR_DOMAIN_NUMATUNE_MEM_RESTRICTIVEZ!VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTHZ#VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWNZ VIR_DOMAIN_PMSUSPENDED_UNKNOWNZVIR_DOMAIN_PAUSED_UNKNOWNZVIR_DOMAIN_PAUSED_USERZVIR_DOMAIN_PAUSED_MIGRATIONZVIR_DOMAIN_PAUSED_SAVEZVIR_DOMAIN_PAUSED_DUMPZVIR_DOMAIN_PAUSED_IOERRORZVIR_DOMAIN_PAUSED_WATCHDOGZ VIR_DOMAIN_PAUSED_FROM_SNAPSHOTZ VIR_DOMAIN_PAUSED_SHUTTING_DOWNZVIR_DOMAIN_PAUSED_SNAPSHOTZVIR_DOMAIN_PAUSED_CRASHEDZ VIR_DOMAIN_PAUSED_STARTING_UPZVIR_DOMAIN_PAUSED_POSTCOPYZ!VIR_DOMAIN_PAUSED_POSTCOPY_FAILEDZ VIR_DOMAIN_PROCESS_SIGNAL_NOPZ VIR_DOMAIN_PROCESS_SIGNAL_HUPZ VIR_DOMAIN_PROCESS_SIGNAL_INTZ VIR_DOMAIN_PROCESS_SIGNAL_QUITZ VIR_DOMAIN_PROCESS_SIGNAL_ILLZ VIR_DOMAIN_PROCESS_SIGNAL_TRAPZ VIR_DOMAIN_PROCESS_SIGNAL_ABRTZ VIR_DOMAIN_PROCESS_SIGNAL_BUSZ VIR_DOMAIN_PROCESS_SIGNAL_FPEZ VIR_DOMAIN_PROCESS_SIGNAL_KILLZ VIR_DOMAIN_PROCESS_SIGNAL_USR1Z VIR_DOMAIN_PROCESS_SIGNAL_SEGVZ VIR_DOMAIN_PROCESS_SIGNAL_USR2Z VIR_DOMAIN_PROCESS_SIGNAL_PIPEZ VIR_DOMAIN_PROCESS_SIGNAL_ALRMZ VIR_DOMAIN_PROCESS_SIGNAL_TERMZ VIR_DOMAIN_PROCESS_SIGNAL_STKFLTZ VIR_DOMAIN_PROCESS_SIGNAL_CHLDZ VIR_DOMAIN_PROCESS_SIGNAL_CONTZ VIR_DOMAIN_PROCESS_SIGNAL_STOPZ VIR_DOMAIN_PROCESS_SIGNAL_TSTPZ VIR_DOMAIN_PROCESS_SIGNAL_TTINZ VIR_DOMAIN_PROCESS_SIGNAL_TTOUZ VIR_DOMAIN_PROCESS_SIGNAL_URGZ VIR_DOMAIN_PROCESS_SIGNAL_XCPUZ VIR_DOMAIN_PROCESS_SIGNAL_XFSZZ VIR_DOMAIN_PROCESS_SIGNAL_VTALRMZ VIR_DOMAIN_PROCESS_SIGNAL_PROFZ VIR_DOMAIN_PROCESS_SIGNAL_WINCHZ VIR_DOMAIN_PROCESS_SIGNAL_POLLZ VIR_DOMAIN_PROCESS_SIGNAL_PWRZ VIR_DOMAIN_PROCESS_SIGNAL_SYSZ VIR_DOMAIN_PROCESS_SIGNAL_RT0Z VIR_DOMAIN_PROCESS_SIGNAL_RT1Z VIR_DOMAIN_PROCESS_SIGNAL_RT2Z VIR_DOMAIN_PROCESS_SIGNAL_RT3Z VIR_DOMAIN_PROCESS_SIGNAL_RT4Z VIR_DOMAIN_PROCESS_SIGNAL_RT5Z VIR_DOMAIN_PROCESS_SIGNAL_RT6Z VIR_DOMAIN_PROCESS_SIGNAL_RT7Z VIR_DOMAIN_PROCESS_SIGNAL_RT8Z VIR_DOMAIN_PROCESS_SIGNAL_RT9Z VIR_DOMAIN_PROCESS_SIGNAL_RT10Z VIR_DOMAIN_PROCESS_SIGNAL_RT11Z VIR_DOMAIN_PROCESS_SIGNAL_RT12Z VIR_DOMAIN_PROCESS_SIGNAL_RT13Z VIR_DOMAIN_PROCESS_SIGNAL_RT14Z VIR_DOMAIN_PROCESS_SIGNAL_RT15Z VIR_DOMAIN_PROCESS_SIGNAL_RT16Z VIR_DOMAIN_PROCESS_SIGNAL_RT17Z VIR_DOMAIN_PROCESS_SIGNAL_RT18Z VIR_DOMAIN_PROCESS_SIGNAL_RT19Z VIR_DOMAIN_PROCESS_SIGNAL_RT20Z VIR_DOMAIN_PROCESS_SIGNAL_RT21Z VIR_DOMAIN_PROCESS_SIGNAL_RT22Z VIR_DOMAIN_PROCESS_SIGNAL_RT23Z VIR_DOMAIN_PROCESS_SIGNAL_RT24Z VIR_DOMAIN_PROCESS_SIGNAL_RT25Z VIR_DOMAIN_PROCESS_SIGNAL_RT26Z VIR_DOMAIN_PROCESS_SIGNAL_RT27Z VIR_DOMAIN_PROCESS_SIGNAL_RT28Z VIR_DOMAIN_PROCESS_SIGNAL_RT29Z VIR_DOMAIN_PROCESS_SIGNAL_RT30Z VIR_DOMAIN_PROCESS_SIGNAL_RT31Z VIR_DOMAIN_PROCESS_SIGNAL_RT32ZVIR_DOMAIN_REBOOT_DEFAULTZ VIR_DOMAIN_REBOOT_ACPI_POWER_BTNZ VIR_DOMAIN_REBOOT_GUEST_AGENTZVIR_DOMAIN_REBOOT_INITCTLZVIR_DOMAIN_REBOOT_SIGNALZVIR_DOMAIN_REBOOT_PARAVIRTZVIR_DOMAIN_RUNNING_UNKNOWNZVIR_DOMAIN_RUNNING_BOOTEDZVIR_DOMAIN_RUNNING_MIGRATEDZVIR_DOMAIN_RUNNING_RESTOREDZ VIR_DOMAIN_RUNNING_FROM_SNAPSHOTZVIR_DOMAIN_RUNNING_UNPAUSEDZ%VIR_DOMAIN_RUNNING_MIGRATION_CANCELEDZ VIR_DOMAIN_RUNNING_SAVE_CANCELEDZVIR_DOMAIN_RUNNING_WAKEUPZVIR_DOMAIN_RUNNING_CRASHEDZVIR_DOMAIN_RUNNING_POSTCOPYZ VIR_DOMAIN_SAVE_IMAGE_XML_SECUREZ VIR_DOMAIN_SAVE_BYPASS_CACHEZVIR_DOMAIN_SAVE_RUNNINGZVIR_DOMAIN_SAVE_PAUSEDZVIR_DOMAIN_TIME_SYNCZ VIR_DOMAIN_PASSWORD_ENCRYPTEDZVIR_DOMAIN_SHUTDOWN_DEFAULTZ"VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTNZ VIR_DOMAIN_SHUTDOWN_GUEST_AGENTZVIR_DOMAIN_SHUTDOWN_INITCTLZVIR_DOMAIN_SHUTDOWN_SIGNALZ VIR_DOMAIN_SHUTDOWN_PARAVIRTZVIR_DOMAIN_SHUTDOWN_UNKNOWNZVIR_DOMAIN_SHUTDOWN_USERZVIR_DOMAIN_SHUTOFF_UNKNOWNZVIR_DOMAIN_SHUTOFF_SHUTDOWNZ VIR_DOMAIN_SHUTOFF_DESTROYEDZVIR_DOMAIN_SHUTOFF_CRASHEDZVIR_DOMAIN_SHUTOFF_MIGRATEDZVIR_DOMAIN_SHUTOFF_SAVEDZVIR_DOMAIN_SHUTOFF_FAILEDZ VIR_DOMAIN_SHUTOFF_FROM_SNAPSHOTZVIR_DOMAIN_SHUTOFF_DAEMONZ#VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINEZ"VIR_DOMAIN_SNAPSHOT_CREATE_CURRENTZ&VIR_DOMAIN_SNAPSHOT_CREATE_NO_METADATAZ VIR_DOMAIN_SNAPSHOT_CREATE_HALTZ$VIR_DOMAIN_SNAPSHOT_CREATE_DISK_ONLYZ$VIR_DOMAIN_SNAPSHOT_CREATE_REUSE_EXTZ"VIR_DOMAIN_SNAPSHOT_CREATE_QUIESCEZ!VIR_DOMAIN_SNAPSHOT_CREATE_ATOMICZ VIR_DOMAIN_SNAPSHOT_CREATE_LIVEZ#VIR_DOMAIN_SNAPSHOT_CREATE_VALIDATEZ#VIR_DOMAIN_SNAPSHOT_DELETE_CHILDRENZ(VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLYZ(VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLYZ$VIR_DOMAIN_SNAPSHOT_LIST_DESCENDANTSZ VIR_DOMAIN_SNAPSHOT_LIST_ROOTSZ!VIR_DOMAIN_SNAPSHOT_LIST_METADATAZ VIR_DOMAIN_SNAPSHOT_LIST_LEAVESZ"VIR_DOMAIN_SNAPSHOT_LIST_NO_LEAVESZ$VIR_DOMAIN_SNAPSHOT_LIST_NO_METADATAZ!VIR_DOMAIN_SNAPSHOT_LIST_INACTIVEZ VIR_DOMAIN_SNAPSHOT_LIST_ACTIVEZ"VIR_DOMAIN_SNAPSHOT_LIST_DISK_ONLYZ!VIR_DOMAIN_SNAPSHOT_LIST_INTERNALZ!VIR_DOMAIN_SNAPSHOT_LIST_EXTERNALZ$VIR_DOMAIN_SNAPSHOT_LIST_TOPOLOGICALZ"VIR_DOMAIN_SNAPSHOT_REVERT_RUNNINGZ!VIR_DOMAIN_SNAPSHOT_REVERT_PAUSEDZ VIR_DOMAIN_SNAPSHOT_REVERT_FORCEZ VIR_DOMAIN_SNAPSHOT_XML_SECUREZVIR_DOMAIN_NOSTATEZVIR_DOMAIN_RUNNINGZVIR_DOMAIN_BLOCKEDZVIR_DOMAIN_PAUSEDZVIR_DOMAIN_SHUTDOWNZVIR_DOMAIN_SHUTOFFZVIR_DOMAIN_CRASHEDZVIR_DOMAIN_PMSUSPENDEDZVIR_DOMAIN_STATS_STATEZVIR_DOMAIN_STATS_CPU_TOTALZVIR_DOMAIN_STATS_BALLOONZVIR_DOMAIN_STATS_VCPUZVIR_DOMAIN_STATS_INTERFACEZVIR_DOMAIN_STATS_BLOCKZVIR_DOMAIN_STATS_PERFZVIR_DOMAIN_STATS_IOTHREADZVIR_DOMAIN_STATS_MEMORYZVIR_DOMAIN_STATS_DIRTYRATEZ VIR_DOMAIN_UNDEFINE_MANAGED_SAVEZ&VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATAZVIR_DOMAIN_UNDEFINE_NVRAMZ VIR_DOMAIN_UNDEFINE_KEEP_NVRAMZ(VIR_DOMAIN_UNDEFINE_CHECKPOINTS_METADATAZVIR_DOMAIN_VCPU_CURRENTZVIR_DOMAIN_VCPU_LIVEZVIR_DOMAIN_VCPU_CONFIGZVIR_DOMAIN_VCPU_MAXIMUMZVIR_DOMAIN_VCPU_GUESTZ VIR_DOMAIN_VCPU_HOTPLUGGABLEZVIR_DOMAIN_XML_SECUREZVIR_DOMAIN_XML_INACTIVEZVIR_DOMAIN_XML_UPDATE_CPUZVIR_DOMAIN_XML_MIGRATABLEZ
VIR_FROM_NONEZ VIR_FROM_XENZ
VIR_FROM_XENDZVIR_FROM_XENSTOREZVIR_FROM_SEXPRZ VIR_FROM_XMLZ VIR_FROM_DOMZ VIR_FROM_RPCZVIR_FROM_PROXYZ
VIR_FROM_CONFZ
VIR_FROM_QEMUZ VIR_FROM_NETZ
VIR_FROM_TESTZVIR_FROM_REMOTEZVIR_FROM_OPENVZZVIR_FROM_XENXMZVIR_FROM_STATS_LINUXZ VIR_FROM_LXCZVIR_FROM_STORAGEZVIR_FROM_NETWORKZVIR_FROM_DOMAINZ VIR_FROM_UMLZVIR_FROM_NODEDEVZVIR_FROM_XEN_INOTIFYZVIR_FROM_SECURITYZ
VIR_FROM_VBOXZVIR_FROM_INTERFACEZ VIR_FROM_ONEZ VIR_FROM_ESXZ
VIR_FROM_PHYPZVIR_FROM_SECRETZ VIR_FROM_CPUZVIR_FROM_XENAPIZVIR_FROM_NWFILTERZ
VIR_FROM_HOOKZVIR_FROM_DOMAIN_SNAPSHOTZVIR_FROM_AUDITZVIR_FROM_SYSINFOZVIR_FROM_STREAMSZVIR_FROM_VMWAREZVIR_FROM_EVENTZVIR_FROM_LIBXLZVIR_FROM_LOCKINGZVIR_FROM_HYPERVZVIR_FROM_CAPABILITIESZ VIR_FROM_URIZ
VIR_FROM_AUTHZ
VIR_FROM_DBUSZVIR_FROM_PARALLELSZVIR_FROM_DEVICEZ VIR_FROM_SSHZVIR_FROM_LOCKSPACEZVIR_FROM_INITCTLZVIR_FROM_IDENTITYZVIR_FROM_CGROUPZVIR_FROM_ACCESSZVIR_FROM_SYSTEMDZVIR_FROM_BHYVEZVIR_FROM_CRYPTOZVIR_FROM_FIREWALLZVIR_FROM_POLKITZVIR_FROM_THREADZVIR_FROM_ADMINZVIR_FROM_LOGGINGZVIR_FROM_XENXLZ
VIR_FROM_PERFZVIR_FROM_LIBSSHZVIR_FROM_RESCTRLZVIR_FROM_FIREWALLDZVIR_FROM_DOMAIN_CHECKPOINTZ VIR_FROM_TPMZ VIR_FROM_BPFZ VIR_FROM_CHZ VIR_ERR_NONEZVIR_ERR_WARNINGZ
VIR_ERR_ERRORZ
VIR_ERR_OKZVIR_ERR_INTERNAL_ERRORZVIR_ERR_NO_MEMORYZVIR_ERR_NO_SUPPORTZVIR_ERR_UNKNOWN_HOSTZVIR_ERR_NO_CONNECTZVIR_ERR_INVALID_CONNZVIR_ERR_INVALID_DOMAINZVIR_ERR_INVALID_ARGZVIR_ERR_OPERATION_FAILEDZVIR_ERR_GET_FAILEDZVIR_ERR_POST_FAILEDZVIR_ERR_HTTP_ERRORZVIR_ERR_SEXPR_SERIALZVIR_ERR_NO_XENZVIR_ERR_XEN_CALLZVIR_ERR_OS_TYPEZVIR_ERR_NO_KERNELZVIR_ERR_NO_ROOTZVIR_ERR_NO_SOURCEZVIR_ERR_NO_TARGETZVIR_ERR_NO_NAMEZ
VIR_ERR_NO_OSZVIR_ERR_NO_DEVICEZVIR_ERR_NO_XENSTOREZVIR_ERR_DRIVER_FULLZVIR_ERR_CALL_FAILEDZVIR_ERR_XML_ERRORZVIR_ERR_DOM_EXISTZVIR_ERR_OPERATION_DENIEDZVIR_ERR_OPEN_FAILEDZVIR_ERR_READ_FAILEDZVIR_ERR_PARSE_FAILEDZVIR_ERR_CONF_SYNTAXZVIR_ERR_WRITE_FAILEDZVIR_ERR_XML_DETAILZVIR_ERR_INVALID_NETWORKZVIR_ERR_NETWORK_EXISTZVIR_ERR_SYSTEM_ERRORZ VIR_ERR_RPCZVIR_ERR_GNUTLS_ERRORZVIR_WAR_NO_NETWORKZVIR_ERR_NO_DOMAINZVIR_ERR_NO_NETWORKZVIR_ERR_INVALID_MACZVIR_ERR_AUTH_FAILEDZ VIR_ERR_INVALID_STORAGE_POOLZVIR_ERR_INVALID_STORAGE_VOLZVIR_WAR_NO_STORAGEZVIR_ERR_NO_STORAGE_POOLZVIR_ERR_NO_STORAGE_VOLZVIR_WAR_NO_NODEZVIR_ERR_INVALID_NODE_DEVICEZVIR_ERR_NO_NODE_DEVICEZVIR_ERR_NO_SECURITY_MODELZVIR_ERR_OPERATION_INVALIDZVIR_WAR_NO_INTERFACEZVIR_ERR_NO_INTERFACEZVIR_ERR_INVALID_INTERFACEZVIR_ERR_MULTIPLE_INTERFACESZVIR_WAR_NO_NWFILTERZVIR_ERR_INVALID_NWFILTERZVIR_ERR_NO_NWFILTERZVIR_ERR_BUILD_FIREWALLZVIR_WAR_NO_SECRETZVIR_ERR_INVALID_SECRETZVIR_ERR_NO_SECRETZVIR_ERR_CONFIG_UNSUPPORTEDZVIR_ERR_OPERATION_TIMEOUTZ VIR_ERR_MIGRATE_PERSIST_FAILEDZVIR_ERR_HOOK_SCRIPT_FAILEDZ VIR_ERR_INVALID_DOMAIN_SNAPSHOTZVIR_ERR_NO_DOMAIN_SNAPSHOTZVIR_ERR_INVALID_STREAMZ VIR_ERR_ARGUMENT_UNSUPPORTEDZ VIR_ERR_STORAGE_PROBE_FAILEDZVIR_ERR_STORAGE_POOL_BUILTZ VIR_ERR_SNAPSHOT_REVERT_RISKYZVIR_ERR_OPERATION_ABORTEDZVIR_ERR_AUTH_CANCELLEDZVIR_ERR_NO_DOMAIN_METADATAZVIR_ERR_MIGRATE_UNSAFEZVIR_ERR_OVERFLOWZVIR_ERR_BLOCK_COPY_ACTIVEZ VIR_ERR_OPERATION_UNSUPPORTEDZ VIR_ERR_SSHZVIR_ERR_AGENT_UNRESPONSIVEZVIR_ERR_RESOURCE_BUSYZVIR_ERR_ACCESS_DENIEDZVIR_ERR_DBUS_SERVICEZVIR_ERR_STORAGE_VOL_EXISTZVIR_ERR_CPU_INCOMPATIBLEZVIR_ERR_XML_INVALID_SCHEMAZVIR_ERR_MIGRATE_FINISH_OKZVIR_ERR_AUTH_UNAVAILABLEZVIR_ERR_NO_SERVERZVIR_ERR_NO_CLIENTZVIR_ERR_AGENT_UNSYNCEDZVIR_ERR_LIBSSHZVIR_ERR_DEVICE_MISSINGZ VIR_ERR_INVALID_NWFILTER_BINDINGZVIR_ERR_NO_NWFILTER_BINDINGZ!VIR_ERR_INVALID_DOMAIN_CHECKPOINTZ VIR_ERR_NO_DOMAIN_CHECKPOINTZVIR_ERR_NO_DOMAIN_BACKUPZ VIR_ERR_INVALID_NETWORK_PORTZVIR_ERR_NETWORK_PORT_EXISTZVIR_ERR_NO_NETWORK_PORTZVIR_ERR_NO_HOSTNAMEZ VIR_ERR_CHECKPOINT_INCONSISTENTZVIR_ERR_MULTIPLE_DOMAINSZVIR_EVENT_HANDLE_READABLEZVIR_EVENT_HANDLE_WRITABLEZVIR_EVENT_HANDLE_ERRORZVIR_EVENT_HANDLE_HANGUPZVIR_IP_ADDR_TYPE_IPV4ZVIR_IP_ADDR_TYPE_IPV6Z VIR_INTERFACE_DEFINE_VALIDATEZVIR_INTERFACE_XML_INACTIVEZVIR_KEYCODE_SET_LINUXZVIR_KEYCODE_SET_XTZVIR_KEYCODE_SET_ATSET1ZVIR_KEYCODE_SET_ATSET2ZVIR_KEYCODE_SET_ATSET3ZVIR_KEYCODE_SET_OSXZVIR_KEYCODE_SET_XT_KBDZVIR_KEYCODE_SET_USBZVIR_KEYCODE_SET_WIN32ZVIR_KEYCODE_SET_QNUMZVIR_DOMAIN_MEMORY_PARAM_INTZ VIR_DOMAIN_MEMORY_PARAM_UINTZ VIR_DOMAIN_MEMORY_PARAM_LLONGZ VIR_DOMAIN_MEMORY_PARAM_ULLONGZ VIR_DOMAIN_MEMORY_PARAM_DOUBLEZ VIR_DOMAIN_MEMORY_PARAM_BOOLEANZ$VIR_NWFILTER_BINDING_CREATE_VALIDATEZ VIR_NWFILTER_DEFINE_VALIDATEZVIR_NETWORK_CREATE_VALIDATEZVIR_NETWORK_DEFINE_VALIDATEZ VIR_NETWORK_EVENT_ID_LIFECYCLEZVIR_NETWORK_EVENT_DEFINEDZVIR_NETWORK_EVENT_UNDEFINEDZVIR_NETWORK_EVENT_STARTEDZVIR_NETWORK_EVENT_STOPPEDZ VIR_NETWORK_PORT_CREATE_RECLAIMZ VIR_NETWORK_PORT_CREATE_VALIDATEZ VIR_NETWORK_UPDATE_COMMAND_NONEZ!VIR_NETWORK_UPDATE_COMMAND_MODIFYZ!VIR_NETWORK_UPDATE_COMMAND_DELETEZ#VIR_NETWORK_UPDATE_COMMAND_ADD_LASTZ$VIR_NETWORK_UPDATE_COMMAND_ADD_FIRSTZ!VIR_NETWORK_UPDATE_AFFECT_CURRENTZ VIR_NETWORK_UPDATE_AFFECT_LIVEZ VIR_NETWORK_UPDATE_AFFECT_CONFIGZVIR_NETWORK_SECTION_NONEZVIR_NETWORK_SECTION_BRIDGEZVIR_NETWORK_SECTION_DOMAINZVIR_NETWORK_SECTION_IPZ VIR_NETWORK_SECTION_IP_DHCP_HOSTZ!VIR_NETWORK_SECTION_IP_DHCP_RANGEZVIR_NETWORK_SECTION_FORWARDZ%VIR_NETWORK_SECTION_FORWARD_INTERFACEZ VIR_NETWORK_SECTION_FORWARD_PFZ VIR_NETWORK_SECTION_PORTGROUPZ VIR_NETWORK_SECTION_DNS_HOSTZVIR_NETWORK_SECTION_DNS_TXTZVIR_NETWORK_SECTION_DNS_SRVZVIR_NETWORK_XML_INACTIVEZVIR_NODE_ALLOC_PAGES_ADDZVIR_NODE_ALLOC_PAGES_SETZ"VIR_NODE_DEVICE_EVENT_ID_LIFECYCLEZ VIR_NODE_DEVICE_EVENT_ID_UPDATEZ VIR_NODE_DEVICE_EVENT_CREATEDZ VIR_NODE_DEVICE_EVENT_DELETEDZ VIR_NODE_DEVICE_EVENT_DEFINEDZ VIR_NODE_DEVICE_EVENT_UNDEFINEDZVIR_NODE_CPU_STATS_ALL_CPUSZ VIR_NODE_MEMORY_STATS_ALL_CELLSZVIR_NODE_SUSPEND_TARGET_MEMZ VIR_NODE_SUSPEND_TARGET_DISKZ VIR_NODE_SUSPEND_TARGET_HYBRIDZVIR_DOMAIN_SCHED_FIELD_INTZVIR_DOMAIN_SCHED_FIELD_UINTZ VIR_DOMAIN_SCHED_FIELD_LLONGZ VIR_DOMAIN_SCHED_FIELD_ULLONGZ VIR_DOMAIN_SCHED_FIELD_DOUBLEZ VIR_DOMAIN_SCHED_FIELD_BOOLEANZVIR_SECRET_DEFINE_VALIDATEZ VIR_SECRET_EVENT_ID_LIFECYCLEZ!VIR_SECRET_EVENT_ID_VALUE_CHANGEDZVIR_SECRET_EVENT_DEFINEDZVIR_SECRET_EVENT_UNDEFINEDZVIR_SECRET_USAGE_TYPE_NONEZ VIR_SECRET_USAGE_TYPE_VOLUMEZVIR_SECRET_USAGE_TYPE_CEPHZVIR_SECRET_USAGE_TYPE_ISCSIZVIR_SECRET_USAGE_TYPE_TLSZVIR_SECRET_USAGE_TYPE_VTPMZVIR_STORAGE_POOL_BUILD_NEWZ VIR_STORAGE_POOL_BUILD_REPAIRZ VIR_STORAGE_POOL_BUILD_RESIZEZ#VIR_STORAGE_POOL_BUILD_NO_OVERWRITEZ VIR_STORAGE_POOL_BUILD_OVERWRITEZ VIR_STORAGE_POOL_CREATE_NORMALZ"VIR_STORAGE_POOL_CREATE_WITH_BUILDZ,VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITEZ/VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITEZ VIR_STORAGE_POOL_DEFINE_VALIDATEZ VIR_STORAGE_POOL_DELETE_NORMALZ VIR_STORAGE_POOL_DELETE_ZEROEDZ#VIR_STORAGE_POOL_EVENT_ID_LIFECYCLEZ!VIR_STORAGE_POOL_EVENT_ID_REFRESHZ VIR_STORAGE_POOL_EVENT_DEFINEDZ VIR_STORAGE_POOL_EVENT_UNDEFINEDZ VIR_STORAGE_POOL_EVENT_STARTEDZ VIR_STORAGE_POOL_EVENT_STOPPEDZ VIR_STORAGE_POOL_EVENT_CREATEDZ VIR_STORAGE_POOL_EVENT_DELETEDZVIR_STORAGE_POOL_INACTIVEZVIR_STORAGE_POOL_BUILDINGZVIR_STORAGE_POOL_RUNNINGZVIR_STORAGE_POOL_DEGRADEDZ VIR_STORAGE_POOL_INACCESSIBLEZ(VIR_STORAGE_VOL_CREATE_PREALLOC_METADATAZ VIR_STORAGE_VOL_CREATE_REFLINKZ VIR_STORAGE_VOL_DELETE_NORMALZ VIR_STORAGE_VOL_DELETE_ZEROEDZ%VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTSZ&VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAMZ VIR_STORAGE_VOL_USE_ALLOCATIONZ VIR_STORAGE_VOL_GET_PHYSICALZ VIR_STORAGE_VOL_RESIZE_ALLOCATEZ VIR_STORAGE_VOL_RESIZE_DELTAZ VIR_STORAGE_VOL_RESIZE_SHRINKZVIR_STORAGE_VOL_FILEZVIR_STORAGE_VOL_BLOCKZVIR_STORAGE_VOL_DIRZVIR_STORAGE_VOL_NETWORKZVIR_STORAGE_VOL_NETDIRZVIR_STORAGE_VOL_PLOOPZ$VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAMZ VIR_STORAGE_VOL_WIPE_ALG_ZEROZ VIR_STORAGE_VOL_WIPE_ALG_NNSAZ VIR_STORAGE_VOL_WIPE_ALG_DODZ VIR_STORAGE_VOL_WIPE_ALG_BSIZ VIR_STORAGE_VOL_WIPE_ALG_GUTMANNZ!VIR_STORAGE_VOL_WIPE_ALG_SCHNEIERZ"VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7Z#VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33Z VIR_STORAGE_VOL_WIPE_ALG_RANDOMZ VIR_STORAGE_VOL_WIPE_ALG_TRIMZVIR_STORAGE_XML_INACTIVEZVIR_STREAM_EVENT_READABLEZVIR_STREAM_EVENT_WRITABLEZVIR_STREAM_EVENT_ERRORZVIR_STREAM_EVENT_HANGUPZVIR_STREAM_NONBLOCKru ZVIR_TYPED_PARAM_STRING_OKAYZVIR_TYPED_PARAM_INTZVIR_TYPED_PARAM_UINTZVIR_TYPED_PARAM_LLONGZVIR_TYPED_PARAM_ULLONGZVIR_TYPED_PARAM_DOUBLEZVIR_TYPED_PARAM_BOOLEANZVIR_TYPED_PARAM_STRINGZ VIR_VCPU_INFO_CPU_UNAVAILABLEZVIR_VCPU_INFO_CPU_OFFLINEZVIR_VCPU_OFFLINEZVIR_VCPU_RUNNINGZVIR_VCPU_BLOCKEDZ VIR_CONNECT_IDENTITY_GROUP_NAMEZ VIR_CONNECT_IDENTITY_PROCESS_IDZ!VIR_CONNECT_IDENTITY_PROCESS_TIMEZ#VIR_CONNECT_IDENTITY_SASL_USER_NAMEZ$VIR_CONNECT_IDENTITY_SELINUX_CONTEXTZ"VIR_CONNECT_IDENTITY_UNIX_GROUP_IDZ!VIR_CONNECT_IDENTITY_UNIX_USER_IDZ VIR_CONNECT_IDENTITY_USER_NAMEZ,VIR_CONNECT_IDENTITY_X509_DISTINGUISHED_NAMEZ VIR_DOMAIN_BANDWIDTH_IN_AVERAGEZ VIR_DOMAIN_BANDWIDTH_IN_BURSTZ VIR_DOMAIN_BANDWIDTH_IN_FLOORZ VIR_DOMAIN_BANDWIDTH_IN_PEAKZ VIR_DOMAIN_BANDWIDTH_OUT_AVERAGEZ VIR_DOMAIN_BANDWIDTH_OUT_BURSTZ VIR_DOMAIN_BANDWIDTH_OUT_PEAKZ VIR_DOMAIN_BLKIO_DEVICE_READ_BPSZ!VIR_DOMAIN_BLKIO_DEVICE_READ_IOPSZ VIR_DOMAIN_BLKIO_DEVICE_WEIGHTZ!VIR_DOMAIN_BLKIO_DEVICE_WRITE_BPSZ"VIR_DOMAIN_BLKIO_DEVICE_WRITE_IOPSZVIR_DOMAIN_BLKIO_WEIGHTZ VIR_DOMAIN_BLOCK_COPY_BANDWIDTHZ VIR_DOMAIN_BLOCK_COPY_BUF_SIZEZ!VIR_DOMAIN_BLOCK_COPY_GRANULARITYZ"VIR_DOMAIN_BLOCK_IOTUNE_GROUP_NAMEZ&VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SECZ*VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAXZ1VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX_LENGTHZ%VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SECZ)VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAXZ0VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX_LENGTHZ%VIR_DOMAIN_BLOCK_IOTUNE_SIZE_IOPS_SECZ'VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SECZ+VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAXZ2VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX_LENGTHZ&VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SECZ*VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAXZ1VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX_LENGTHZ'VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SECZ+VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAXZ2VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX_LENGTHZ&VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SECZ*VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAXZ1VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX_LENGTHZVIR_DOMAIN_BLOCK_STATS_ERRSZ VIR_DOMAIN_BLOCK_STATS_FLUSH_REQZ(VIR_DOMAIN_BLOCK_STATS_FLUSH_TOTAL_TIMESZ!VIR_DOMAIN_BLOCK_STATS_READ_BYTESZ VIR_DOMAIN_BLOCK_STATS_READ_REQZ'VIR_DOMAIN_BLOCK_STATS_READ_TOTAL_TIMESZ"VIR_DOMAIN_BLOCK_STATS_WRITE_BYTESZ VIR_DOMAIN_BLOCK_STATS_WRITE_REQZ(VIR_DOMAIN_BLOCK_STATS_WRITE_TOTAL_TIMESZ VIR_DOMAIN_CPU_STATS_CPUTIMEZ VIR_DOMAIN_CPU_STATS_SYSTEMTIMEZ VIR_DOMAIN_CPU_STATS_USERTIMEZ VIR_DOMAIN_CPU_STATS_VCPUTIMEZ VIR_DOMAIN_IOTHREAD_POLL_GROWZ VIR_DOMAIN_IOTHREAD_POLL_MAX_NSZ VIR_DOMAIN_IOTHREAD_POLL_SHRINKZ%VIR_DOMAIN_JOB_AUTO_CONVERGE_THROTTLEZ VIR_DOMAIN_JOB_COMPRESSION_BYTESZ VIR_DOMAIN_JOB_COMPRESSION_CACHEZ'VIR_DOMAIN_JOB_COMPRESSION_CACHE_MISSESZ#VIR_DOMAIN_JOB_COMPRESSION_OVERFLOWZ VIR_DOMAIN_JOB_COMPRESSION_PAGESZ VIR_DOMAIN_JOB_DATA_PROCESSEDZ VIR_DOMAIN_JOB_DATA_REMAININGZVIR_DOMAIN_JOB_DATA_TOTALZVIR_DOMAIN_JOB_DISK_BPSZ VIR_DOMAIN_JOB_DISK_PROCESSEDZ VIR_DOMAIN_JOB_DISK_REMAININGZ VIR_DOMAIN_JOB_DISK_TEMP_TOTALZ VIR_DOMAIN_JOB_DISK_TEMP_USEDZVIR_DOMAIN_JOB_DISK_TOTALZVIR_DOMAIN_JOB_DOWNTIMEZVIR_DOMAIN_JOB_DOWNTIME_NETZVIR_DOMAIN_JOB_ERRMSGZVIR_DOMAIN_JOB_MEMORY_BPSZ VIR_DOMAIN_JOB_MEMORY_CONSTANTZ VIR_DOMAIN_JOB_MEMORY_DIRTY_RATEZ VIR_DOMAIN_JOB_MEMORY_ITERATIONZ VIR_DOMAIN_JOB_MEMORY_NORMALZ"VIR_DOMAIN_JOB_MEMORY_NORMAL_BYTESZ VIR_DOMAIN_JOB_MEMORY_PAGE_SIZEZ#VIR_DOMAIN_JOB_MEMORY_POSTCOPY_REQSZ VIR_DOMAIN_JOB_MEMORY_PROCESSEDZ VIR_DOMAIN_JOB_MEMORY_REMAININGZVIR_DOMAIN_JOB_MEMORY_TOTALZVIR_DOMAIN_JOB_OPERATIONZVIR_DOMAIN_JOB_SETUP_TIMEZVIR_DOMAIN_JOB_SUCCESSZVIR_DOMAIN_JOB_TIME_ELAPSEDZ VIR_DOMAIN_JOB_TIME_ELAPSED_NETZ VIR_DOMAIN_JOB_TIME_REMAININGZ(VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MAJORZ(VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MINORZ'VIR_DOMAIN_LAUNCH_SECURITY_SEV_BUILD_IDZ*VIR_DOMAIN_LAUNCH_SECURITY_SEV_MEASUREMENTZ%VIR_DOMAIN_LAUNCH_SECURITY_SEV_POLICYZ%VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRETZ,VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_HEADERZ1VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_SET_ADDRESSZ VIR_DOMAIN_MEMORY_HARD_LIMITZ VIR_DOMAIN_MEMORY_MIN_GUARANTEEZ VIR_DOMAIN_MEMORY_SOFT_LIMITZ!VIR_DOMAIN_MEMORY_SWAP_HARD_LIMITZVIR_DOMAIN_NUMA_MODEZVIR_DOMAIN_NUMA_NODESETZVIR_DOMAIN_SCHEDULER_CAPZ VIR_DOMAIN_SCHEDULER_CPU_SHARESZ$VIR_DOMAIN_SCHEDULER_EMULATOR_PERIODZ#VIR_DOMAIN_SCHEDULER_EMULATOR_QUOTAZ"VIR_DOMAIN_SCHEDULER_GLOBAL_PERIODZ!VIR_DOMAIN_SCHEDULER_GLOBAL_QUOTAZ$VIR_DOMAIN_SCHEDULER_IOTHREAD_PERIODZ#VIR_DOMAIN_SCHEDULER_IOTHREAD_QUOTAZVIR_DOMAIN_SCHEDULER_LIMITZ VIR_DOMAIN_SCHEDULER_RESERVATIONZVIR_DOMAIN_SCHEDULER_SHARESZ VIR_DOMAIN_SCHEDULER_VCPU_PERIODZ VIR_DOMAIN_SCHEDULER_VCPU_QUOTAZVIR_DOMAIN_SCHEDULER_WEIGHTZ VIR_DOMAIN_TUNABLE_BLKDEV_DISKZ$VIR_DOMAIN_TUNABLE_BLKDEV_GROUP_NAMEZ(VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SECZ,VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC_MAXZ3VIR_DOMAIN_TUNABLE_BLKDEV_READ_BYTES_SEC_MAX_LENGTHZ'VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SECZ+VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC_MAXZ2VIR_DOMAIN_TUNABLE_BLKDEV_READ_IOPS_SEC_MAX_LENGTHZ'VIR_DOMAIN_TUNABLE_BLKDEV_SIZE_IOPS_SECZ)VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SECZ-VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC_MAXZ4VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_BYTES_SEC_MAX_LENGTHZ(VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SECZ,VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC_MAXZ3VIR_DOMAIN_TUNABLE_BLKDEV_TOTAL_IOPS_SEC_MAX_LENGTHZ)VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SECZ-VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC_MAXZ4VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_BYTES_SEC_MAX_LENGTHZ(VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SECZ,VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC_MAXZ3VIR_DOMAIN_TUNABLE_BLKDEV_WRITE_IOPS_SEC_MAX_LENGTHZ!VIR_DOMAIN_TUNABLE_CPU_CPU_SHARESZ"VIR_DOMAIN_TUNABLE_CPU_EMULATORPINZ&VIR_DOMAIN_TUNABLE_CPU_EMULATOR_PERIODZ%VIR_DOMAIN_TUNABLE_CPU_EMULATOR_QUOTAZ$VIR_DOMAIN_TUNABLE_CPU_GLOBAL_PERIODZ#VIR_DOMAIN_TUNABLE_CPU_GLOBAL_QUOTAZ#VIR_DOMAIN_TUNABLE_CPU_IOTHREADSPINZ&VIR_DOMAIN_TUNABLE_CPU_IOTHREAD_PERIODZ%VIR_DOMAIN_TUNABLE_CPU_IOTHREAD_QUOTAZ VIR_DOMAIN_TUNABLE_CPU_VCPUPINZ"VIR_DOMAIN_TUNABLE_CPU_VCPU_PERIODZ!VIR_DOMAIN_TUNABLE_CPU_VCPU_QUOTAZ)VIR_MIGRATE_PARAM_AUTO_CONVERGE_INCREMENTZ'VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIALZVIR_MIGRATE_PARAM_BANDWIDTHZ$VIR_MIGRATE_PARAM_BANDWIDTH_POSTCOPYZ VIR_MIGRATE_PARAM_COMPRESSIONZ)VIR_MIGRATE_PARAM_COMPRESSION_MT_DTHREADSZ&VIR_MIGRATE_PARAM_COMPRESSION_MT_LEVELZ(VIR_MIGRATE_PARAM_COMPRESSION_MT_THREADSZ*VIR_MIGRATE_PARAM_COMPRESSION_XBZRLE_CACHEZVIR_MIGRATE_PARAM_DEST_NAMEZVIR_MIGRATE_PARAM_DEST_XMLZ VIR_MIGRATE_PARAM_DISKS_PORTZVIR_MIGRATE_PARAM_DISKS_URIZ VIR_MIGRATE_PARAM_GRAPHICS_URIZ VIR_MIGRATE_PARAM_LISTEN_ADDRESSZ VIR_MIGRATE_PARAM_MIGRATE_DISKSZ&VIR_MIGRATE_PARAM_PARALLEL_CONNECTIONSZ VIR_MIGRATE_PARAM_PERSIST_XMLZ!VIR_MIGRATE_PARAM_TLS_DESTINATIONZVIR_MIGRATE_PARAM_URIZ%VIR_NETWORK_PORT_BANDWIDTH_IN_AVERAGEZ#VIR_NETWORK_PORT_BANDWIDTH_IN_BURSTZ#VIR_NETWORK_PORT_BANDWIDTH_IN_FLOORZ"VIR_NETWORK_PORT_BANDWIDTH_IN_PEAKZ&VIR_NETWORK_PORT_BANDWIDTH_OUT_AVERAGEZ$VIR_NETWORK_PORT_BANDWIDTH_OUT_BURSTZ#VIR_NETWORK_PORT_BANDWIDTH_OUT_PEAKZVIR_NODE_CPU_STATS_IDLEZVIR_NODE_CPU_STATS_INTRZVIR_NODE_CPU_STATS_IOWAITZVIR_NODE_CPU_STATS_KERNELZVIR_NODE_CPU_STATS_USERZ VIR_NODE_CPU_STATS_UTILIZATIONZ!VIR_NODE_MEMORY_SHARED_FULL_SCANSZ)VIR_NODE_MEMORY_SHARED_MERGE_ACROSS_NODESZ#VIR_NODE_MEMORY_SHARED_PAGES_SHAREDZ$VIR_NODE_MEMORY_SHARED_PAGES_SHARINGZ$VIR_NODE_MEMORY_SHARED_PAGES_TO_SCANZ%VIR_NODE_MEMORY_SHARED_PAGES_UNSHAREDZ%VIR_NODE_MEMORY_SHARED_PAGES_VOLATILEZ&VIR_NODE_MEMORY_SHARED_SLEEP_MILLISECSZ VIR_NODE_MEMORY_STATS_BUFFERSZ VIR_NODE_MEMORY_STATS_CACHEDZVIR_NODE_MEMORY_STATS_FREEZVIR_NODE_MEMORY_STATS_TOTALZVIR_NODE_SEV_CBITPOSZVIR_NODE_SEV_CERT_CHAINZVIR_NODE_SEV_MAX_ES_GUESTSZVIR_NODE_SEV_MAX_GUESTSZVIR_NODE_SEV_PDHZ VIR_NODE_SEV_REDUCED_PHYS_BITSZ VIR_PERF_PARAM_ALIGNMENT_FAULTSZ"VIR_PERF_PARAM_BRANCH_INSTRUCTIONSZ VIR_PERF_PARAM_BRANCH_MISSESZVIR_PERF_PARAM_BUS_CYCLESZVIR_PERF_PARAM_CACHE_MISSESZ VIR_PERF_PARAM_CACHE_REFERENCESZVIR_PERF_PARAM_CMTZ VIR_PERF_PARAM_CONTEXT_SWITCHESZVIR_PERF_PARAM_CPU_CLOCKZVIR_PERF_PARAM_CPU_CYCLESZ VIR_PERF_PARAM_CPU_MIGRATIONSZ VIR_PERF_PARAM_EMULATION_FAULTSZVIR_PERF_PARAM_INSTRUCTIONSZVIR_PERF_PARAM_MBMLZVIR_PERF_PARAM_MBMTZVIR_PERF_PARAM_PAGE_FAULTSZ VIR_PERF_PARAM_PAGE_FAULTS_MAJZ VIR_PERF_PARAM_PAGE_FAULTS_MINZ VIR_PERF_PARAM_REF_CPU_CYCLESZ%VIR_PERF_PARAM_STALLED_CYCLES_BACKENDZ&VIR_PERF_PARAM_STALLED_CYCLES_FRONTENDZVIR_PERF_PARAM_TASK_CLOCKr r r r �<module> s
( 0 @ && 0, 4 ARg x h , Ig?6 _q