Qh T'SSKrSSKJr SSKJ r J r J r J r J r JrJrJrJrJr \"S5r\ \\\\/S4r\ \\\\/\4r\ \\/S4r\ \/\4r\ \\/S4r\ \\\/\4r\ \\/S4r\ \/\4r\ SS\\\/\ \4r\ \\ 4r\ \\ 4r\ \\ 4r \ \\ 4r!"SS \"5r#S \ \\ /S4S \S \4S jr$GS\S\S\ S\S S4Sjjr%GS]S\ \S \4Sjjr&\GS]S\S\S\S\\\4SSS S4 Sjj5r'\GS]S\S\S\S\S\S S4 Sjj5r'GS]S\S\S\S\\\\4\4S\ \S S4 Sjjr'GS]S\S\\\\4\4S\ \S S4Sjjr(S\S\S\S\ \\ 4S \4 S jr)S\S\ \\ 4S \4S!jr*S\S\S"\S\S \4 S#jr+S$\S"\S\S \4S%jr,S\ S S4S&jr-GS]S'jr.GS]S(jr/S)r0S*r1S+r2S,r3S-r4S.r5S/r6S0r7S1r8S2r9S3r:S4r;S5r<"S6S\=5r>"S7S8\=5r?"S9S:\=5r@"S;S<\=5rA"S=S>\=5rB"S?S@\=5rC"SAS\=5rD"SBSC\=5rE"SDSE\=5rF"SFSG\=5rG"SHSI\=5rH"SJSK\=5rI"SLSM\=5rJ"SNSO\=5rKSPrLSQrMSRrNSSrOSTrPSUrQSVrRSrSSPrTSQrUSPrVSQrWSrXSPrYSQrZSRr[SPr\SQr]SPr^SQr_SRr`SSraSTrbSUrcSWrdSXreSYrfSrgSPrhSQriSPrjSQrkSrlSPrmSQrnSRroSrpSPrqSPrrSQrsSPrtSQruSSrvSXrwSZrxS[ryS\rzS]r{S^r|S_r}S`r~SPrSPrSQrSSrSXrSZrS[rS\rS]rSarSbrScrSdrSerSfrSgrShrSPrSQrSPrSQrSSrSXrSZrS[rSPrSQrSSrSXrSZrS[rS\rS]rSarSbrScrSdrSerSfrSgrShrSirSjrSkrSlrSmrSnrSorSprSqrS^rS_rS`rSPrSQrSSrSXrSPrSQrSSrSXrSZrS[rS\rS]rSarSbrScrSdrSerSfrSgrShrSirSjrSkrSlrSPrSrrSVrSrSPrSQrSPrSPrSQrSSrSXrSZrSPrSQrSSrSXrSPrSQrSPrSPrSrSPrSQrSRrSSrSTrS\rSPrSQrSSrSXrSZrS[rS\rSPrSQrSrSPrSPrSQrSSrSPrSQrSSrSPrSPrSQrSSrSXrSPrSQrSSrSPGrSQGrSGrSPGrSQGrSRGrSGrSPGrSQGrSRGr SPGr SQGr SSGr SXGr SZGrSGrSPGrSQGrSRGrSSGrSGrSPGrSGrSPGrSQGrSSGrSXGrSZGrS[GrSPGrSGrSPGrSQGr SGr!SPGr"SQGr#SSGr$SGr%SPGr&SQGr'SGr(SPGr)SQGr*SGr+SPGr,SQGr-SGr.SPGr/SGr0SPGr1SQGr2SRGr3SGr4SPGr5SQGr6SGr7SPGr8SQGr9SGr:SPGr;SQGrSTGr?SUGr@SWGrASXGrBSYGrCSsGrDStGrESuGrFSvGrGSwGrHSxGrISZGrJSyGrKSzGrLS{GrMS|GrNS}GrOS~GrPSGrQSGrRSGrSSGrTSGrUSGrVSPGrWSQGrXSGrYSPGrZSGr[SPGr\SQGr]SRGr^SSGr_SGr`SPGraSQGrbSGrcSPGrdSQGreSRGrfSSGrgSGrhSPGriSQGrjSRGrkSSGrlSTGrmSUGrnSGroSPGrpSQGrqSRGrrSSGrsSTGrtSUGruSWGrvSXGrwSGrxSPGrySGrzSPGr{SQGr|SRGr}SSGr~STGrSUGrSWGrSXGrSGrSPGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSPGrSQGrSPGrSQGrSPGrSQGrSGrSPGrSPGrSQGrSSGrSXGrSZGrS[GrS\GrS]GrSGrSPGrSQGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSsGrSGrSPGrSQGrSRGrSSGrSTGrSGrSPGrSQGrSGrSPGrSQGrSRGrSSGrSTGrSGrSPGrSQGrSRGrSPGrSQGrSGrSPGrSPGrSQGrSGrSPGrSQGrSSGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSsGrStGrSuGrSvGrSvGrSPGrSQGrSSGrSGrSPGrSQGrSPGrSQGrSSGrSXGrSZGrS[GrS\GrS]GrSaGrSbGrScGrSdGrSeGrSfGrSgGrShGrSiGrSjGrSkGrSlGrSmGrSPGrSGrSPGrSQGrSGrSGrSPGrSQGrSRGrSPGrSGrSGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSsGrStGrSuGr SvGr SwGr SGr SPGr SQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSsGrStGrSuGrSvGrSwGrSxGrSZGrSyGrSzGrS{GrS|Gr S}Gr!S~Gr"SGr#SGr$SGr%SGr&SGr'SGr(SGr)SGr*SGr+S[Gr,SGr-SGr.SGr/SGr0SGr1SGr2SGr3SGr4SGr5SGr6SGr7SGr8SGr9SGr:SGr;SGrSGr?SGr@SGrASGrBSGrCSGrDSGrESGrFSGrGSGrHSGrISGrJSGrKS\GrLSGrMSPGrNSQGrOSSGrPSXGrQSZGrRSGrSSPGrTSQGrUSRGrVSSGrWSTGrXSUGrYSWGrZSXGr[SYGr\SsGr]StGr^SPGr_SPGr`SQGraSSGrbSXGrcSPGrdSPGreSGrfSPGrgSQGrhSSGriSXGrjSZGrkSGrlSPGrmSGrnSPGroSQGrpSRGrqSSGrrSTGrsSUGrtSWGruSXGrvSPGrwSQGrxSSGrySXGrzSZGr{S[Gr|S\Gr}S]Gr~SaGrSbGrSPGrSQGrSSGrSPGrSPGrSQGrSSGrSXGrSZGrS[GrS\GrS]GrSaGrSbGrScGrSPGrSQGrSSGrSXGrSPGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSPGrSQGrSSGrSXGrSZGrS[GrS\GrS]GrSaGrSbGrScGrSPGrSQGrSSGrSXGrSZGrS[GrS\GrSGrSPGrSQGrSSGrSXGrSZGrSPGrSQGrSSGrSXGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSsGrStGrSuGrSvGrSwGrSxGrSZGrSyGrSzGrS{GrS|GrS}GrS~GrSGrSGrSGrSGrSGrSGrSGrSGrSGrS[GrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrSGrS\GrSGrSGrSGrSGrSGrSGrSGrSGrSGrSPGrSQGrSGrSPGrSQGrSRGrSSGr STGr SUGr SWGr SXGr SYGrSsGrStGrSuGrSvGrSwGrSxGrSZGrSyGrSzGrS{GrS|GrS}GrS~GrSGrSGrSGrSGrSGr SGr!SGr"SGr#SGr$S[Gr%SGr&SGr'SGr(SGr)SGr*SGr+SGr,SGr-SGr.SGr/SGr0SGr1SGr2SGr3SGr4SGr5SGr6SGr7SGr8SGr9SGr:SGr;SGrSGr?SGr@SGrASGrBSGrCSGrDS\GrESGrFSGrGSGrHSGrISGrJSGrKSGrLSGrMSGrNSGrOSGrPSGrQSGrRSGrSSGrTSGrUSGrVSGrWSGrXSGrYSGrZSGr[SGr\SGr]SGr^SGr_SGr`SGraSGrbSGrcSGrdSGreSGrfSGrgSGrhSGriSGrjSGrkSGrlSGrmSGrnSGroSGrpSGrqSGrrSGrsSGrtSGruSGrvSPGrwSQGrxSSGrySXGrzSGr{SPGr|SPGr}SPGr~SGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSPGrSQGrSRGrSSGrSTGrSUGrSPGrSPGrSPGrSPGrSGrSPGrSGrSPGrSQGrSRGrSGrSPGrSQGrSPGrSQGrSGrSPGrSQGrSRGrSSGrSGrSPGrSQGrSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSXGrSYGrSsGrStGrSuGrSPGrSGrSPGrSPGrSPGrSGrSPGrSGrSPGrSQGrSRGrSGrSPGrSQGrSPGrSVGrSVGrSGrSPGrSQGrSPGrSQGrSRGrSSGrSTGrSUGrSPGrSGrSPGrSGrSPGrSGrSPGrSQGrSRGrSSGrSTGrSGrSPGrSQGrSSGrSXGrSGrSPGrSQGrSSGrSPGrSGrSPGrSGrSPGrSGrSPGrSQGrSRGrSSGrSTGrSGrSPGrSQGrSRGrSSGrSPGrSQGrSSGrSGrSPGrSQGrSPGrSGrSPGrSPGrSQGrSSGrSGrSPGrSQGrSRGrSSGrSTGrSPGrSGrSPGrSQGrSRGrSSGrSTGr SUGr SWGr SXGr SYGr SPGrSPGrSQGrSSGrSXGrSPGrSPGrSSGrSPGrSQGrSRGrSSGrSTGrSUGrSWGrSrGrSVGrSGrSPGr SQGr!SGr"SGr#SGr$SGr%SGr&SGr'SGr(SGr)SGr*SGr+SGr,SGr-SGr.SGr/SGr0SGr1SGr2SGr3SGr4SGr5SGr6SGr7SGr8SGr9SGr:SGr;SGrSGr?SGr@SGrASGrBSGrCSGrDSGrESGrFSGrGSGrHSGrIGSGrJGSGrKGSGrLGSGrMGSGrNGSGrOGSGrPGSGrQGSGrRGS GrSGS GrTGS GrUGS GrVGS GrWGSGrXGSGrYGSGrZGSGr[GSGr\GSGr]GSGr^GSGr_GSGr`GSGraGSGrbGSGrcGSGrdGSGreGSGrfGSGrgGSGrhGSGriGSGrjGSGrkGS GrlGSGrmGS!GrnGS"GroGSGrpGS#GrqGS$GrrGS%GrsGS&GrtGS'GruGS(GrvGS)GrwGS*GrxGS+GryGS,GrzGS-Gr{GSGr|GS.Gr}GS/Gr~GS0GrGS1GrGS2GrGS3GrGS4GrGS5GrGS6GrGS7GrGS8GrGS9GrGS:GrGS;GrGSGrGS?GrGS@GrGSGrGSAGrGSBGrGSCGrGSDGrGSEGrGSFGrGSGGrGSHGrGSIGrGSJGrGSKGrGSLGrGSMGrGSNGrGSOGrGSPGrGSQGrGSRGrGSSGrGSTGrGSUGrGSVGrGSWGrGSXGrGSYGrGSZGrGS[GrGS\GrGS]GrGS^GrGS_GrGS`GrGSaGrGSbGrGScGrGSdGrGSeGrGSfGrGSgGrGShGrGSiGrGSjGrGSkGrGSlGrGSmGrGSnGrGSoGrGSpGrGSqGrGSrGrGSsGrGStGrGSuGrGSvGrGSwGrGSxGrGSyGrGSzGrGS{GrGS|GrGS}GrGS~GrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGr GSGr GSGr GSGr GSGr GSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGrGSGr GSGr!GSGr"GSGr#GSGr$GSGr%GSGr&GSGr'GSGr(GSGr)GSGr*GSGr+GSGr,GSGr-GSGr.GSGr/GSGr0GSGr1GSGr2GSGr3GSGr4GSGr5GSGr6GSGr7GSGr8GSGr9GSGr:GSGr;GSGrGSGr?GSGr@GSGrAGSGrBGSGrCGSGrDGSGrEGSGrFGSGrGGSGrHGSGrIGSGrJGSGrKGSGrLGSGrMGSGrNGSGrOGSGrPGSGrQGSGrRGSGrSGSGrTGSGrUGSGrVGSGrWGSGrXGSGrYGSGrZGSGr[GSGr\GSGr]GSGr^GSGr_GS Gr`GS GraGS GrbGS GrcGS GrdGSGreGSGrfGSGrgGSGrhGSGriGSGrjGSGrkGSGrlGSGrmGSGrnSGroGSGrpGSGrqGSGrrGSGrsGSGrtGSGruGSGrvGSGrwGS GrxGS!GryGS"GrzGS#Gr{GS$Gr|GS%Gr}GS&Gr~GS'GrGS(GrGS)GrGS*GrGS+GrGS,GrSGrSGrSGrSGrSGrSGrSGrGS-GrGS.GrGS/GrGS0GrGS1GrGS2GrGS3GrGS4GrGS5GrGS6GrGS7GrGS8GrGS9GrGS:GrGS;GrGSGrGS?GrGS@GrGSAGrGSBGrGSCGrGSDGrGSEGrGSFGrGSGGrGSHGrGSIGrGSJGrGSKGrGSLGrGSMGrGSNGrGSOGrGSPGrGSQGrGSRGrGSSGrGSTGrGSUGrGSVGrGSWGrGSXGrGSYGrGSZGrGS[Grg!\a6rSSKrSrCGNv!\arS\"\5;a\eSrCSrCGNSrCff=fSrCff=f(^NzNo module named) TracebackType) AnyCallableDictListOptionaloverloadTupleTypeTypeVarUnion_T virConnect virDomainc\rSrSrS\SS4SjrS\\4SjrS\\4Sjr S\\4Sjr S\\4S jr S\\4S jr S\\4S jr S\\4S jrS\\4S jrS\\4SjrSrg) libvirtError,defmsgreturnNcz[R"5nUcUnOUSn[RX5 X lgN) libvirtmodvirGetLastError Exception__init__err)selfrrmsgs )/usr/lib/python3/dist-packages/libvirt.pyrlibvirtError.__init__-s8((* ;Ca&C4%c<URcgURS$Nrrrs r get_error_codelibvirtError.get_error_code; 88 xx{r"c<URcgURS$)Nr%r&s r get_error_domainlibvirtError.get_error_domain@r)r"c<URcgURS$rr%r&s r get_error_messagelibvirtError.get_error_messageEr)r"c<URcgURS$)Nr%r&s r get_error_levellibvirtError.get_error_levelJr)r"c<URcgURS$)Nr%r&s r get_str1libvirtError.get_str1Or)r"c<URcgURS$)Nr%r&s r get_str2libvirtError.get_str2Tr)r"c<URcgURS$)Nr%r&s r get_str3libvirtError.get_str3Yr)r"c<URcgURS$)Nr%r&s r get_int1libvirtError.get_int1^r)r"c<URcgURS$)Nr%r&s r get_int2libvirtError.get_int2cr)r"r%)__name__ __module__ __qualname____firstlineno__strrrintr'r,r/r3r7r;r?rCrG__static_attributes__r"r rr,s s t   (3- 8C= # (3- (3- (3- (3- (3-r"rfctxrc.[R"X5$)zRegister 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.)rvirRegisterErrorHandler)rQrRs r registerErrorHandlerrUls  - -a 55r"uriauthflagsc^[R"XU5nUc [S5e[US9$)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. zvirConnectOpenAuth() failed_obj)rvirConnectOpenAuthrr)rVrWrXrets r openAuthr^ts2:  ' '5 9C {899 3 r"namecUc[R"5nO[R"U5nUc [S5eU$)aIf 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.zvirGetVersion() failed)r virGetVersionrr_r]s r getVersionrcs= |&&(&&t, {344 Jr"watchfdeventopaque opaquecompatcgNrPrdrerfrgrhs r _eventInvokeHandleCallbackrls BEr"cgrjrPrks r rlrlstwr"cU(aUnUnO![U[5(deUSnUSn[R"XX%U5 g)z, Invoke the Event Impl Handle Callback in C rr+N) isinstancetuplervirEventInvokeHandleCallback)rdrerfrgrhcallbackopaque_s r rlrlsH&%((((!9)++EuPr"timercU(aUnUnO![U[5(deUSnUSn[R"XU5 g)z- Invoke the Event Impl Timeout Callback in C rr+N)rorprvirEventInvokeTimeoutCallback)rtrgrhrrrss r _eventInvokeTimeoutCallbackrwsF&%((((!9),,UgFr"eventscbDatac*USnUSnU"XX%5 gNcbrgrrP)rdrerxryr|rgs r _dispatchEventHandleCallbackr}s" B H Fu&! r"c(USnUSnU"X5 gr{rP)rtryr|rgs r _dispatchEventTimeoutCallbackrs B H Fu r"r|c^X#S.n[R"XU5nUS:Xa [S5eU$)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 r|rgzvirEventAddHandle() failed)rvirEventAddHandler)rerxr|rgryr]s r rrs6 )F  & &r6 :C by788 Jr"timeoutc\XS.n[R"X5nUS:Xa [S5eU$)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 rrzvirEventAddTimeout() failed)rvirEventAddTimeoutr)rr|rgryr]s r rrs4 )F  ' ' 8C by899 Jr"c>[R"USUS5 g)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. rr+N)rvirEventInvokeFreeCallback)rgs r rrs ))&)VAY?r"c\[R"U5nUc [S5e[US9$)aAThis 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. zvirConnectOpen() failedrZ)rvirConnectOpenrrrbs r openr:s0&  # #D )C {455 3 r"c\[R"U5nUc [S5e[US9$)aThis 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 zvirConnectOpenReadOnly() failedrZ)rvirConnectOpenReadOnlyrrrbs r openReadOnlyrRs0  + +D 1C {<== 3 r"cR[R"5nUS:Xa [S5eU$)aRegisters 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(). rz$virEventRegisterDefaultImpl() failed)rvirEventRegisterDefaultImplrr]s r rrds*  0 0 2C byABB Jr"c4[R"XX#XE5 g)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)rvirEventRegisterImpl) addHandle updateHandle removeHandle addTimeout updateTimeout removeTimeouts r rrys:##I\Wdtr"cT[R"U5nUS:Xa [S5eU$)zUnregister a callback from a file handle. This function requires that an event loop has previously been registered with virEventRegisterImpl() or virEventRegisterDefaultImpl(). rzvirEventRemoveHandle() failed)rvirEventRemoveHandler)rdr]s r rrs,  ) )% 0C by:;; Jr"cT[R"U5nUS:Xa [S5eU$)zUnregister a callback for a timer. This function requires that an event loop has previously been registered with virEventRegisterImpl() or virEventRegisterDefaultImpl(). rzvirEventRemoveTimeout() failed)rvirEventRemoveTimeoutr)rtr]s r rrs,  * *5 1C by;<< Jr"cR[R"5nUS:Xa [S5eU$)aRun 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... } rzvirEventRunDefaultImpl() failed)rvirEventRunDefaultImplrrs r rrs*  + + -C by<== Jr"c0[R"X5 g)zChange 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)rvirEventUpdateHandle)rdrxs r rrs ##E2r"c0[R"X5 g)aJChange 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)rvirEventUpdateTimeout)rtrs r rrs$$U4r"c0[R"5nU$)zProvide 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. )rrrs r rrs  $ $ &C Jr"cR[R"5nUS:Xa [S5eU$)z6Get the most recent error code (enum virErrorNumber). rzvirGetLastErrorCode() failed)rvirGetLastErrorCoderrs r rrs(  ( ( *C by9:: Jr"cR[R"5nUS:Xa [S5eU$)z8Get the most recent error domain (enum virErrorDomain). rzvirGetLastErrorDomain() failed)rvirGetLastErrorDomainrrs r rrs(  * * ,C by;<< Jr"cL[R"5nUc [S5eU$)z"Get the most recent error message zvirGetLastErrorMessage() failed)rvirGetLastErrorMessagerrs r rrs&  + + -C {<== Jr"cR[R"5nUS:Xa [S5eU$)aInitialize 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. rzvirInitialize() failed)r virInitializerrs r rrs*  " " $C by344 Jr"c.[R"5 g)zReset 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)rvirResetLastErrorrPr"r rrs   "r"c \rSrSrSSjrSrSrSrSrSr S r S r SS jr S r SS jrSSjrSSjrSrSSjrSSjrSSjrSrSrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjr SS jr!SS!jr"SS"jr#SS#jr$S$r%SS%jr&SS&jr'SS'jr(SS(jr)SS)jr*SS*jr+S+r,SS,jr-SS-jr.SS.jr/S/r0SS0jr1S1r2SS2jr3SS3jr4SS4jr5SS5jr6SS6jr7SS7jr8SS8jr9SS9jr:SS:jr;SS;jrSS>jr?S?r@SS@jrASSAjrBSSBjrCSCrDSSDjrESErFSFrGSGrHSHrISSIjrJSSJjrKSSKjrLSSLjrMSSMjrNSSNjrOSOrPSPrQSSQjrRSSRjrSSSrTSSTjrUSSUjrVSSVjrWSSWjrXSSXjrYSSYjrZSSZjr[SS[jr\SS\jr]SS]jr^SS^jr_SS_jr`SS`jraSSajrbSSbjrcScrdSSdjreSSejrfSSfjrgSSgjrhSShjriSSijrjSSjjrkSSkjrlSSljrmSSmjrnSnroSSojrpSSpjrqSSqjrrSSrjrsSsrtSStjruSurvSSvjrwSSwjrxSxrySSyjrzSzr{SS{jr|S|r}S}r~SS~jrSSjrSrSrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSrSrSSjrSSjrSSjrSSjrSSjrSSjrSrSSjrSSjrSSjrSSjrSrSSjrSrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSrSrSSjrSSjrSSjrSrSSjrSS\S\S4SjjrSS\S\S4SjjrSS\\S\SS4SjjrSS\\S\S\4SjjrSS\\S\S\4SjjrSS\S\4SjjrSS\S\S\4SjjrSS\S\\S\S\4SjjrSrg)riNc|Xl[U5RS;a[S[U5-5eX lgN) PyCapsule PyCObjectz&Expected a wrapped C Object but got %s_conntyperIr_orconnr[s r rvirDomain.__init__4 :  &@ @DtDzQR Rr"clURb [R"UR5 SUlgrj)rr virDomainFreer&s r __del__virDomain.__del__% 77   $ $TWW -r"cUR$rjrr&s r connectvirDomain.connect" zzr"cB[R"UR5$z"Get C pointer to underlying object)rvirDomain_pointerrr&s r c_pointervirDomain.c_pointer%++DGG44r"cF[R"UR5nU$)z,Get the hypervisor ID number for the domain )rvirDomainGetIDrrr]s r ID virDomain.ID-s''0 r"cb[R"UR5nUc [S5eU$)z)Get the type of domain operation system. zvirDomainGetOSType() failed)rvirDomainGetOSTyperrrs r OSTypevirDomain.OSType2,++DGG4 ;<= = r"cb[R"UR5nUc [S5eU$)z0Extract the UUID unique Identifier of a domain. zvirDomainGetUUID() failed)rvirDomainGetUUIDrrrs r UUIDvirDomain.UUID=,))$''2 ;:; ; r"cb[R"UR5nUc [S5eU$)z4Fetch globally unique ID of the domain as a string. zvirDomainGetUUIDString() failed)rvirDomainGetUUIDStringrrrs r UUIDStringvirDomain.UUIDStringD,//8 ;@A A r"cd[R"URU5nUc [S5eU$)aYProvide 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. zvirDomainGetXMLDesc() failed)rvirDomainGetXMLDescrrrrXr]s r XMLDescvirDomain.XMLDescOs0,,,TWWe< ;=> > r"ch[R"UR5nUS:Xa [S5eU$)zRequests 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). rzvirDomainAbortJob() failed)rvirDomainAbortJobrrrs r abortJobvirDomain.abortJobj0 **4773 "9;< < r"cj[R"URU5nUS:Xa [S5eU$)aRequests that the current background job be aborted at the soonest opportunity. In case the job is a migration in a post-copy mode, this function will report an error unless VIR_DOMAIN_ABORT_JOB_POSTCOPY flag is used (see virDomainMigrateStartPostCopy for more details). rzvirDomainAbortJobFlags() failed)rvirDomainAbortJobFlagsrrrs r abortJobFlagsvirDomain.abortJobFlagsts2 //? "9@A A r"cj[R"URX5nUS:Xa [S5eU$)aDynamically 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. rzvirDomainAddIOThread() failed)rvirDomainAddIOThreadrrr iothread_idrXr]s r addIOThreadvirDomain.addIOThread~2$--dgg{J "9>? ? r"cj[R"URX5nUS:Xa [S5eU$)aSet 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 In all guest-agent based APIs when a timeout happens if an actual command was send to the guest agent the returned error code will be VIR_ERR_AGENT_COMMAND_TIMEOUT. rz)virDomainAgentSetResponseTimeout() failed)r virDomainAgentSetResponseTimeoutrr)rrrXr]s r agentSetResponseTimeout!virDomain.agentSetResponseTimeouts2 99$''7R "9JK K r"cj[R"URU5nUS:Xa [S5eU$)aCreate 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. rzvirDomainAttachDevice() failed)rvirDomainAttachDevicerrrxmlr]s r attachDevicevirDomain.attachDevices2..tww< "9?@ @ r"cj[R"URX5nUS:Xa [S5eU$)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. rz#virDomainAttachDeviceFlags() failed)rvirDomainAttachDeviceFlagsrrrrrXr]s r attachDeviceFlagsvirDomain.attachDeviceFlagss2(33DGGSH "9DE E r"cd[R"URX5nUc [S5eU$)zCFetch list of public SSH authorized keys for given user in domain. z&virDomainAuthorizedSSHKeysGet() failed)rvirDomainAuthorizedSSHKeysGetrr)ruserrXr]s r authorizedSSHKeysGetvirDomain.authorizedSSHKeysGets.66twwL ;GH H r"cl[R"URXU5nUS:Xa [S5eU$)zGManipulate set of public SSH authorized keys for given user in domain. rz&virDomainAuthorizedSSHKeysSet() failed)rvirDomainAuthorizedSSHKeysSetrr)rrkeysrXr]s r authorizedSSHKeysSetvirDomain.authorizedSSHKeysSets266twwER "9GH H r"ch[R"UR5nUS:Xa [S5eU$)z(Extract the autostart flag for a domain rzvirDomainGetAutostart() failed)rvirDomainGetAutostartrrrs r autostartvirDomain.autostart...tww7 "9?@ @ r"ch[R"UR5nUS:Xa [S5eU$)zProvides a boolean value indicating whether the domain is configured to be automatically started the next time the host machine boots only. rz"virDomainGetAutostartOnce() failed)rvirDomainGetAutostartOncerrrs r autostartOncevirDomain.autostartOnce.22477; "9CD D r"cl[R"URXU5nUS:Xa [S5eU$)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 , 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 https://libvirt.org/formatbackup.html#backup-xml 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. rzvirDomainBackupBegin() failed)rvirDomainBackupBeginrr)r backupXML checkpointXMLrXr]s r backupBeginvirDomain.backupBegins6p--dggyQVW "9>? ? r"cd[R"URU5nUc [S5eU$)a&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. z"virDomainBackupGetXMLDesc() failed)rvirDomainBackupGetXMLDescrrrs r backupGetXMLDescvirDomain.backupGetXMLDesc4s022477EB ;CD D r"cd[R"URU5nUc [S5eU$)zGet the blkio parameters z$virDomainGetBlkioParameters() failed)rvirDomainGetBlkioParametersrrrs r blkioParametersvirDomain.blkioParametersD.44TWWeD ;EF F r"cn[R"URXX4U5nUS:Xa [S5eU$)aBCommit 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 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 sub-element, such as "/path/to/image"), or the device target shorthand (the 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 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(). rzvirDomainBlockCommit() failed)rvirDomainBlockCommitrr)rdiskbasetop bandwidthrXr]s r blockCommitvirDomain.blockCommitOs8t--dggt3SXY "9>? ? r"cl[R"URXX45nUS:Xa [S5eU$)zSCopy the guest-visible contents of a disk image to a new file described by destxml rzvirDomainBlockCopy() failed)rvirDomainBlockCopyrr)rr)destxmlparamsrXr]s r blockCopyvirDomain.blockCopys2++DGGTFR "9<= = r"cd[R"URX5nUc [S5eU$)z5Extract information about a domain block device size zvirDomainGetBlockInfo() failed)rvirDomainGetBlockInforrrpathrXr]s r blockInfovirDomain.blockInfos...twwD ;?@ @ r"cd[R"URX5nUc [S5eU$)z(Get the I/O tunables for a block device z virDomainGetBlockIoTune() failed)rvirDomainGetBlockIoTunerrrr)rXr]s r blockIoTunevirDomain.blockIoTunes.00$F ;AB B r"cj[R"URX5nUS:Xa [S5eU$)aCancel the active block job on the given disk. The @disk parameter is either an unambiguous source name of the block device (the sub-element, such as "/path/to/image"), or (since 0.9.5) the device target shorthand (the 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. rzvirDomainBlockJobAbort() failed)rvirDomainBlockJobAbortrrr=s r blockJobAbortvirDomain.blockJobAborts3F//E "9@A A r"cd[R"URX5nUc [S5eU$)z)Get progress information for a block job z!virDomainGetBlockJobInfo() failed)rvirDomainGetBlockJobInforrr7s r blockJobInfovirDomain.blockJobInfo.11$''4G ;BC C r"cl[R"URXU5nUS:Xa [S5eU$)aSet 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 sub-element, such as "/path/to/image"), or (since 0.9.5) the device target shorthand (the sub-element, such as "vda"). Valid names can be found by calling virDomainGetXMLDesc() and inspecting elements within //domain/devices/disk. rz"virDomainBlockJobSetSpeed() failed)rvirDomainBlockJobSetSpeedrrrr)r,rXr]s r blockJobSetSpeedvirDomain.blockJobSetSpeeds4&22477DUS "9CD D r"cf[R"URXX45nUc [S5eU$)z*Read the contents of domain's disk device zvirDomainBlockPeek() failed)rvirDomainBlockPeekrr)rr)offsetsizerXr]s r blockPeekvirDomain.blockPeeks0++DGGT4O ;<= = r"cl[R"URXU5nUS:Xa [S5eU$)aPopulate 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 sub-element, such as "/path/to/image"), or (since 0.9.5) the device target shorthand (the 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. rzvirDomainBlockPull() failed)rvirDomainBlockPullrrrKs r blockPullvirDomain.blockPull)s5@++DGGTeL "9<= = r"cl[R"URXX45nUS:Xa [S5eU$)aPopulate 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 sub-element, such as "/path/to/image"), or the device target shorthand (the 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 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 , @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. rzvirDomainBlockRebase() failed)rvirDomainBlockRebaserr)rr)r*r,rXr]s r blockRebasevirDomain.blockRebaseNs5H--dggt9T "9>? ? r"cl[R"URXU5nUS:Xa [S5eU$)aResize 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. If @flag contains VIR_DOMAIN_BLOCK_RESIZE_CAPACITY (since 10.0.0) the hypervisor will resize the guest block device to fully fill the source. @size must be either set to zero, or to the exact size of the block device source. This is possible only for image formats with no metadata ('raw') and for source devices with limited capacity such as block devices. The @disk parameter is either an unambiguous source name of the block device (the sub-element, such as "/path/to/image"), or (since 0.9.5) the device target shorthand (the 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. rzvirDomainBlockResize() failed)rvirDomainBlockResizerr)rr)rQrXr]s r blockResizevirDomain.blockResizes40--dggt5I "9>? ? r"cd[R"URU5nUc [S5eU$)z.Extracts block device statistics for a domain zvirDomainBlockStats() failed)rvirDomainBlockStatsrrrr8r]s r blockStatsvirDomain.blockStatss.,,TWWd; ;=> > r"cd[R"URX5nUc [S5eU$)z@Extracts block device statistics parameters of a running domain z!virDomainBlockStatsFlags() failed)rvirDomainBlockStatsFlagsrrr7s r blockStatsFlagsvirDomain.blockStatsFlagsrHr"cv[R"URX5nUc [S5e[ XS9nU$)a Create a new checkpoint using @xmlDesc, with a top-level element, on a running @domain. Note that @xmlDesc must validate against the 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 https://libvirt.org/formatcheckpoint.html#checkpoint-xml 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. Note: A checkpoint represents point in time after which blocks changed by the hypervisor are tracked. The tracking of changed blocks notes only whether a block was modified, but does not preserve the old contents. The main purpose of checkpoints is to enable incremental backups. But for a checkpoint to be useful for this purpose, a backup must be performed at the same time as the checkpoint is created. This is done via the virDomainBackupBegin API, which also allows to create a checkpoint at the same time. Creating checkpoints with virDomainCheckpointCreateXML is generally only useful for re-creating the libvirt metadata. z%virDomainCheckpointCreateXML() failedrZ)rvirDomainCheckpointCreateXMLrrvirDomainCheckpointrxmlDescrXr]_virDomain__tmps r checkpointCreateXMLvirDomain.checkpointCreateXMLs;\55dggwN ;FG G#D3 r"cv[R"URX5nUc [S5e[ XS9nU$)z5Try to lookup a domain checkpoint based on its name. z(virDomainCheckpointLookupByName() failedrZ)rvirDomainCheckpointLookupByNamerrrkrr_rXr]rns r checkpointLookupByName virDomain.checkpointLookupByNames888$N ;IJ J#D3 r"cd[R"URU5nUc [S5eU$)zFExtract details about current state of control interface to a domain. z virDomainGetControlInfo() failed)rvirDomainGetControlInforrrs r controlInfovirDomain.controlInfo*.00%@ ;AB B r"cj[R"URX5nUS:Xa [S5eU$)aThis 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(). rzvirDomainCoreDump() failed)rvirDomainCoreDumprr)rtorXr]s r coreDumpvirDomain.coreDump5s2&**477B> "9;< < r"cl[R"URXU5nUS:Xa [S5eU$)aLThis 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. rz$virDomainCoreDumpWithFormat() failed)rvirDomainCoreDumpWithFormatrr)rr} dumpformatrXr]s r coreDumpWithFormatvirDomain.coreDumpWithFormatMs4*44TWWbeT "9EF F r"ch[R"UR5nUS:Xa [S5eU$)zLaunch 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(). rzvirDomainCreate() failed)rvirDomainCreaterrrs r createvirDomain.creategs0 ((1 "99: : r"cj[R"URU5nUS:Xa [S5eU$)aLaunch 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. If @flags includes VIR_DOMAIN_START_RESET_NVRAM, then libvirt will discard any existing NVRAM file and re-initialize NVRAM from the pristine template. rz!virDomainCreateWithFlags() failed)rvirDomainCreateWithFlagsrrrs r createWithFlagsvirDomain.createWithFlagsqs2>11$''5A "9BC C r"cj[R"URX5nUS:Xa [S5eU$)aDynamically 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. rzvirDomainDelIOThread() failed)rvirDomainDelIOThreadrrrs r delIOThreadvirDomain.delIOThreadrr"cj[R"URX5nUS:Xa [S5eU$)aDelete an throttlegroup from the domain. @group cannot be None, and the @group to be deleted must not have a throttlefilter associated with it and can be any of the current valid group. @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. rz"virDomainDelThrottleGroup() failed)rvirDomainDelThrottleGrouprr)rgrouprXr]s r delThrottleGroupvirDomain.delThrottleGroups222477EI "9CD D r"ch[R"UR5nUS:Xa [S5eU$)aYDestroy 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. rzvirDomainDestroy() failed)rvirDomainDestroyrrrs r destroyvirDomain.destroys0$))$''2 "9:; ; r"cj[R"URU5nUS:Xa [S5eU$)aODestroy 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. If VIR_DOMAIN_DESTROY_REMOVE_LOGS flag is set then domain specific logs will be deleted as well if there are any. Note that not all deployments are be supported. For example in case of QEMU driver this flags is noop if virtlogd is not used for handling QEMU process output. 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). rzvirDomainDestroyFlags() failed)rvirDomainDestroyFlagsrrrs r destroyFlagsvirDomain.destroyFlagss26..tww> "9?@ @ r"cj[R"URU5nUS:Xa [S5eU$)zThis is an equivalent of virDomainDetachDeviceFlags() when called with @flags parameter set to VIR_DOMAIN_AFFECT_LIVE. See virDomainDetachDeviceFlags() for more details. rzvirDomainDetachDevice() failed)rvirDomainDetachDevicerrrs r detachDevicevirDomain.detachDevices2 ..tww< "9?@ @ r"cj[R"URX5nUS:Xa [S5eU$)atDetach 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. rz#virDomainDetachDeviceAlias() failed)rvirDomainDetachDeviceAliasrr)raliasrXr]s r detachDeviceAliasvirDomain.detachDeviceAliass233DGGUJ "9DE E r"cj[R"URX5nUS:Xa [S5eU$)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. rz#virDomainDetachDeviceFlags() failed)rvirDomainDetachDeviceFlagsrrrs r detachDeviceFlagsvirDomain.detachDeviceFlagss3V33DGGSH "9DE E r"cd[R"URU5nUc [S5eU$)z Extract errors on disk devices. zvirDomainGetDiskErrors() failed)rvirDomainGetDiskErrorsrrrs r diskErrorsvirDomain.diskErrorsG.//? ;@A A r"cd[R"URU5nUc [S5eU$)zAQuery the CPU affinity setting of the emulator process of domain z$virDomainGetEmulatorPinInfo() failed)rvirDomainGetEmulatorPinInforrrs r emulatorPinInfovirDomain.emulatorPinInfoNr&r"cl[R"URXU5nUS:Xa [S5eU$)a 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. rzvirDomainFSTrim() failed)rvirDomainFSTrimrr)r mountPointminimumrXr]s r fSTrimvirDomain.fSTrimYs4((*uM "99: : r"cd[R"URU5nUc [S5eU$)zjGet a list of mapping information for each mounted file systems within the specified guest and the disks. zvirDomainGetFSInfo() failed)rvirDomainGetFSInforrrs r fsInfovirDomain.fsInfols.++DGGU; ;<= = r"cd[R"URX5nUc [S5eU$)aExtracts 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}] zvirDomainGetCPUStats() failed)rvirDomainGetCPUStatsrr)rtotalrXr]s r getCPUStatsvirDomain.getCPUStatsss0--dgguD ;>? ? r"cj[R"URX5nUS:Xa [S5eU$)zeReload domain's graphics. This can be used to reload TLS certificates without restarting the domain. rz virDomainGraphicsReload() failed)rvirDomainGraphicsReloadrr)rrrXr]s r graphicsReloadvirDomain.graphicsReloads200$F "9AB B r"cd[R"URX5nUc [S5eU$)z%Get aggregated info from guest agent zvirDomainGetGuestInfo() failed)rvirDomainGetGuestInforr)rtypesrXr]s r guestInfovirDomain.guestInfos...twwE ;?@ @ r"cj[R"URU5nUS:Xa [S5eU$)zBreturns a dictionary containing information regarding guest vcpus rzvirDomainGetGuestVcpus() failed)rvirDomainGetGuestVcpusrrrs r guestVcpusvirDomain.guestVcpuss0//? "9@A A r"cj[R"URU5nUS:Xa [S5eU$)z0Determine if the domain has a current snapshot. rz$virDomainHasCurrentSnapshot() failed)rvirDomainHasCurrentSnapshotrrrs r hasCurrentSnapshotvirDomain.hasCurrentSnapshot044TWWeD "9EF F r"cj[R"URU5nUS:Xa [S5eU$)zCheck 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. rz%virDomainHasManagedSaveImage() failed)rvirDomainHasManagedSaveImagerrrs r hasManagedSaveImagevirDomain.hasManagedSaveImages255dgguE "9FG G r"cd[R"URU5nUc [S5eU$)zGet 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. zvirDomainGetHostname() failed)rvirDomainGetHostnamerrrs r hostnamevirDomain.hostnames0 --dggu= ;>? ? r"cb[R"UR5nUc [S5eU$)zExtract 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. zvirDomainGetInfo() failed)rvirDomainGetInforrrs r infovirDomain.inforr"cj[R"URU5nUS:Xa [S5eU$)zSend NMI to the guest rzvirDomainInjectNMI() failed)rvirDomainInjectNMIrrrs r injectNMIvirDomain.injectNMIs0++DGGU; "9<= = r"cd[R"URX5nUc [S5eU$)zPreturns a dictionary of domain interfaces along with their MAC and IP addresses z$virDomainInterfaceAddresses() failed)rvirDomainInterfaceAddressesrr)rsourcerXr]s r interfaceAddressesvirDomain.interfaceAddressess.44TWWfL ;EF F r"cd[R"URX5nUc [S5eU$)z2Get the bandwidth tunables for a interface device z(virDomainGetInterfaceParameters() failed)rvirDomainGetInterfaceParametersrr)rdevicerXr]s r interfaceParametersvirDomain.interfaceParameterss.88&P ;IJ J r"cd[R"URU5nUc [S5eU$)z2Extracts interface device statistics for a domain z virDomainInterfaceStats() failed)rvirDomainInterfaceStatsrrrbs r interfaceStatsvirDomain.interfaceStatss.00$? ;AB B r"cd[R"URU5nUc [S5eU$)z>Query the CPU affinity setting of the IOThreads of the domain z!virDomainGetIOThreadInfo() failed)rvirDomainGetIOThreadInforrrs r ioThreadInfovirDomain.ioThreadInfos.11$''5A ;BC C r"ch[R"UR5nUS:Xa [S5eU$)z-Determine if the domain is currently running rzvirDomainIsActive() failed)rvirDomainIsActiverrrs r isActivevirDomain.isActives.**4773 "9;< < r"ch[R"UR5nUS:Xa [S5eU$)zkDetermine if the domain has a persistent configuration which means it will still exist after shutting down rzvirDomainIsPersistent() failed)rvirDomainIsPersistentrrrs r isPersistentvirDomain.isPersistents0..tww7 "9?@ @ r"ch[R"UR5nUS:Xa [S5eU$)z*Determine if the domain has been updated. rzvirDomainIsUpdated() failed)rvirDomainIsUpdatedrrrs r isUpdatedvirDomain.isUpdated .++DGG4 "9<= = r"cb[R"UR5nUc [S5eU$)FExtract information about an active job being processed for a domain. zvirDomainGetJobInfo() failed)rvirDomainGetJobInforrrs r jobInfovirDomain.jobInfos,,,TWW5 ;=> > r"cd[R"URU5nUc [S5eU$)rzvirDomainGetJobStats() failed)rvirDomainGetJobStatsrrrs r jobStatsvirDomain.jobStats.--dggu= ;>? ? r"cd[R"URU5nUc [S5eU$)z&Get launch security info for a domain z'virDomainGetLaunchSecurityInfo() failed)rvirDomainGetLaunchSecurityInforrrs r launchSecurityInfovirDomain.launchSecurityInfo#s.77G ;HI I r"cj[R"URU5nUS:Xa [S5eU$)axThis 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. rzvirDomainManagedSave() failed)rvirDomainManagedSaverrrs r managedSavevirDomain.managedSave.s2,--dggu= "9>? ? r"cj[R"URX5nUS:Xa [S5eU$)aqThis 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. rz&virDomainManagedSaveDefineXML() failed)rvirDomainManagedSaveDefineXMLrr)rdxmlrXr]s r managedSaveDefineXMLvirDomain.managedSaveDefineXMLIs266twwL "9GH H r"cd[R"URU5nUc [S5eU$)zThis 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. z'virDomainManagedSaveGetXMLDesc() failed)rvirDomainManagedSaveGetXMLDescrrrs r managedSaveGetXMLDescvirDomain.managedSaveGetXMLDesc]s077G ;HI I r"cj[R"URU5nUS:Xa [S5eU$)z/Remove any managed save image for this domain. rz#virDomainManagedSaveRemove() failed)rvirDomainManagedSaveRemoverrrs r managedSaveRemovevirDomain.managedSaveRemoveis033DGGUC "9DE E r"ch[R"UR5nUS:Xa [S5eU$)zRetrieve 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. rzvirDomainGetMaxMemory() failed)rvirDomainGetMaxMemoryrrrs r maxMemoryvirDomain.maxMemoryps0..tww7 !8?@ @ r"ch[R"UR5nUS:Xa [S5eU$)a2Provides 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(). rzvirDomainGetMaxVcpus() failed)rvirDomainGetMaxVcpusrrrs r maxVcpusvirDomain.maxVcpusys0 --dgg6 "9>? ? r"cd[R"URU5nUc [S5eU$)zGet the memory parameters z%virDomainGetMemoryParameters() failed)rvirDomainGetMemoryParametersrrrs r memoryParametersvirDomain.memoryParameterss.55dgguE ;FG G r"cf[R"URXU5nUc [S5eU$)z%Read the contents of domain's memory zvirDomainMemoryPeek() failed)rvirDomainMemoryPeekrr)rstartrQrXr]s r memoryPeekvirDomain.memoryPeeks0,,TWWe5I ;=> > r"cb[R"UR5nUc [S5eU$)z(Extracts memory statistics for a domain zvirDomainMemoryStats() failed)rvirDomainMemoryStatsrrrs r memoryStatsvirDomain.memoryStats,--dgg6 ;>? ? r"cd[R"URU5nUc [S5eU$)z0Fetch list of messages reported against domain. zvirDomainGetMessages() failed)rvirDomainGetMessagesrrrs r messagesvirDomain.messagesr r"cf[R"URXU5nUc [S5eU$)aRetrieves 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. zvirDomainGetMetadata() failed)rvirDomainGetMetadatarrrrrVrXr]s r metadatavirDomain.metadatas2--dggt%H ;>? ? r"cUcSnO URn[R"URXbX4U5nUc [S5e[ UR US9nU$)aMigrate 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() failedrZ)rrvirDomainMigraterrr) rdconnrXdnamerVr,dconn__or]rns r migratevirDomain.migratesX =HxxH))$''8EPYZ ;:; ;$**3/ r"c UcSnO URn[R"URXrX4XV5nUc [S5e[ UR US9n U $)aMigrate 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() failedrZ)rrvirDomainMigrate2rrr) rrDrrXrErVr,rFr]rns r migrate2virDomain.migrate2sX =HxxH**477HERUa ;;< <$**3/ r"cUcSnO URn[R"URXBU5nUc [S5e[ UR US9nU$)zMigrate the domain object from its current host to the destination host given by dconn (a connection to the destination host). NzvirDomainMigrate3() failedrZ)rrvirDomainMigrate3rrr)rrDr2rXrFr]rns r migrate3virDomain.migrate3sU =HxxH**477HeL ;;< <$**3/ r"cH[R"URU5nU$)zyGet current size of the cache (in bytes) used for compressing repeatedly transferred memory pages during live migration. )r#virDomainMigrateGetCompressionCacherrs r migrateGetCompressionCache$virDomain.migrateGetCompressionCaches<Get currently configured maximum migration speed for a domain rz$virDomainMigrateGetMaxSpeed() failed)rvirDomainMigrateGetMaxSpeedrrrs r migrateGetMaxSpeedvirDomain.migrateGetMaxSpeedrr"cj[R"URX5nUS:Xa [S5eU$)a/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. rz,virDomainMigrateSetCompressionCache() failed)r#virDomainMigrateSetCompressionCacherr)r cacheSizerXr]s r migrateSetCompressionCache$virDomain.migrateSetCompressionCache s2 <? ? r"cUcSnO URn[R"URXU5nUS:Xa [S5eU$)aThis 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. NrzvirDomainOpenConsole() failed)rrvirDomainOpenConsoler)rdev_namerrXrr]s r openConsolevirDomain.openConsolesG* :EEEE--dggxN "9>? ? r"cl[R"URXU5nUS:Xa [S5eU$)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 rzvirDomainOpenGraphics() failed)rvirDomainOpenGraphicsrr)ridxrerXr]s r openGraphicsvirDomain.openGraphicss4..twwG "9?@ @ r"cj[R"URX5nUS:Xa [S5eU$)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. rz virDomainOpenGraphicsFD() failed)rvirDomainOpenGraphicsFDrr)rrrXr]s r openGraphicsFDvirDomain.openGraphicsFD s200#E "9AB B r"cl[R"URXU5nUS:Xa [S5eU$)aAttempt 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. rz&virDomainPMSuspendForDuration() failed)rvirDomainPMSuspendForDurationrrrtargetdurationrXr]s r pMSuspendForDurationvirDomain.pMSuspendForDuration! s5 66twwRWX "9GH H r"cj[R"URU5nUS:Xa [S5eU$)zInject a wakeup into the guest that previously used virDomainPMSuspendForDuration, rather than waiting for the previously requested duration (if any) to elapse. rzvirDomainPMWakeup() failed)rvirDomainPMWakeuprrrs r pMWakeupvirDomain.pMWakeup6 s2**477E: "9;< < r"cd[R"URU5nUc [S5eU$)zGet all perf events setting. zvirDomainGetPerfEvents() failed)rvirDomainGetPerfEventsrrrs r perfEventsvirDomain.perfEventsC rr"cj[R"URX5nUS:Xa [S5eU$)zDynamically change the real CPUs which can be allocated to the emulator process of a domain. This function requires privileged access to the hypervisor. rzvirDomainPinEmulator() failed)rvirDomainPinEmulatorrr)rcpumaprXr]s r pinEmulatorvirDomain.pinEmulatorJ s2--dggvE "9>? ? r"cl[R"URXU5nUS:Xa [S5eU$)zDynamically change the real CPUs which can be allocated to an IOThread. This function requires privileged access to the hypervisor. rzvirDomainPinIOThread() failed)rvirDomainPinIOThreadrr)r iothread_valrrXr]s r pinIOThreadvirDomain.pinIOThreadR s2--dgg|US "9>? ? r"cj[R"URX5nUS:Xa [S5eU$)Dynamically change the real CPUs which can be allocated to a virtual CPU. This function requires privileged access to the hypervisor. rzvirDomainPinVcpu() failed)rvirDomainPinVcpurr)rvcpurr]s r pinVcpuvirDomain.pinVcpuY s0))$''4@ "9:; ; r"cl[R"URXU5nUS:Xa [S5eU$)rrzvirDomainPinVcpuFlags() failed)rvirDomainPinVcpuFlagsrr)rrrrXr]s r pinVcpuFlagsvirDomain.pinVcpuFlags` s2..twweL "9?@ @ r"cj[R"URU5nUS:Xa [S5eU$)aReboot 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 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. rzvirDomainReboot() failed)rvirDomainRebootrrrs r rebootvirDomain.rebootk s2*((%8 "99: : r"cj[R"URX5nUS:Xa [S5eU$)aRename 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. rzvirDomainRename() failed)rvirDomainRenamerr)rnew_namerXr]s r renamevirDomain.rename s2(((B "99: : r"cj[R"URU5nUS:Xa [S5eU$)aReset 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. rzvirDomainReset() failed)rvirDomainResetrrrs r resetvirDomain.reset s2''7 "989 9 r"ch[R"UR5nUS:Xa [S5eU$)aResume 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. rzvirDomainResume() failed)rvirDomainResumerrrs r resumevirDomain.resume s0 ((1 "99: : r"cUcSnO URn[R"URX25nUS:Xa [S5eU$)z(revert the domain to the given snapshot Nrz"virDomainRevertToSnapshot() failed)rrvirDomainRevertToSnapshotr)rsnaprXsnap__or]s r revertToSnapshotvirDomain.revertToSnapshot sC <GggG22477GK "9CD D r"cj[R"URU5nUS:Xa [S5eU$)aThis method will suspend a domain and save its memory contents to a file or direcotry (based on the vmm) 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() and virDomainSaveParams() for more control. Also, a save file can be inspected or modified slightly with virDomainSaveImageGetXMLDesc() and virDomainSaveImageDefineXML(). rzvirDomainSave() failed)r virDomainSaverr)rr}r]s r savevirDomain.save s2&&tww3 "978 8 r"cl[R"URXU5nUS:Xa [S5eU$)aThis 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. rzvirDomainSaveFlags() failed)rvirDomainSaveFlagsrr)rr}rrXr]s r saveFlagsvirDomain.saveFlags s4<++DGGRuE "9<= = r"cj[R"URX5nUS:Xa [S5eU$)zRThis method will suspend a domain and save its memory contents to a file on disk. rzvirDomainSaveParams() failed)rvirDomainSaveParamsrrrr2rXr]s r saveParamsvirDomain.saveParams s0,,TWWfD "9=> > r"cb[R"UR5nUc [S5eU$)zPGet the scheduler parameters, the @params array will be filled with the values. z(virDomainGetSchedulerParameters() failed)rvirDomainGetSchedulerParametersrrrs r schedulerParametersvirDomain.schedulerParameters ,88A ;IJ J r"cd[R"URU5nUc [S5eU$)zGet the scheduler parameters z-virDomainGetSchedulerParametersFlags() failed)r$virDomainGetSchedulerParametersFlagsrrrs r schedulerParametersFlags"virDomain.schedulerParametersFlags s.==dgguM ;NO O r"cb[R"UR5nUc [S5eU$)zGet the scheduler type. z"virDomainGetSchedulerType() failed)rvirDomainGetSchedulerTyperrrs r schedulerTypevirDomain.schedulerType ,22477; ;CD D r"cUcSnO URn[R"URXBU5nUc [S5eU$)alTake 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. NzvirDomainScreenshot() failed)rrvirDomainScreenshotr)rstreamscreenrX stream__or]s r screenshotvirDomain.screenshot sE >I I,,TWWiO ;=> > r"cb[R"UR5nUc [S5eU$)z\Extract information about the domain security label. Only the first label will be returned. z"virDomainGetSecurityLabel() failed)rvirDomainGetSecurityLabelrrrs r securityLabelvirDomain.securityLabel, rr"cb[R"UR5nUc [S5eU$)z\Extract information about the domain security label. A list of all labels will be returned. z&virDomainGetSecurityLabelList() failed)rvirDomainGetSecurityLabelListrrrs r securityLabelListvirDomain.securityLabelList3 ,66tww? ;GH H r"cn[R"URXX4U5nUS:Xa [S5eU$)zSend key(s) to the guest. rzvirDomainSendKey() failed)rvirDomainSendKeyrr)rcodesetholdtimekeycodes nkeycodesrXr]s r sendKeyvirDomain.sendKey> s5))$''7h[`a "9:; ; r"cl[R"URXU5nUS:Xa [S5eU$)aSend 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. rz#virDomainSendProcessSignal() failed)rvirDomainSendProcessSignalrr)r pid_valuesignumrXr]s r sendProcessSignalvirDomain.sendProcessSignalE s5033DGGYPUV "9DE E r"cj[R"URU5nUS:Xa [S5eU$)zNConfigure the domain to be automatically started when the host machine boots. rzvirDomainSetAutostart() failed)rvirDomainSetAutostartrrrrr]s r setAutostartvirDomain.setAutostartb s2..tww B "9?@ @ r"cj[R"URU5nUS:Xa [S5eU$)z\Configure the domain to be automatically started the next time the host machine boots only. rz"virDomainSetAutostartOnce() failed)rvirDomainSetAutostartOncerrrs r setAutostartOncevirDomain.setAutostartOncej 222477IF "9CD D r"cj[R"URX5nUS:Xa [S5eU$)zChange the blkio tunables rz$virDomainSetBlkioParameters() failed)rvirDomainSetBlkioParametersrrrs r setBlkioParametersvirDomain.setBlkioParametersv 044TWWfL "9EF F r"cl[R"URXU5nUS:Xa [S5eU$)z+Change the I/O tunables for a block device rz virDomainSetBlockIoTune() failed)rvirDomainSetBlockIoTunerr)rr)r2rXr]s r setBlockIoTunevirDomain.setBlockIoTune} s200$N "9AB B r"cl[R"URXU5nUS:Xa [S5eU$)aSet 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..allocation" in the VIR_DOMAIN_STATS_BLOCK group. The current threshold value is reported as "block..threshold". This event allows to use thin-provisioned storage which needs management tools to grow it without the need for polling of the data. rz#virDomainSetBlockThreshold() failed)rvirDomainSetBlockThresholdrr)rdev thresholdrXr]s r setBlockThresholdvirDomain.setBlockThreshold s4>33DGGSUS "9DE E r"cl[R"URXU5nUS:Xa [S5eU$)aSets 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. rzvirDomainSetGuestVcpus() failed)rvirDomainSetGuestVcpusrr)rrstaterXr]s r setGuestVcpusvirDomain.setGuestVcpus s4//N "9@A A r"cl[R"URXU5nUS:Xa [S5eU$)zDynamically allow changing the IOThread polling related parameters. This function requires privileged access to the hypervisor. rz#virDomainSetIOThreadParams() failed)rvirDomainSetIOThreadParamsrr)rrr2rXr]s r setIOThreadParamsvirDomain.setIOThreadParams s333DGG\SXY "9DE E r"cl[R"URXU5nUS:Xa [S5eU$)z5Change the bandwidth tunables for a interface device rz(virDomainSetInterfaceParameters() failed)rvirDomainSetInterfaceParametersrr)rrr2rXr]s r setInterfaceParameters virDomain.setInterfaceParameters s388&RWX "9IJ J r"cj[R"URX5nUS:Xa [S5eU$)z4Set a launch security secret in the guest's memory. rz(virDomainSetLaunchSecurityState() failed)rvirDomainSetLaunchSecurityStaterrrs r setLaunchSecurityState virDomain.setLaunchSecurityState s088&P "9IJ J r"cl[R"URXU5nUS:Xa [S5eU$)aChanges the actions of lifecycle events for domain represented as $action 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. rz$virDomainSetLifecycleAction() failed)rvirDomainSetLifecycleActionrr)rractionrXr]s r setLifecycleActionvirDomain.setLifecycleAction s444TWWdER "9EF F r"cj[R"URU5nUS:Xa [S5eU$)aDynamically 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(). rzvirDomainSetMaxMemory() failed)rvirDomainSetMaxMemoryrrrmemoryr]s r setMaxMemoryvirDomain.setMaxMemory s2..tww? "9?@ @ r"cj[R"URU5nUS:Xa [S5eU$)aDynamically 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(). rzvirDomainSetMemory() failed)rvirDomainSetMemoryrrr>s r setMemoryvirDomain.setMemory s2++DGGV< "9<= = r"cj[R"URX5nUS:Xa [S5eU$)aDynamically 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. rz virDomainSetMemoryFlags() failed)rvirDomainSetMemoryFlagsrr)rr?rXr]s r setMemoryFlagsvirDomain.setMemoryFlags s2"00&H "9AB B r"cj[R"URX5nUS:Xa [S5eU$)zChange the memory tunables rz%virDomainSetMemoryParameters() failed)rvirDomainSetMemoryParametersrrrs r setMemoryParametersvirDomain.setMemoryParameters s055dggvM "9FG G r"cj[R"URX5nUS:Xa [S5eU$)aDynamically 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. rz&virDomainSetMemoryStatsPeriod() failed)rvirDomainSetMemoryStatsPeriodrr)rperiodrXr]s r setMemoryStatsPeriodvirDomain.setMemoryStatsPeriod* s266twwN "9GH H r"cn[R"URXX4U5nUS:Xa [S5eU$)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. rzvirDomainSetMetadata() failed)rvirDomainSetMetadatarrrrr@keyrVrXr]s r setMetadatavirDomain.setMetadata= s7&--dggtsQVW "9>? ? r"cj[R"URX5nUS:Xa [S5eU$)zChange the NUMA tunables rz#virDomainSetNumaParameters() failed)rvirDomainSetNumaParametersrrrs r setNumaParametersvirDomain.setNumaParametersY 033DGGVK "9DE E r"cj[R"URX5nUS:Xa [S5eU$)z5Enable or disable the particular list of perf events rzvirDomainSetPerfEvents() failed)rvirDomainSetPerfEventsrrrs r setPerfEventsvirDomain.setPerfEvents` 0//G "9@A A r"cj[R"URU5nUS:Xa [S5eU$) Change the scheduler parameters rz(virDomainSetSchedulerParameters() failed)rvirDomainSetSchedulerParametersrr)rr2r]s r setSchedulerParameters virDomain.setSchedulerParametersg s088&I "9IJ J r"cj[R"URX5nUS:Xa [S5eU$)rdrz-virDomainSetSchedulerParametersFlags() failed)r$virDomainSetSchedulerParametersFlagsrrrs r setSchedulerParametersFlags%virDomain.setSchedulerParametersFlagsn s0==dggvU "9NO O r"cl[R"URXU5nUS:Xa [S5eU$)zUAdd throttlegroup or change all of the throttlegroup options within specific domain. rz"virDomainSetThrottleGroup() failed)rvirDomainSetThrottleGrouprr)rrr2rXr]s r setThrottleGroupvirDomain.setThrottleGroupu s222477E5Q "9CD D r"cl[R"URXU5nUS:Xa [S5eU$)a;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. rz!virDomainSetUserPassword() failed)rvirDomainSetUserPasswordrr)rrpasswordrXr]s r setUserPasswordvirDomain.setUserPassword s411$''45Q "9BC C r"cl[R"URXU5nUS:Xa [S5eU$)aEnables/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. rzvirDomainSetVcpu() failed)rvirDomainSetVcpurr)rvcpumapr(rXr]s r setVcpuvirDomain.setVcpu s4))$''75I "9:; ; r"cj[R"URU5nUS:Xa [S5eU$)aqDynamically 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(). rzvirDomainSetVcpus() failed)rvirDomainSetVcpusrr)rnvcpusr]s r setVcpusvirDomain.setVcpus s2**477F; "9;< < r"cj[R"URX5nUS:Xa [S5eU$)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. @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. rzvirDomainSetVcpusFlags() failed)rvirDomainSetVcpusFlagsrr)rr|rXr]s r setVcpusFlagsvirDomain.setVcpusFlags s3@//G "9@A A r"ch[R"UR5nUS:Xa [S5eU$)a 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. rzvirDomainShutdown() failed)rvirDomainShutdownrrrs r shutdownvirDomain.shutdown s0**4773 "9;< < r"cj[R"URU5nUS:Xa [S5eU$)aShutdown 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 configured. rzvirDomainShutdownFlags() failed)rvirDomainShutdownFlagsrrrs r shutdownFlagsvirDomain.shutdownFlags s2.//? "9@A A r"cv[R"URX5nUc [S5e[ XS9nU$)aCreates a new snapshot of a domain based on the snapshot xml contained in xmlDesc, with a top-level element . 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 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. z#virDomainSnapshotCreateXML() failedrZ)rvirDomainSnapshotCreateXMLrrvirDomainSnapshotrls r snapshotCreateXMLvirDomain.snapshotCreateXML s;\33DGGWL ;DE E!$1 r"cv[R"URU5nUc [S5e[ XS9nU$)zGet the current snapshot for a domain, if any. virDomainSnapshotFree should be used to free the resources after the snapshot object is no longer needed. z!virDomainSnapshotCurrent() failedrZ)rvirDomainSnapshotCurrentrrr)rrXr]rns r snapshotCurrentvirDomain.snapshotCurrentv s: 11$''5A ;BC C!$1 r"cd[R"URU5nUc [S5eU$)z8collect the list of snapshot names for the given domain z#virDomainSnapshotListNames() failed)rvirDomainSnapshotListNamesrrrs r snapshotListNamesvirDomain.snapshotListNames rr"cv[R"URX5nUc [S5e[ XS9nU$)z3Try to lookup a domain snapshot based on its name. z&virDomainSnapshotLookupByName() failedrZ)rvirDomainSnapshotLookupByNamerrrrss r snapshotLookupByNamevirDomain.snapshotLookupByName s866twwL ;GH H!$1 r"cj[R"URU5nUS:Xa [S5eU$)aProvides 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(). rzvirDomainSnapshotNum() failed)rvirDomainSnapshotNumrrrs r snapshotNumvirDomain.snapshotNum s2--dggu= "9>? ? r"cj[R"URX5nUS:Xa [S5eU$)zCalculate the current domain's memory dirty rate in next @seconds. The calculated dirty rate information is available by calling virConnectGetAllDomainStats. rz$virDomainStartDirtyRateCalc() failed)rvirDomainStartDirtyRateCalcrr)rsecondsrXr]s r startDirtyRateCalcvirDomain.startDirtyRateCalc s244TWWgM "9EF F r"cd[R"URU5nUc [S5eU$)zExtract domain state. zvirDomainGetState() failed)rvirDomainGetStaterrrs r r(virDomain.state .**477E: ;;< < r"ch[R"UR5nUS:Xa [S5eU$)atSuspends 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. rzvirDomainSuspend() failed)rvirDomainSuspendrrrs r suspendvirDomain.suspend s0))$''2 "9:; ; r"ch[R"UR5nUS:Xa [S5eU$)aUndefine 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. rzvirDomainUndefine() failed)rvirDomainUndefinerrrs r undefinevirDomain.undefine s0**4773 "9;< < r"cj[R"URU5nUS:Xa [S5eU$)acUndefine 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. rzvirDomainUndefineFlags() failed)rvirDomainUndefineFlagsrrrs r undefineFlagsvirDomain.undefineFlags s3@//? "9@A A r"cj[R"URX5nUS:Xa [S5eU$)aChange 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. rz#virDomainUpdateDeviceFlags() failed)rvirDomainUpdateDeviceFlagsrrrs r updateDeviceFlagsvirDomain.updateDeviceFlags s2033DGGSH "9DE E r"cd[R"URU5nUc [S5eU$)z=Query the CPU affinity setting of all virtual CPUs of domain z virDomainGetVcpuPinInfo() failed)rvirDomainGetVcpuPinInforrrs r vcpuPinInfovirDomain.vcpuPinInfo' rzr"cb[R"UR5nUc [S5eU$)z^Extract information about virtual CPUs of domain, store it in info array and also in cpumaps. zvirDomainGetVcpus() failed)rvirDomainGetVcpusrrrs r vcpusvirDomain.vcpus. ,**4773 ;;< < r"cj[R"URU5nUS:Xa [S5eU$)aQuery 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. rzvirDomainGetVcpusFlags() failed)rvirDomainGetVcpusFlagsrrrs r vcpusFlagsvirDomain.vcpusFlags9 s2*//? "9@A A r"rXrrc[R"URU5nUc [S5eUVs/sH n[ XS9PM sn$s snf)z9List all snapshots and returns a list of snapshot objectsz"virDomainListAllSnapshots() failedrZ)rvirDomainListAllSnapshotsrrrrrXr]snapptrs r listAllSnapshotsvirDomain.listAllSnapshotsV sG22477EB ;CD DEHIS'!$5SIIIA rkc[R"URU5nUc [S5eUVs/sH n[ XS9PM sn$s snf)z=List all checkpoints and returns a list of checkpoint objectsz$virDomainListAllCheckpoints() failedrZ)rvirDomainListAllCheckpointsrrrkrrXr]chkptrs r listAllCheckpointsvirDomain.listAllCheckpoints^ sG44TWWeD ;EF FEHIS6#D6SIIIrfilescj[R"URX5nUS:Xa [S5eU$)aDLaunch 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. rz!virDomainCreateWithFiles() failed)rvirDomainCreateWithFilesrr)rrrXr]s r createWithFilesvirDomain.createWithFilesf s3B11$''5H "9BC C r" mountpointscj[R"URX5nUS:Xa [S5eU$)z.Freeze specified filesystems within the guest rzvirDomainFSFreeze() failed)rvirDomainFSFreezerrrrrXr]s r fsFreezevirDomain.fsFreeze s0**477KG "9;< < r"cj[R"URX5nUS:Xa [S5eU$)z,Thaw specified filesystems within the guest rzvirDomainFSThaw() failed)rvirDomainFSThawrrrs r fsThawvirDomain.fsThaw s0((+E "99: : r"cd[R"URU5nUc [S5eU$)z%Extract information about guest time zvirDomainGetTime() failed)rvirDomainGetTimerrrs r getTimevirDomain.getTime .))$''59 ;:; ; r"timecj[R"URX5nUS:Xa [S5eU$)zSet guest time to the given value. @time is a dict containing 'seconds' field for seconds and 'nseconds' field for nanoseconds rzvirDomainSetTime() failed)rvirDomainSetTimerr)rrrXr]s r setTimevirDomain.setTime s2))$''4? "9:; ; r"r_cl[R"URXU5nUS:Xa [S5eU$)a=Associate the array of FDs passed as @fds with the domain object under @name. The FDs are associated as long as the connection used to associated exists and are disposed of afterwards. FD may still be kept open by the hypervisor for as long as it's needed. Security labelling (e.g. via the selinux) may be applied on the passed FDs when requiredg for usage by the VM. By default libvirt does not restore the seclabels on the FDs afterwards to avoid keeping it open unnecessarily. Restoring of the security label can be requested by passing either VIR_DOMAIN_FD_ASSOCIATE_SECLABEL_RESTORE for a best-effort attempt to restore the security label after use. Requesting the restore of security label will require that the file descriptors are kept open for the whole time they are used by the hypervisor, or other additional overhead. In certain cases usage of the fd group would imply read-only access. Passing VIR_DOMAIN_FD_ASSOCIATE_SECLABEL_WRITABLE in @flags ensures that a writable security label is picked in case when the file represented by the fds may be used in write mode. rzvirDomainFDAssociate() failed)rvirDomainFDAssociaterr)rr_rrXr]s r FDAssociatevirDomain.FDAssociate s4,--dggtEJ "9>? ? r"rrrjrr$rr)rNNr)NrNNr)rNr)NNNrNr)rIrJrKrLrrrrrrrrrrrrrrrrr rrrr r$r-r3r9r>rBrFrLrRrVrZr^rcrgrortrxr~rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrr!r%r)r-r2r6r;r@rGrKrOrSrWr[r`rerirmrrrxr|r_rrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrr$r)r-r1r5r:r@rDrHrLrQrWr[r`rfrjrnrsrxr}rrrrrrrrrr(rrrrrrrrNrrrrrMrrrrrrOrPr"r rrs@  5 6.* :;z  ]F&X8#JgRB2h04"H.&.@&.h & " 6(  $(2     GR.:,<($*4     !N4:"H0   4&8  $#J&@rh *  #JB:JcJ$7J2KJJJD9N4OJ$T#Y$s$;$LDIS$s)3sSCs3DIc#r"c\rSrSrSSjrSrSrSrS SjrSr S r S!S jr S r S r S rSrSrSrS!SjrSrS!SjrSrSrSrS!SjrSrS!SjrS!S\S\S4SjjrSrg)" virNetworki Nc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirNetwork.__init__ rr"clURb [R"UR5 SUlgrj)rrvirNetworkFreer&s r rvirNetwork.__del__ s% 77   % %dgg .r"cUR$rjrr&s r rvirNetwork.connect rr"cB[R"UR5$r)rvirNetwork_pointerrr&s r rvirNetwork.c_pointer ,,TWW55r"cd[R"URX5nUc [S5eU$)zTReturns a list of dhcp leases for interfaces connected to the given virtual network z virNetworkGetDHCPLeases() failed)rvirNetworkGetDHCPLeasesrr)rmacrXr]s r DHCPLeasesvirNetwork.DHCPLeases s.00#E ;AB B r"cb[R"UR5nUc [S5eU$)z1Extract the UUID unique Identifier of a network. zvirNetworkGetUUID() failed)rvirNetworkGetUUIDrrrs r rvirNetwork.UUID rr"cb[R"UR5nUc [S5eU$)z5Fetch globally unique ID of the network as a string. z virNetworkGetUUIDString() failed)rvirNetworkGetUUIDStringrrrs r rvirNetwork.UUIDString ,009 ;AB B r"cd[R"URU5nUc [S5eU$)amProvide 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. zvirNetworkGetXMLDesc() failed)rvirNetworkGetXMLDescrrrs r rvirNetwork.XMLDesc s0--dggu= ;>? ? r"ch[R"UR5nUS:Xa [S5eU$)z*Extract the autostart flag for a network. rzvirNetworkGetAutostart() failed)rvirNetworkGetAutostartrrrs r rvirNetwork.autostart.//8 "9@A A r"cb[R"UR5nUc [S5eU$)zqProvides a bridge interface name to which a domain may connect a network interface in order to join the network. z virNetworkGetBridgeName() failed)rvirNetworkGetBridgeNamerrrs r bridgeNamevirNetwork.bridgeNames.009 ;AB B r"ch[R"UR5nUS:Xa [S5eU$)zzCreate and start a defined network. If the call succeed the network moves from the defined to the running networks pools. rzvirNetworkCreate() failed)rvirNetworkCreaterrrs r rvirNetwork.creates0))$''2 "9:; ; r"ch[R"UR5nUS:Xa [S5eU$)zDestroy 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 rzvirNetworkDestroy() failed)rvirNetworkDestroyrrrs r rvirNetwork.destroy!rr"ch[R"UR5nUS:Xa [S5eU$)z.Determine if the network is currently running rzvirNetworkIsActive() failed)rvirNetworkIsActiverrrs r rvirNetwork.isActive+rr"ch[R"UR5nUS:Xa [S5eU$)zlDetermine if the network has a persistent configuration which means it will still exist after shutting down rzvirNetworkIsPersistent() failed)rvirNetworkIsPersistentrrrs r rvirNetwork.isPersistent2s0//8 "9@A A r"cf[R"URXU5nUc [S5eU$)a(Retrieves the appropriate network element given by @type. If VIR_NETWORK_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 network XML is not present, the resulting error will be VIR_ERR_NO_NETWORK_METADATA. This method forms a shortcut for seeing information from virNetworkSetMetadata() without having to go through virNetworkGetXMLDesc(). @flags controls whether the live network state or persistent configuration will be queried. zvirNetworkGetMetadata() failed)rvirNetworkGetMetadatarrr?s r r@virNetwork.metadata:s2..tww5I ;?@ @ r"cF[R"UR5nU$)z%Get the public name for that network )rvirNetworkGetNamerrs r r_virNetwork.nameLs**4773 r"cv[R"URX5nUc [S5e[ XS9nU$)zCreate 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. z virNetworkPortCreateXML() failedrZ)rvirNetworkPortCreateXMLrrvirNetworkPort)rxmldescrXr]_virNetwork__tmps r portCreateXMLvirNetwork.portCreateXMLQs: 00'I ;AB Bt. r"cv[R"URU5nUc [S5e[ XS9nU$)=Try to lookup a port on the given network based on its UUID. z#virNetworkPortLookupByUUID() failedrZ)rvirNetworkPortLookupByUUIDrrr+)ruuidr]r-s r portLookupByUUIDvirNetwork.portLookupByUUIDas833DGGTB ;DE Et. r"cv[R"URU5nUc [S5e[ XS9nU$)r1z)virNetworkPortLookupByUUIDString() failedrZ)r virNetworkPortLookupByUUIDStringrrr+)ruuidstrr]r-s r portLookupByUUIDString!virNetwork.portLookupByUUIDStringms899$''7K ;JK Kt. r"cj[R"URU5nUS:Xa [S5eU$)zOConfigure the network to be automatically started when the host machine boots. rzvirNetworkSetAutostart() failed)rvirNetworkSetAutostartrrrs r rvirNetwork.setAutostartus2//C "9@A A r"cn[R"URXX4U5nUS:Xa [S5eU$)aISets the appropriate network element given by @type to the value of @metadata. A @type of VIR_NETWORK_METADATA_DESCRIPTION is free-form text; VIR_NETWORK_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_NETWORK_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 network XML (passing the empty string leaves the element present). The resulting metadata will be present in virNetworkGetXMLDesc(), as well as quick access through virNetworkGetMetadata(). @flags controls whether the live network state, persistent configuration, or both will be modified. rzvirNetworkSetMetadata() failed)rvirNetworkSetMetadatarrrUs r rWvirNetwork.setMetadata}s7&..twwRWX "9?@ @ r"ch[R"UR5nUS:Xa [S5eU$)z9Undefine a network but does not stop it if it is running rzvirNetworkUndefine() failed)rvirNetworkUndefinerrrs r rvirNetwork.undefinerr"cn[R"URXX4U5nUS:Xa [S5eU$)ztUpdate the definition of an existing network, either its live running state, its persistent configuration, or both. rzvirNetworkUpdate() failed)rvirNetworkUpdaterr)rcommandsection parentIndexrrXr]s r updatevirNetwork.updates7))$''7[W\] "9:; ; r"rXrr+c[R"URU5nUc [S5eUVs/sH n[ XS9PM sn$s snf)zHList all ports on the network and returns a list of network port objectszvirNetworkListAllPorts() failedrZ)rvirNetworkListAllPortsrrr+rrXr]domptrs r listAllPortsvirNetwork.listAllPortssF//? ;@A A@CDft1DDDrrrjr$r)rIrJrKrLrrrrrrrrrrrrrrr@r_r.r4r9rrWrrIrNrrOrOrPr"r rr s  6 "$  0E#Ed3C.DEEr"rcn\rSrSrSSSjjrSrSrSrSrSr S r SS jr SS jr SS jr SS jrSrg)r+iNcXlUR5Ul[U5RS;a[ S[U5-5eX lgr)_netrrrrIrr)rnetr[s r rvirNetworkPort.__init__A [[] :  &@ @DtDzQR Rr"clURb [R"UR5 SUlgrj)rrvirNetworkPortFreer&s r rvirNetworkPort.__del__% 77   ) )$'' 2r"cUR$rjrr&s r rvirNetworkPort.connectrr"cUR$rj)rSr&s r networkvirNetworkPort.network yyr"cB[R"UR5$r)rvirNetworkPort_pointerrr&s r rvirNetworkPort.c_pointer0099r"cb[R"UR5nUc [S5eU$)z6Extract the UUID unique Identifier of a network port. zvirNetworkPortGetUUID() failed)rvirNetworkPortGetUUIDrrrs r rvirNetworkPort.UUID,..tww7 ;?@ @ r"cb[R"UR5nUc [S5eU$)z:Fetch globally unique ID of the network port as a string. z$virNetworkPortGetUUIDString() failed)rvirNetworkPortGetUUIDStringrrrs r rvirNetworkPort.UUIDString,44TWW= ;EF F r"cd[R"URU5nUc [S5eU$)zProvide an XML description of the network port. The description may be reused later to recreate the port with virNetworkPortCreateXML(). z!virNetworkPortGetXMLDesc() failed)rvirNetworkPortGetXMLDescrrrs r rvirNetworkPort.XMLDescs011$''5A ;BC C r"cj[R"URU5nUS:Xa [S5eU$)zDelete 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. rzvirNetworkPortDelete() failed)rvirNetworkPortDeleterrrs r deletevirNetworkPort.deletes2 --dggu= "9>? ? r"cd[R"URU5nUc [S5eU$)zGet the port parameters z$virNetworkPortGetParameters() failed)rvirNetworkPortGetParametersrrrs r parametersvirNetworkPort.parametersr&r"cj[R"URX5nUS:Xa [S5eU$)zChange the port tunables rz$virNetworkPortSetParameters() failed)rvirNetworkPortSetParametersrrrs r setParametersvirNetworkPort.setParametersrr")rrSrrjrNr)rIrJrKrLrrrr^rrrrrrrvrzrOrPr"r r+r+s9 : r"r+cf\rSrSrSSjrSrSrSrSrSSjr SS jr SS jr S r S r S rSrg) virInterfaceiNc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirInterface.__init__rr"clURb [R"UR5 SUlgrj)rrvirInterfaceFreer&s r rvirInterface.__del__s% 77   ' ' 0r"cUR$rjrr&s r rvirInterface.connect rr"cB[R"UR5$r)rvirInterface_pointerrr&s r rvirInterface.c_pointers..tww77r"cb[R"UR5nUc [S5eU$)zTGet the MAC for an interface as string. For more information about MAC see RFC4122. z!virInterfaceGetMACString() failed)rvirInterfaceGetMACStringrrrs r MACStringvirInterface.MACStrings.11$'': ;BC C r"cd[R"URU5nUc [S5eU$)aVIR_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. zvirInterfaceGetXMLDesc() failed)rvirInterfaceGetXMLDescrrrs r rvirInterface.XMLDesc s0//? ;@A A r"cj[R"URU5nUS:Xa [S5eU$)a#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. rzvirInterfaceCreate() failed)rvirInterfaceCreaterrrs r rvirInterface.create/s2++DGGU; "9<= = r"cj[R"URU5nUS:Xa [S5eU$)adeactivate 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. rzvirInterfaceDestroy() failed)rvirInterfaceDestroyrrrs r rvirInterface.destroy;s2,,TWWe< "9=> > r"ch[R"UR5nUS:Xa [S5eU$)z0Determine if the interface is currently running rzvirInterfaceIsActive() failed)rvirInterfaceIsActiverrrs r rvirInterface.isActiveJ.--dgg6 "9>? ? r"cF[R"UR5nU$)z'Get the public name for that interface )rvirInterfaceGetNamerrs r r_virInterface.nameQs,,TWW5 r"ch[R"UR5nUS:Xa [S5eU$)aUndefine 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. rzvirInterfaceUndefine() failed)rvirInterfaceUndefinerrrs r rvirInterface.undefineVs0--dgg6 "9>? ? r"rrjr)rIrJrKrLrrrrrrrrrr_rrOrPr"r r~r~s9  8    r"r~c\rSrSrS SjrSrSrSrSrSr S!S jr S r S!S jr S!S jr S!S jrS!SjrS!SjrSrSrSrSrSrSrSrS!SjrSrSrSrS!S\S\S4SjjrSrg)"virStoragePoolihNc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirStoragePool.__init__irr"clURb [R"UR5 SUlgrj)rrvirStoragePoolFreer&s r rvirStoragePool.__del__orZr"cUR$rjrr&s r rvirStoragePool.connecttrr"cB[R"UR5$r)rvirStoragePool_pointerrr&s r rvirStoragePool.c_pointerwrdr"cb[R"UR5nUc [S5eU$)z6Extract the UUID unique Identifier of a storage pool. zvirStoragePoolGetUUID() failed)rvirStoragePoolGetUUIDrrrs r rvirStoragePool.UUIDrhr"cb[R"UR5nUc [S5eU$)z:Fetch globally unique ID of the storage pool as a string. z$virStoragePoolGetUUIDString() failed)rvirStoragePoolGetUUIDStringrrrs r rvirStoragePool.UUIDStringrlr"cd[R"URU5nUc [S5eU$)zFetch an XML document describing all aspects of the storage pool. This is suitable for later feeding back into the virStoragePoolCreateXML method. z!virStoragePoolGetXMLDesc() failed)rvirStoragePoolGetXMLDescrrrs r rvirStoragePool.XMLDescs011$''5A ;BC C r"ch[R"UR5nUS:Xa [S5eU$)z.Extract the autostart flag for a storage pool rz#virStoragePoolGetAutostart() failed)rvirStoragePoolGetAutostartrrrs r rvirStoragePool.autostart.33DGG< "9DE E r"cj[R"URU5nUS:Xa [S5eU$)zCurrently only filesystem pool accepts flags VIR_STORAGE_POOL_BUILD_OVERWRITE and VIR_STORAGE_POOL_BUILD_NO_OVERWRITE. Build the underlying storage pool rzvirStoragePoolBuild() failed)rvirStoragePoolBuildrrrs r buildvirStoragePool.builds2 ,,TWWe< "9=> > r"cj[R"URU5nUS:Xa [S5eU$)z Starts an inactive storage pool rzvirStoragePoolCreate() failed)rvirStoragePoolCreaterrrs r rvirStoragePool.creates0--dggu= "9>? ? r"c[R"URX5nUc [S5e[ UR US9nU$)aCreate 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. zvirStorageVolCreateXML() failedrZ)rvirStorageVolCreateXMLrr virStorageVolr)rrmrXr]_virStoragePool__tmps r createXMLvirStoragePool.createXMLs@//H ;@A Adjjs3 r"cUcSnO URn[R"URXU5nUc [S5e[ UR US9nU$)aCreate 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() failedrZ)rrvirStorageVolCreateXMLFromrrr)rrmclonevolrX clonevol__or]rs r createXMLFromvirStoragePool.createXMLFromsW  K"++K33DGGWSXY ;DE Edjjs3 r"cj[R"URU5nUS:Xa [S5eU$)z~Delete the underlying pool resources. This is a non-recoverable operation. The virStoragePoolPtr object itself is not free'd. rzvirStoragePoolDelete() failed)rvirStoragePoolDeleterrrs r rrvirStoragePool.deletes2--dggu= "9>? ? r"ch[R"UR5nUS:Xa [S5eU$)aDestroy 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. rzvirStoragePoolDestroy() failed)rvirStoragePoolDestroyrrrs r rvirStoragePool.destroys0 ..tww7 "9?@ @ r"cb[R"UR5nUc [S5eU$)zExtract 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. zvirStoragePoolGetInfo() failed)rvirStoragePoolGetInforrrs r rvirStoragePool.inforhr"ch[R"UR5nUS:Xa [S5eU$)z3Determine if the storage pool is currently running rzvirStoragePoolIsActive() failed)rvirStoragePoolIsActiverrrs r rvirStoragePool.isActiverr"ch[R"UR5nUS:Xa [S5eU$)zqDetermine if the storage pool has a persistent configuration which means it will still exist after shutting down rz#virStoragePoolIsPersistent() failed)rvirStoragePoolIsPersistentrrrs r rvirStoragePool.isPersistent s033DGG< "9DE E r"cb[R"UR5nUc [S5eU$)zElist the storage volumes, stores the pointers to the names in @names z"virStoragePoolListVolumes() failed)rvirStoragePoolListVolumesrrrs r listVolumesvirStoragePool.listVolumesrr"cF[R"UR5nU$)z2Fetch the locally unique name of the storage pool )rvirStoragePoolGetNamerrs r r_virStoragePool.name$s..tww7 r"ch[R"UR5nUS:Xa [S5eU$)z2Fetch the number of storage volumes within a pool rz#virStoragePoolNumOfVolumes() failed)rvirStoragePoolNumOfVolumesrrrs r numOfVolumesvirStoragePool.numOfVolumes)rr"cj[R"URU5nUS:Xa [S5eU$)zRequest 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 rzvirStoragePoolRefresh() failed)rvirStoragePoolRefreshrrrs r refreshvirStoragePool.refresh0s2..tww> "9?@ @ r"cj[R"URU5nUS:Xa [S5eU$)zTConfigure the storage pool to be automatically started when the host machine boots. rz#virStoragePoolSetAutostart() failed)rvirStoragePoolSetAutostartrrrs r rvirStoragePool.setAutostart9s233DGGYG "9DE E r"c[R"URU5nUc [S5e[ UR US9nU$)zFetch 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. z"virStorageVolLookupByName() failedrZ)rvirStorageVolLookupByNamerrrr)rr_r]rs r storageVolLookupByName%virStoragePool.storageVolLookupByNameAs@ 22477DA ;CD Ddjjs3 r"ch[R"UR5nUS:Xa [S5eU$)z"Undefine an inactive storage pool rzvirStoragePoolUndefine() failed)rvirStoragePoolUndefinerrrs r rvirStoragePool.undefineMrr"rXrrc[R"URU5nUc [S5eUVs/sHn[ UR US9PM sn$s snf)zEList all storage volumes and returns a list of storage volume objectsz%virStoragePoolListAllVolumes() failedrZ)rvirStoragePoolListAllVolumesrrrr)rrXr]volptrs r listAllVolumesvirStoragePool.listAllVolumesWsL55dgguE ;FG GEHIS6 djjv6SIIIsArrjr) rIrJrKrLrrrrrrrrrrrrrrrrrrrr_rrrrrrNrrrOrPr"r rrhs  :$.   JCJ_0EJJr"rc\rSrSrSrSSjrSrSrSrSSjr SS jr SS jr S r SS jr S rSrSrSSjrSrSSjrSSjrSSjrSrg)ri_iNc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirStorageVol.__init__frr"clURb [R"UR5 SUlgrj)rrvirStorageVolFreer&s r rvirStorageVol.__del__l% 77   ( ( 1r"cUR$rjrr&s r rvirStorageVol.connectqrr"cB[R"UR5$r)rvirStorageVol_pointerrr&s r rvirStorageVol.c_pointert//88r"cd[R"URU5nUc [S5eU$)zCFetch an XML document describing all aspects of the storage volume z virStorageVolGetXMLDesc() failed)rvirStorageVolGetXMLDescrrrs r rvirStorageVol.XMLDesc|000%@ ;AB B r"cj[R"URU5nUS:Xa [S5eU$)z(Delete the storage volume from the pool rzvirStorageVolDelete() failed)rvirStorageVolDeleterrrs r rrvirStorageVol.delete0,,TWWe< "9=> > r"cUcSnO URn[R"URXRX45nUS:Xa [S5eU$)aDownload 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. NrzvirStorageVolDownload() failed)rrvirStorageVolDownloadrrrrPlengthrXrr]s r downloadvirStorageVol.downloadsG( >I I..tww 6Y "9?@ @ r"cb[R"UR5nUc [S5eU$)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. zvirStorageVolGetInfo() failed)rvirStorageVolGetInforrrs r rvirStorageVol.infor8r"cd[R"URU5nUc [S5eU$)rz"virStorageVolGetInfoFlags() failed)rvirStorageVolGetInfoFlagsrrrs r infoFlagsvirStorageVol.infoFlagss.22477EB ;CD D r"cb[R"UR5nUc [S5eU$)zFetch 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 zvirStorageVolGetKey() failed)rvirStorageVolGetKeyrrrs r rVvirStorageVol.keys.,,TWW5 ;=> > r"cF[R"UR5nU$)zIFetch the storage volume name. This is unique within the scope of a pool )rvirStorageVolGetNamerrs r r_virStorageVol.names--dgg6 r"cb[R"UR5nUc [S5eU$)zFetch 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 zvirStorageVolGetPath() failed)rvirStorageVolGetPathrrrs r r8virStorageVol.paths. --dgg6 ;>? ? r"cj[R"URX5nUS:Xa [S5eU$)aChanges 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. rzvirStorageVolResize() failed)rvirStorageVolResizerr)rcapacityrXr]s r resizevirStorageVol.resizes24,,TWWhF "9=> > r"c[R"UR5nUc [S5e[ UR US9nU$)zFetch 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. z%virStoragePoolLookupByVolume() failedrZ)rvirStoragePoolLookupByVolumerrrr)rr]_virStorageVol__tmps r storagePoolLookupByVolume'virStorageVol.storagePoolLookupByVolumes> 55dgg> ;FG Gtzz4 r"cUcSnO URn[R"URXRX45nUS:Xa [S5eU$)aUpload 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. NrzvirStorageVolUpload() failed)rrvirStorageVolUploadrrs r uploadvirStorageVol.uploadsG: >I I,,TWWiW "9=> > r"cj[R"URU5nUS:Xa [S5eU$)aEEnsure 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. rzvirStorageVolWipe() failed)rvirStorageVolWiperrrs r wipevirStorageVol.wipe(s2**477E: "9;< < r"cj[R"URX5nUS:Xa [S5eU$)acSimilar 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. rz!virStorageVolWipePattern() failed)rvirStorageVolWipePatternrr)r algorithmrXr]s r wipePatternvirStorageVol.wipePattern9s211$''9L "9BC C r"rrjr)rIrJrKrL streamBufSizerrrrrrrrrrrVr_r8r(r-r1r5r:rOrPr"r rr_s` M  9B > $L" r"rc \rSrSrSSjrSrSSjrSSjrSSjrSSjr SS jr SS jr S r SS jr SS jrSSjrSSjrSrSSjrSSjrSSjrSSjrSSjrSSjrSSjrSrSrSSjrSrSSjrSrSrSr S r!SS!jr"SS"jr#SS#jr$S$r%SS%jr&SS&jr'S'r(S(r)S)r*SS*jr+S+r,S,r-S-r.S.r/S/r0S0r1S1r2S2r3S3r4SS4jr5S5r6S6r7S7r8S8r9S9r:S:r;S;rS>r?S?r@SS@jrASArBSSBjrCSCrDSDrESErFSSFjrGSSGjrHSSHjrISIrJSSJjrKSKrLSLrMSMrNSNrOSSOjrPSPrQSQrRSRrSSSrTSTrUSUrVSSVjrWSWrXSXrYSSYjrZSZr[S[r\S\r]S]r^SS^jr_SS_jr`SS`jraSSajrbSSbjrcScrdSdreSerfSSfjrgSgrhSShjriSSijrjSSjjrkSkrlSlrmSmrnSnroSorpSprqSSqjrrSrrsSsrtSSujruSSvjrvSw\w\x\ySx\w\ySy\w\zStS4Szjr{S{\|StS4S|jr}S{\|S}\~StS4S~jrSSS\S\StS4SjrSSS\S\S\\\4St\4 SjrSSS\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\S\S\\\4St\4 SjrSSS\S\S\S\S\\\4St\4SjrSSS\S\S\S\S\S\\\4St\4SjrSSS\S\S\S\\\4StS4 SjrSSS\S\S\S\S\\\4St\4SjrSSS\S\S\\\4St\4 SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\S\\\4St\4 SjrSSS\S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\\\4S\\\4St\4SjrSSS\S\\\4St\4SjrSSS\S\S\\\4St\4 SjrSSS\S\S\S\S\\\4St\4SjrSSS\S\S\S\\\4St\4 SjrSSS\S\S\\\4St\4 SjrSSS\S\S\S\\\4St\4 SjrS\StS4SjrSSS\S\S\\\4St\4 SjrSSS\S\S\\\4St\4 SjrS\StS4SjrS\wSS\S{\S}\~St\4 SjrS\wSS\S{\S}\~St\4 SjrSSS\S\S\\\4St\4 SjrSSS\\\4St\4SjrS\StS4SjrS\wSS\S{\S}\~St\4 SjrSSS\S\S\\\4St\4 SjrSSS\\\4St\4SjrS\StS4SjrS\wSS\S{\S}\~St\4 SjrSSS\S\S\\\4St\4 SjrSSS\\\4St\4SjrS\StS4SjrS\wSS\S{\S}\~St\4 SjrSS\St\S4SjjrSS\St\S4SjjrSS\St\S4SjjrSS\St\S4SjjrSS\St\S4SjjrSS\St\S4SjjrSS\St\S4SjjrSS\St\S4SjjrS\S\\\4St\4SjrSSjrS{\S}\~St\4SjrSS\S\\S\StS4SjjrSS\S\St\\S\\\444SjjrSS\SS\S\St\\S\\\444SjjrSrg)riFNcp[U5RS;a[S[U5-5eXlgr)rrIrr)rr[s r rvirConnect.__init__Gs/ :  &@ @DtDzQR Rr"cB[R"UR5$r)rvirConnect_pointerrr&s r rvirConnect.c_pointerLrr"cl[R"URXX45nUS:Xa [S5eU$)z3Allocate or free some pages in the huge pages pool rzvirNodeAllocPages() failed)rvirNodeAllocPagesrr)rpages startCell cellCountrXr]s r allocPagesvirConnect.allocPagesTs2**477EiW "9;< < r"cd[R"URX5nUc [S5eU$)zQComputes the most feature-rich CPU which is compatible with all given host CPUs. zvirConnectBaselineCPU() failed)rvirConnectBaselineCPUrr)rxmlCPUsrXr]s r baselineCPUvirConnect.baselineCPU[...twwG ;?@ @ r"c h[R"URXX4XV5nUc [S5eU$)z|Computes the most feature-rich CPU which is compatible with all given CPUs and can be provided by the specified hypervisor. z(virConnectBaselineHypervisorCPU() failed)rvirConnectBaselineHypervisorCPUrr)remulatorarchmachinevirttyperLrXr]s r baselineHypervisorCPU virConnect.baselineHypervisorCPUbs488(RYelt ;IJ J r"cj[R"URU5nUS:Xa [S5eU$)aThis 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. rz virInterfaceChangeBegin() failed)rvirInterfaceChangeBeginrrrs r changeBeginvirConnect.changeBeginms200%@ "9AB B r"cj[R"URU5nUS:Xa [S5eU$)aThis 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. rz!virInterfaceChangeCommit() failed)rvirInterfaceChangeCommitrrrs r changeCommitvirConnect.changeCommit|s211$''5A "9BC C r"cj[R"URU5nUS:Xa [S5eU$)a 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. rz#virInterfaceChangeRollback() failed)rvirInterfaceChangeRollbackrrrs r changeRollbackvirConnect.changeRollbacks233DGGUC "9DE E r"cv[R"UR5nSUlUS:Xa [S5eU$)aThis 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. NrzvirConnectClose() failed)rvirConnectCloserrrs r closevirConnect.closes7((1 "99: : r"cj[R"URX5nUS:Xa [S5eU$)zCompares 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. rzvirConnectCompareCPU() failed)rvirConnectCompareCPUrrrrmrXr]s r compareCPUvirConnect.compareCPUs2 --dggwF "9>? ? r"c n[R"URXX4XV5nUS:Xa [S5eU$)aCompares 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. rz'virConnectCompareHypervisorCPU() failed)rvirConnectCompareHypervisorCPUrr)rrRrSrTrUxmlCPUrXr]s r compareHypervisorCPUvirConnect.compareHypervisorCPUs877QXdjr "9HI I r"cv[R"URX5nUc [S5e[ XS9nU$)zDeprecated after 0.4.6. Renamed to virDomainCreateXML() providing identical functionality. This existing name will be left indefinitely for API compatibility. zvirDomainCreateLinux() failedrZ)rvirDomainCreateLinuxrrrrrmrXr]_virConnect__tmps r createLinuxvirConnect.createLinuxs:--dggwF ;>? ?$) r"cv[R"URX5nUc [S5e[ XS9nU$)avLaunch 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. If @flags includes VIR_DOMAIN_START_RESET_NVRAM, then libvirt will discard any existing NVRAM file and re-initialize NVRAM from the pristine template. virDomainFree should be used to free the resources after the domain object is no longer needed. zvirDomainCreateXML() failedrZ)rvirDomainCreateXMLrrrrts r rvirConnect.createXMLs:4++DGGWD ;<= =$) r"cv[R"URU5nUc [S5e[ XS9nU$)aIDefine 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. zvirDomainDefineXML() failedrZ)rvirDomainDefineXMLrrrrrr]rus r defineXMLvirConnect.defineXMLs:++DGGS9 ;<= =$) r"cv[R"URX5nUc [S5e[ XS9nU$)aJDefines 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. z virDomainDefineXMLFlags() failedrZ)rvirDomainDefineXMLFlagsrrrrrrXr]rus r defineXMLFlagsvirConnect.defineXMLFlagss:00#E ;AB B$) r"cf[R"URXU5nUc [S5eU$)zReads native configuration data describing a domain, and generates libvirt domain XML. The format of the native data is hypervisor dependent. z&virConnectDomainXMLFromNative() failed)rvirConnectDomainXMLFromNativerr)r nativeFormat nativeConfigrXr]s r domainXMLFromNativevirConnect.domainXMLFromNatives366tww \ab ;GH H r"cf[R"URXU5nUc [S5eU$)aDReads a domain XML configuration document, and generates a native configuration file describing the domain. The format of the native data is hypervisor dependent. Note that certain hypervisor drivers such as the QEMU driver configure many aspects of the domain dynamically via hypervisor APIs and that may not be part of the returned native configuration format. Similarly certain resources are passed to the hypervisor via file descriptors, which are not part of the native configuration returned by this API. Such configuration is thus not trivially usable outside of libvirt. z$virConnectDomainXMLToNative() failed)rvirConnectDomainXMLToNativerr)rr domainXmlrXr]s r domainXMLToNativevirConnect.domainXMLToNatives344TWWlW\] ;EF F r"cf[R"URXU5nUc [S5eU$)aTalks 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) z)virConnectFindStoragePoolSources() failed)r virConnectFindStoragePoolSourcesrr)rrsrcSpecrXr]s r findStoragePoolSources!virConnect.findStoragePoolSources+s399$''4RWX ;JK K r"cd[R"URU5nUc [S5eU$)zGet node CPU information zvirNodeGetCPUMap() failed)rvirNodeGetCPUMaprrrs r getCPUMapvirConnect.getCPUMap>rr"cd[R"URX5nUc [S5eU$)z&Get the list of supported CPU models. z#virConnectGetCPUModelNames() failed)rvirConnectGetCPUModelNamesrr)rrSrXr]s r getCPUModelNamesvirConnect.getCPUModelNamesEs.33DGGTI ;DE E r"cd[R"URX5nUc [S5eU$)zExtract node's CPU statistics. zvirNodeGetCPUStats() failed)rvirNodeGetCPUStatsrr)rcpuNumrXr]s r rvirConnect.getCPUStatsLs.++DGGVC ;<= = r"cb[R"UR5nUc [S5eU$)z2Provides capabilities of the hypervisor / driver. z"virConnectGetCapabilities() failed)rvirConnectGetCapabilitiesrrrs r getCapabilitiesvirConnect.getCapabilitiesWrr"cd[R"URX5nUc [S5eU$)z1Returns the available memory for a list of cells z"virNodeGetCellsFreeMemory() failed)rvirNodeGetCellsFreeMemoryrr)rrFmaxCellsr]s r getCellsFreeMemoryvirConnect.getCellsFreeMemorybs.22477IP ;CD D r"ch[R"URXX4U5nUc [S5eU$)zQuery domain capabilities z(virConnectGetDomainCapabilities() failed)rvirConnectGetDomainCapabilitiesrr)r emulatorbinrSrTrUrXr]s r getDomainCapabilities virConnect.getDomainCapabilitiesms488+U\hmn ;IJ J r"cF[R"UR5nU$)zprovides 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. )rvirNodeGetFreeMemoryrrs r getFreeMemoryvirConnect.getFreeMemoryxs--dgg6 r"cf[R"URXX45nUc [S5eU$)zIReturns the number of available pages for a list of cells and page sizes zvirNodeGetFreePages() failed)rvirNodeGetFreePagesrr)rrErFrrXr]s r getFreePagesvirConnect.getFreePagess0,,TWWeX ;=> > r"cb[R"UR5nUc [S5eU$)aThis 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. zvirConnectGetHostname() failed)rvirConnectGetHostnamerrrs r getHostnamevirConnect.getHostnames. ..tww7 ;?@ @ r"cb[R"UR5nUc [S5eU$)zjExtract hardware information about the Node. Note that the memory size is reported in MiB instead of KiB. zvirNodeGetInfo() failed)rvirNodeGetInforrrs r getInfovirConnect.getInfos,''0 ;89 9 r"ch[R"UR5nUS:Xa [S5eU$)z3Returns the libvirt version of the connection host rz virConnectGetLibVersion() failed)rvirConnectGetLibVersionrrrs r getLibVersionvirConnect.getLibVersion.009 "9AB B r"cj[R"URU5nUS:Xa [S5eU$)aProvides 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 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 "" in its output instead. rzvirConnectGetMaxVcpus() failed)rvirConnectGetMaxVcpusrr)rrr]s r getMaxVcpusvirConnect.getMaxVcpuss2..tww= "9?@ @ r"cd[R"URU5nUc [S5eU$)zGet the node memory parameters z#virNodeGetMemoryParameters() failed)rvirNodeGetMemoryParametersrrrs r getMemoryParametersvirConnect.getMemoryParametersrr"cd[R"URX5nUc [S5eU$)z"Extract node's memory statistics. zvirNodeGetMemoryStats() failed)rvirNodeGetMemoryStatsrr)rcellNumrXr]s r getMemoryStatsvirConnect.getMemoryStatsrOr"cd[R"URU5nUc [S5eU$)z8Get platform specific information from the SEV firmware zvirNodeGetSEVInfo() failed)rvirNodeGetSEVInforrrs r getSEVInfovirConnect.getSEVInforr"cb[R"UR5nUc [S5eU$)z8Extract information about the hypervisor security model z virNodeGetSecurityModel() failed)rvirNodeGetSecurityModelrrrs r getSecurityModelvirConnect.getSecurityModelr r"cd[R"URU5nUc [S5eU$)zPrior 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. z-virConnectGetStoragePoolCapabilities() failed)r$virConnectGetStoragePoolCapabilitiesrrrs r getStoragePoolCapabilities%virConnect.getStoragePoolCapabilitiess0==dgguM ;NO O r"cd[R"URU5nUc [S5eU$)aThis returns the XML description of the sysinfo details for the host on which the hypervisor is running, in the same format as the element of a domain XML. This information is generally available only for hypervisors running with root privileges. zvirConnectGetSysinfo() failed)rvirConnectGetSysinforrrs r getSysinfovirConnect.getSysinfos0 --dggu= ;>? ? r"cb[R"UR5nUc [S5eU$)a8Get 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(). zvirConnectGetType() failed)rvirConnectGetTyperrrs r getTypevirConnect.getTypes. **4773 ;;< < r"cb[R"UR5nUc [S5eU$)ajThis 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. zvirConnectGetURI() failed)rvirConnectGetURIrrrs r getURIvirConnect.getURIs.))$''2 ;:; ; r"ch[R"UR5nUS:Xa [S5eU$)z>Returns the running hypervisor version of the connection host rzvirConnectGetVersion() failed)rvirConnectGetVersionrrrs r rcvirConnect.getVersionrr"cv[R"URX5nUc [S5e[ XS9nU$)aDefine 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. zvirInterfaceDefineXML() failedrZ)rvirInterfaceDefineXMLrrr~rs r interfaceDefineXMLvirConnect.interfaceDefineXMLs: ..twwC ;?@ @T, r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z&virInterfaceLookupByMACString() failedrZ)rvirInterfaceLookupByMACStringrrr~)rmacstrr]rus r interfaceLookupByMACString%virConnect.interfaceLookupByMACString3s: 66twwG ;GH HT, r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z!virInterfaceLookupByName() failedrZ)rvirInterfaceLookupByNamerrr~rr_r]rus r interfaceLookupByName virConnect.interfaceLookupByName>s: 11$''4@ ;BC CT, r"ch[R"UR5nUS:Xa [S5eU$)zDetermine 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. rzvirConnectIsAlive() failed)rvirConnectIsAliverrrs r isAlivevirConnect.isAliveMrr"ch[R"UR5nUS:Xa [S5eU$)z;Determine if the connection to the hypervisor is encrypted rzvirConnectIsEncrypted() failed)rvirConnectIsEncryptedrrrs r isEncryptedvirConnect.isEncryptedWrr"ch[R"UR5nUS:Xa [S5eU$)zDetermine 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) rzvirConnectIsSecure() failed)rvirConnectIsSecurerrrs r isSecurevirConnect.isSecure^s0 ++DGG4 "9<= = r"cb[R"UR5nUc [S5eU$)zElist the defined domains, stores the pointers to the names in @names z%virConnectListDefinedDomains() failed)rvirConnectListDefinedDomainsrrrs r listDefinedDomainsvirConnect.listDefinedDomainsms,55dgg> ;FG G r"cb[R"UR5nUc [S5eU$)zHlist the defined interfaces, stores the pointers to the names in @names z(virConnectListDefinedInterfaces() failed)rvirConnectListDefinedInterfacesrrrs r listDefinedInterfaces virConnect.listDefinedInterfacestrr"cb[R"UR5nUc [S5eU$)zFlist the defined networks, stores the pointers to the names in @names z&virConnectListDefinedNetworks() failed)rvirConnectListDefinedNetworksrrrs r listDefinedNetworksvirConnect.listDefinedNetworks{rr"cb[R"UR5nUc [S5eU$)zJlist the defined storage pool, stores the pointers to the names in @names z*virConnectListDefinedStoragePools() failed)r!virConnectListDefinedStoragePoolsrrrs r listDefinedStoragePools"virConnect.listDefinedStoragePoolss,::477C ;KL L r"cd[R"URX5nUc [S5eU$)zlist the node devices zvirNodeListDevices() failed)rvirNodeListDevicesrrrcaprXr]s r listDevicesvirConnect.listDevicess.++DGGS@ ;<= = r"cb[R"UR5nUc [S5eU$)zlist the networks, stores the pointers to the names in @names zvirConnectListNetworks() failed)rvirConnectListNetworksrrrs r listNetworksvirConnect.listNetworksrr"cb[R"UR5nUc [S5eU$)zList the defined secret IDs zvirConnectListSecrets() failed)rvirConnectListSecretsrrrs r listSecretsvirConnect.listSecretsrhr"cb[R"UR5nUc [S5eU$)zClist the storage pools, stores the pointers to the names in @names z#virConnectListStoragePools() failed)rvirConnectListStoragePoolsrrrs r listStoragePoolsvirConnect.listStoragePools,33DGG< ;DE E r"cv[R"URU5nUc [S5e[ XS9nU$)a(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. zvirDomainLookupByID() failedrZ)rvirDomainLookupByIDrrr)ridr]rus r lookupByIDvirConnect.lookupByIDs:,,TWWb9 ;=> >$) r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. zvirDomainLookupByName() failedrZ)rvirDomainLookupByNamerrrrs r lookupByNamevirConnect.lookupByNames: ..tww= ;?@ @$) r"cv[R"URU5nUc [S5e[ XS9nU$)zBTry to lookup a domain on the given hypervisor based on its UUID. zvirDomainLookupByUUID() failedrZ)rvirDomainLookupByUUIDrrrrr3r]rus r lookupByUUIDvirConnect.lookupByUUID8..tww= ;?@ @$) r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z$virDomainLookupByUUIDString() failedrZ)rvirDomainLookupByUUIDStringrrrrr8r]rus r lookupByUUIDStringvirConnect.lookupByUUIDStrings: 44TWWgF ;EF F$) r"cv[R"URU5nUc [S5e[ XS9nU$)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. zvirNetworkCreateXML() failedrZ)rvirNetworkCreateXMLrrrrrmr]rus r networkCreateXMLvirConnect.networkCreateXMLs: ,,TWWg> ;=> >4* r"cv[R"URX5nUc [S5e[ XS9nU$)rKz!virNetworkCreateXMLFlags() failedrZ)rvirNetworkCreateXMLFlagsrrrrts r networkCreateXMLFlags virConnect.networkCreateXMLFlagss: 11$''7J ;BC C4* r"cv[R"URU5nUc [S5e[ XS9nU$)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. zvirNetworkDefineXML() failedrZ)rvirNetworkDefineXMLrrrr}s r networkDefineXMLvirConnect.networkDefineXMLs: ,,TWWc: ;=> >4* r"cv[R"URX5nUc [S5e[ XS9nU$)rUz!virNetworkDefineXMLFlags() failedrZ)rvirNetworkDefineXMLFlagsrrrrs r networkDefineXMLFlags virConnect.networkDefineXMLFlags)s: 11$''3F ;BC C4* r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. zvirNetworkLookupByName() failedrZ)rvirNetworkLookupByNamerrrrs r networkLookupByNamevirConnect.networkLookupByName5s: //> ;@A A4* r"cv[R"URU5nUc [S5e[ XS9nU$)CTry to lookup a network on the given hypervisor based on its UUID. zvirNetworkLookupByUUID() failedrZ)rvirNetworkLookupByUUIDrrrrAs r networkLookupByUUIDvirConnect.networkLookupByUUIDDs8//> ;@A A4* r"cv[R"URU5nUc [S5e[ XS9nU$)rbz%virNetworkLookupByUUIDString() failedrZ)rvirNetworkLookupByUUIDStringrrrrGs r networkLookupByUUIDString$virConnect.networkLookupByUUIDStringPs855dggwG ;FG G4* r"cv[R"URU5nUc [S5e[ XS9nU$)aCreates 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. zvirStreamNew() failedrZ)r virStreamNewrr virStream)rrXr]rus r newStreamvirConnect.newStream\s:%%dggu5 ;67 7$) r"cv[R"URX5nUc [S5e[ XS9nU$)zCreate 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. zvirNodeDeviceCreateXML() failedrZ)rvirNodeDeviceCreateXMLrr virNodeDevicerts r nodeDeviceCreateXMLvirConnect.nodeDeviceCreateXMLrs: //H ;@A Ad- r"cv[R"URX5nUc [S5e[ XS9nU$)aDefine a new inactive persistent device or modify an existing persistent one from the XML description 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. zvirNodeDeviceDefineXML() failedrZ)rvirNodeDeviceDefineXMLrrrqrts r nodeDeviceDefineXMLvirConnect.nodeDeviceDefineXML~s://H ;@A Ad- r"cv[R"URU5nUc [S5e[ XS9nU$)zLookup a node device by its name. virNodeDeviceFree should be used to free the resources after the node device object is no longer needed. z"virNodeDeviceLookupByName() failedrZ)rvirNodeDeviceLookupByNamerrrqrs r nodeDeviceLookupByName!virConnect.nodeDeviceLookupByNames: 22477DA ;CD Dd- r"cx[R"URXU5nUc [S5e[ XS9nU$)zLookup 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. z)virNodeDeviceLookupSCSIHostByWWN() failedrZ)r virNodeDeviceLookupSCSIHostByWWNrrrq)rwwnnwwpnrXr]rus r nodeDeviceLookupSCSIHostByWWN(virConnect.nodeDeviceLookupSCSIHostByWWNs< 99$''4uU ;JK Kd- r"ch[R"UR5nUS:Xa [S5eU$)z5Provides the number of defined but inactive domains. rz&virConnectNumOfDefinedDomains() failed)rvirConnectNumOfDefinedDomainsrrrs r numOfDefinedDomainsvirConnect.numOfDefinedDomainss.66tww? "9GH H r"ch[R"UR5nUS:Xa [S5eU$)zKProvides the number of defined (inactive) interfaces on the physical host. rz)virConnectNumOfDefinedInterfaces() failed)r virConnectNumOfDefinedInterfacesrrrs r numOfDefinedInterfaces!virConnect.numOfDefinedInterfacess.99$''B "9JK K r"ch[R"UR5nUS:Xa [S5eU$)z*Provides the number of inactive networks. rz'virConnectNumOfDefinedNetworks() failed)rvirConnectNumOfDefinedNetworksrrrs r numOfDefinedNetworksvirConnect.numOfDefinedNetworkss.77@ "9HI I r"ch[R"UR5nUS:Xa [S5eU$)z.Provides the number of inactive storage pools rz+virConnectNumOfDefinedStoragePools() failed)r"virConnectNumOfDefinedStoragePoolsrrrs r numOfDefinedStoragePools#virConnect.numOfDefinedStoragePoolss.;;DGGD "9LM M r"cj[R"URX5nUS:Xa [S5eU$)zProvides 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 rzvirNodeNumOfDevices() failed)rvirNodeNumOfDevicesrrrs r numOfDevicesvirConnect.numOfDevicess2 ,,TWWcA "9=> > r"ch[R"UR5nUS:Xa [S5eU$)z'Provides the number of active domains. rzvirConnectNumOfDomains() failed)rvirConnectNumOfDomainsrrrs r numOfDomainsvirConnect.numOfDomainsrr"ch[R"UR5nUS:Xa [S5eU$)z?Provides the number of active interfaces on the physical host. rz"virConnectNumOfInterfaces() failed)rvirConnectNumOfInterfacesrrrs r numOfInterfacesvirConnect.numOfInterfacesrr"ch[R"UR5nUS:Xa [S5eU$)z"Provides the number of nwfilters. rz!virConnectNumOfNWFilters() failed)rvirConnectNumOfNWFiltersrrrs r numOfNWFiltersvirConnect.numOfNWFilterss.11$'': "9BC C r"ch[R"UR5nUS:Xa [S5eU$)z(Provides the number of active networks. rz virConnectNumOfNetworks() failed)rvirConnectNumOfNetworksrrrs r numOfNetworksvirConnect.numOfNetworksrr"ch[R"UR5nUS:Xa [S5eU$)z+Fetch number of currently defined secrets. rzvirConnectNumOfSecrets() failed)rvirConnectNumOfSecretsrrrs r numOfSecretsvirConnect.numOfSecrets rr"ch[R"UR5nUS:Xa [S5eU$)z,Provides the number of active storage pools rz$virConnectNumOfStoragePools() failed)rvirConnectNumOfStoragePoolsrrrs r numOfStoragePoolsvirConnect.numOfStoragePoolss.44TWW= "9EF F r"cv[R"URX5nUc [S5e[ XS9nU$)ayDefine 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. z$virNWFilterBindingCreateXML() failedrZ)rvirNWFilterBindingCreateXMLrrvirNWFilterBindingrs r nwfilterBindingCreateXML#virConnect.nwfilterBindingCreateXML!s:44TWWcI ;EF F"42 r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z*virNWFilterBindingLookupByPortDev() failedrZ)r!virNWFilterBindingLookupByPortDevrrr)rportdevr]rus r nwfilterBindingLookupByPortDev)virConnect.nwfilterBindingLookupByPortDev4s: ::477GL ;KL L"42 r"cv[R"URU5nUc [S5e[ XS9nU$)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. zvirNWFilterDefineXML() failedrZ)rvirNWFilterDefineXMLrr virNWFilterrMs r nwfilterDefineXMLvirConnect.nwfilterDefineXML@s: --dggw? ;>? ?D+ r"cv[R"URX5nUc [S5e[ XS9nU$)rz"virNWFilterDefineXMLFlags() failedrZ)rvirNWFilterDefineXMLFlagsrrrrts r nwfilterDefineXMLFlags!virConnect.nwfilterDefineXMLFlagsLs: 22477GK ;CD DD+ r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z virNWFilterLookupByName() failedrZ)rvirNWFilterLookupByNamerrrrs r nwfilterLookupByNamevirConnect.nwfilterLookupByNameXs: 00$? ;AB BD+ r"cv[R"URU5nUc [S5e[ XS9nU$)zJTry to lookup a network filter on the given hypervisor based on its UUID. z virNWFilterLookupByUUID() failedrZ)rvirNWFilterLookupByUUIDrrrrAs r nwfilterLookupByUUIDvirConnect.nwfilterLookupByUUIDgs800$? ;AB BD+ r"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z&virNWFilterLookupByUUIDString() failedrZ)rvirNWFilterLookupByUUIDStringrrrrGs r nwfilterLookupByUUIDString%virConnect.nwfilterLookupByUUIDStringss: 66twwH ;GH HD+ r"cj[R"URU5nUS:Xa [S5eU$)zsThis method will restore a domain saved to disk by virDomainSave(). See virDomainRestoreFlags() for more control. rzvirDomainRestore() failed)rvirDomainRestorerr)rfrmr]s r restorevirConnect.restores2))$''37 "9:; ; r"cl[R"URXU5nUS:Xa [S5eU$)alThis 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. If @flags includes VIR_DOMAIN_SAVE_RESET_NVRAM, then libvirt will discard any existing NVRAM file and re-initialize NVRAM from the pristine template. rzvirDomainRestoreFlags() failed)rvirDomainRestoreFlagsrr)rrrrXr]s r restoreFlagsvirConnect.restoreFlagss40..tww5I "9?@ @ r"cj[R"URX5nUS:Xa [S5eU$)z1This method will restore a domain saved to disk. rzvirDomainRestoreParams() failed)rvirDomainRestoreParamsrrrs r restoreParamsvirConnect.restoreParamsrbr"cl[R"URXU5nUS:Xa [S5eU$)aThis 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. rz$virDomainSaveImageDefineXML() failed)rvirDomainSaveImageDefineXMLrr)rfilerrXr]s r saveImageDefineXMLvirConnect.saveImageDefineXMLs4"44TWWd%P "9EF F r"cd[R"URX5nUc [S5eU$)aThis 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. z%virDomainSaveImageGetXMLDesc() failed)rvirDomainSaveImageGetXMLDescrr)rrrXr]s r saveImageGetXMLDescvirConnect.saveImageGetXMLDescs055dggtK ;FG G r"cv[R"URX5nUc [S5e[ XS9nU$)aIf 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. zvirSecretDefineXML() failedrZ)rvirSecretDefineXMLrr virSecretrs r secretDefineXMLvirConnect.secretDefineXMLs:++DGGS@ ;<= =$) r"cv[R"URU5nUc [S5e[ XS9nU$)zBTry to lookup a secret on the given hypervisor based on its UUID. zvirSecretLookupByUUID() failedrZ)rvirSecretLookupByUUIDrrrrAs r secretLookupByUUIDvirConnect.secretLookupByUUIDrDr"cv[R"URU5nUc [S5e[ XS9nU$)zTry 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. z$virSecretLookupByUUIDString() failedrZ)rvirSecretLookupByUUIDStringrrrrGs r secretLookupByUUIDString#virConnect.secretLookupByUUIDStrings: 44TWWgF ;EF F$) r"cv[R"URX5nUc [S5e[ XS9nU$)zTry 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. zvirSecretLookupByUsage() failedrZ)rvirSecretLookupByUsagerrr)r usageTypeusageIDr]rus r secretLookupByUsagevirConnect.secretLookupByUsage s://L ;@A A$) r"cj[R"URX5nUS:Xa [S5eU$)zJOverride the default identity information associated with the connection. rzvirConnectSetIdentity() failed)rvirConnectSetIdentityrrrs r setIdentityvirConnect.setIdentitys0..twwF "9?@ @ r"cj[R"URX5nUS:Xa [S5eU$)aStart 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. rzvirConnectSetKeepAlive() failed)rvirConnectSetKeepAliverr)rintervalcountr]s r setKeepAlivevirConnect.setKeepAlive!s2"//I "9@A A r"cj[R"URX5nUS:Xa [S5eU$)z Change the node memory tunables rz#virNodeSetMemoryParameters() failed)rvirNodeSetMemoryParametersrrrs r rLvirConnect.setMemoryParameters;r]r"cv[R"URX5nUc [S5e[ XS9nU$)aCreate 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. z virStoragePoolCreateXML() failedrZ)rvirStoragePoolCreateXMLrrrrts r storagePoolCreateXMLvirConnect.storagePoolCreateXMLFs:00'I ;AB Bt. r"cv[R"URX5nUc [S5e[ XS9nU$)zDefine 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. z virStoragePoolDefineXML() failedrZ)rvirStoragePoolDefineXMLrrrrs r storagePoolDefineXMLvirConnect.storagePoolDefineXMLSs: 00#E ;AB Bt. r"cv[R"URU5nUc [S5e[ XS9nU$)zFetch 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. z#virStoragePoolLookupByName() failedrZ)rvirStoragePoolLookupByNamerrrrs r storagePoolLookupByName"virConnect.storagePoolLookupByName_: 33DGGTB ;DE Et. r"cv[R"URU5nUc [S5e[ XS9nU$)aFetch 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. z)virStoragePoolLookupByTargetPath() failedrZ)r virStoragePoolLookupByTargetPathrrrrr8r]rus r storagePoolLookupByTargetPath(virConnect.storagePoolLookupByTargetPathjs:99$''4H ;JK Kt. r"cv[R"URU5nUc [S5e[ XS9nU$)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. z#virStoragePoolLookupByUUID() failedrZ)rvirStoragePoolLookupByUUIDrrrrAs r storagePoolLookupByUUID"virConnect.storagePoolLookupByUUIDwrr"cv[R"URU5nUc [S5e[ XS9nU$)rz)virStoragePoolLookupByUUIDString() failedrZ)r virStoragePoolLookupByUUIDStringrrrrGs r storagePoolLookupByUUIDString(virConnect.storagePoolLookupByUUIDStrings: 99$''7K ;JK Kt. r"cv[R"URU5nUc [S5e[ XS9nU$)zFetch 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. z!virStorageVolLookupByKey() failedrZ)rvirStorageVolLookupByKeyrrr)rrVr]rus r storageVolLookupByKey virConnect.storageVolLookupByKeys: 11$''3? ;BC Cd- r"cv[R"URU5nUc [S5e[ XS9nU$)zFetch 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. z"virStorageVolLookupByPath() failedrZ)rvirStorageVolLookupByPathrrrrs r storageVolLookupByPath!virConnect.storageVolLookupByPaths: 22477DA ;CD Dd- r"cl[R"URXU5nUS:Xa [S5eU$)zAttempt 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. rz"virNodeSuspendForDuration() failed)rvirNodeSuspendForDurationrrrs r suspendForDurationvirConnect.suspendForDurations4 22477FeT "9CD D r"cF[R"UR5nU$)aYProvide 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. )rvirConnGetLastErrorrrs r r,virConnect.virConnGetLastErrors ,,TWW5 r"cD[R"UR5 g)zThe 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)rvirConnResetLastErrorrr&s r r/ virConnect.virConnResetLastErrors ((1r"rcURR5 U?[R"URU5 URb [R "UR5 SUlg![ a NAf=frj)domainEventCallbacksclearrvirConnectDomainEventDeregisterrAttributeErrorrer&s r rvirConnect.__del__sl   % % + + -)  6 6tww E 77   & &tww /    s=A44 BBcU$rjrPr&s r __enter__virConnect.__enter__s r" exc_type_ exc_value_ traceback_c$UR5 grj)rf)rr:r;r<s r __exit__virConnect.__exit__s  r"r|cURU [UR5S:Xa5U?[R"URU5nUS:Xa [ S5egg![ a gf=f)oRemoves a Domain Event Callback. De-registering for a domain callback will disable delivery of this event type rrz(virConnectDomainEventDeregister() failedN)r2lenrr4rrr5)rr|r]s r domainEventDeregister virConnect.domainEventDeregistersu ))"-4,,-2- @@$O"9&'QRR3    sAA A+*A+rgcX RU'g![a= X0Ul[R"URU5nUS:Xa [ S5egf=f)cAdds a Domain Event Callback. Registering for a domain callback will enable delivery of the events rz&virConnectDomainEventRegister() failedN)r2r5rvirConnectDomainEventRegisterrr)rr|rgr]s r domainEventRegistervirConnect.domainEventRegisters_ M,2 % %b ) M)+ D %::477DICby"#KLL MsAAAdomrrfdetailc URR5HupEU"U[XS9X#U5 M g![a gf=f)z@Dispatches events to python user domain event callbacks rZN)r2itemsrr5)rrJrfrKr|rgs r _dispatchDomainEventCallbacks(virConnect._dispatchDomainEventCallbackssH "77==? 442E6J@   s58 AAryc<USnUSnU"U[XS9X#U5 g)zJDispatches events to python user domain lifecycle event callbacks r|rgrZrr)rrJrfrKryr|rgs r %_dispatchDomainEventLifecycleCallback0virConnect._dispatchDomainEventLifecycleCallbacks-D\! 44*E6Br"c:USnUSnU"U[XS9U5 g)zHDispatches events to python user domain generic event callbacks r|rgrZrrQ)rrJryr|rgs r #_dispatchDomainEventGenericCallback.virConnect._dispatchDomainEventGenericCallbacks+D\! 44*F3r"rPc:USnUSnU"U[XS9X%5 g)zKDispatches events to python user domain RTC change event callbacks r|rgrZrrQ)rrJrPryr|rgs r %_dispatchDomainEventRTCChangeCallback0virConnect._dispatchDomainEventRTCChangeCallback+D\! 44*F;r"r9c:USnUSnU"U[XS9X%5 g)zIDispatches events to python user domain watchdog event callbacks r|rgrZrrQ)rrJr9ryr|rgs r $_dispatchDomainEventWatchdogCallback/virConnect._dispatchDomainEventWatchdogCallback"rZr"srcPathdevAliasc<USnUSnU"U[XS9X#XG5 gzIDispatches events to python user domain IO error event callbacks r|rgrZrrQ)rrJr^r_r9ryr|rgs r #_dispatchDomainEventIOErrorCallback.virConnect._dispatchDomainEventIOErrorCallback+s-D\! 44*GvNr"reasonc >USnUSnU"U[XS9X#UXX5 grarQ) rrJr^r_r9rdryr|rgs r )_dispatchDomainEventIOErrorReasonCallback4virConnect._dispatchDomainEventIOErrorReasonCallback4s2D\! 44*Gv  r"phase localAddr remoteAddr authSchemesubjectc @USnUSn U"U[XS9X#UXVU 5 g)zIDispatches events to python user domain graphics event callbacks r|rgrZrrQ) rrJrhrirjrkrlryr|rgs r $_dispatchDomainEventGraphicsCallback/virConnect._dispatchDomainEventGraphicsCallback>s4D\! 44*Ej  (r"r)rstatusc^USnUSnU"U[XS9X#XG5 g![a gf=f)zSDispatches events to python user domain blockJob/blockJob2 event callbacks r|rgrZN)rr5)rrJr)rrpryr|rgs r $_dispatchDomainEventBlockJobCallback/virConnect._dispatchDomainEventBlockJobCallbackHs? BH%F tYt.F K   s  ,, oldSrcPath newSrcPathc >USnUSnU"U[XS9X#XEU5 g)zJDispatches event to python user domain diskChange event callbacks r|rgrZrrQ) rrJrtrur_rdryr|rgs r &_dispatchDomainEventDiskChangeCallback1virConnect._dispatchDomainEventDiskChangeCallbackSs0D\! 44*JHV\]r"c<USnUSnU"U[XS9X#U5 g)zJDispatches event to python user domain trayChange event callbacks r|rgrZrrQ)rrJr_rdryr|rgs r &_dispatchDomainEventTrayChangeCallback1virConnect._dispatchDomainEventTrayChangeCallback\s-D\! 44*HfEr"c:USnUSnU"U[XS9X%5 g)zHDispatches event to python user domain pmwakeup event callbacks r|rgrZrrQrrJrdryr|rgs r $_dispatchDomainEventPMWakeupCallback/virConnect._dispatchDomainEventPMWakeupCallbackerZr"c:USnUSnU"U[XS9X%5 g)zIDispatches event to python user domain pmsuspend event callbacks r|rgrZrrQr}s r %_dispatchDomainEventPMSuspendCallback0virConnect._dispatchDomainEventPMSuspendCallbacknrZr"actualc:USnUSnU"U[XS9X%5 g)zODispatches events to python user domain balloon change event callbacks r|rgrZrrQ)rrJrryr|rgs r )_dispatchDomainEventBalloonChangeCallback4virConnect._dispatchDomainEventBalloonChangeCallbackwrZr"c:USnUSnU"U[XS9X%5 g)zNDispatches event to python user domain pmsuspend-disk event callbacks r|rgrZrrQr}s r )_dispatchDomainEventPMSuspendDiskCallback4virConnect._dispatchDomainEventPMSuspendDiskCallbackrZr"c:USnUSnU"U[XS9X%5 g)zNDispatches event to python user domain device removed event callbacks r|rgrZrrQrrJr_ryr|rgs r )_dispatchDomainEventDeviceRemovedCallback4virConnect._dispatchDomainEventDeviceRemovedCallback+D\! 44*H=r"r2c:USnUSnU"U[XS9X%5 g)zGDispatches event to python user domain tunable event callbacks r|rgrZrrQrrJr2ryr|rgs r #_dispatchDomainEventTunableCallback.virConnect._dispatchDomainEventTunableCallbackrZr"r(c<USnUSnU"U[XS9X#U5 g)zNDispatches event to python user domain agent lifecycle event callback r|rgrZrrQ)rrJr(rdryr|rgs r *_dispatchDomainEventAgentLifecycleCallback5virConnect._dispatchDomainEventAgentLifecycleCallbacks-D\! 44*E6Br"c:USnUSnU"U[XS9X%5 g)zLDispatches event to python user domain device added event callbacks r|rgrZrrQrs r '_dispatchDomainEventDeviceAddedCallback2virConnect._dispatchDomainEventDeviceAddedCallbackrr" iterationc:USnUSnU"U[XS9X%5 g)zSDispatches event to python user domain migration iteration event callbacks r|rgrZrrQ)rrJrryr|rgs r ._dispatchDomainEventMigrationIterationCallback9virConnect._dispatchDomainEventMigrationIterationCallbacks+D\! 44*I>r"c:USnUSnU"U[XS9X%5 g)zGDispatches event to python user domain job completed callbacks r|rgrZrrQrs r (_dispatchDomainEventJobCompletedCallback3virConnect._dispatchDomainEventJobCompletedCallbackrZr"c:USnUSnU"U[XS9X%5 g)zUDispatches event to python user domain device removal failed event callbacks r|rgrZrrQrs r /_dispatchDomainEventDeviceRemovalFailedCallback:virConnect._dispatchDomainEventDeviceRemovalFailedCallbackrr"mtypensuric<USnUSnU"U[XS9X#U5 g)zODispatches event to python user domain metadata change event callbacks r|rgrZrrQrrJrrryr|rgs r *_dispatchDomainEventMetadataChangeCallback5virConnect._dispatchDomainEventMetadataChangeCallbacks-D\! 44*E&Ar"r"r8r#excessc >USnUSnU"U[XS9X#XEU5 g)zVDispatches event to python user domain block device threshold event callbacks r|rgrZrrQ) rrJr"r8r#rryr|rgs r *_dispatchDomainEventBlockThresholdCallback5virConnect._dispatchDomainEventBlockThresholdCallbacks/D\! 44*Cy&Qr" recipientrXc<USnUSnU"U[XS9X#XG5 g)zNDispatches event to python user domain memory failure event callbacks r|rgrZrrQ)rrJrr9rXryr|rgs r )_dispatchDomainEventMemoryFailureCallback4virConnect._dispatchDomainEventMemoryFailureCallbacks-D\! 44*IuMr"rrQc<USnUSnU"U[XS9X#U5 g)zYDispatches event to python user domain memory device size change event callbacks r|rgrZrrQ)rrJrrQryr|rgs r 2_dispatchDomainEventMemoryDeviceSizeChangeCallback=virConnect._dispatchDomainEventMemoryDeviceSizeChangeCallbacks-D\! 44*E@r"oldMACnewMACc<USnUSnU"U[XS9X#XG5 g)zNDispatches event to python user domain NIC MAC change event callbacks r|rgrZrrQ)rrJrrrryr|rgs r (_dispatchDomainEventNICMACChangeCallback3virConnect._dispatchDomainEventNICMACChangeCallbacks-D\! 44*E6Jr" callbackIDc[R"URU5nUS:Xa [S5eURU g![ a gf=f)rArz+virConnectDomainEventDeregisterAny() failedN)r"virConnectDomainEventDeregisterAnyrrdomainEventCallbackIDr5rrr]s r domainEventDeregisterAny#virConnect.domainEventDeregisterAnyP ??TCby"#PQQ**:6   ?A AArTrc<USnUSnU"U[XS9X#U5 g)zKDispatches events to python user network lifecycle event callbacks r|rgrZrr)rrTrfrKryr|rgs r &_dispatchNetworkEventLifecycleCallback1virConnect._dispatchNetworkEventLifecycleCallbacks-D\! 4D+UFCr"c<USnUSnU"U[XS9X#U5 g)zPDispatches event to python user network metadata change event callbacks r|rgrZrrrs r +_dispatchNetworkEventMetadataChangeCallback6virConnect._dispatchNetworkEventMetadataChangeCallback s-D\! 4D+U6Br"c[R"URU5nUS:Xa [S5eURU g![ a gf=f)zpRemoves a Network Event Callback. De-registering for a network callback will disable delivery of this event typerz,virConnectNetworkEventDeregisterAny() failedN)r#virConnectNetworkEventDeregisterAnyrrnetworkEventCallbackIDr5rs r networkEventDeregisterAny$virConnect.networkEventDeregisterAnysP @@*UCby"#QRR++J7   reventIDc"[US5(d0UlX0US.nUc#[R"URSX%5nO,[R"URURX%5nUS:Xa [ S5eX@RU'U$)zdAdds a Network Event Callback. Registering for a network callback will enable delivery of the eventsrr|rrgNrz*virConnectNetworkEventRegisterAny() failed)hasattrrr!virConnectNetworkEventRegisterAnyrr)rrTrr|rgryr]s r networkEventRegisterAny"virConnect.networkEventRegisterAnyst566*,D 'F; ;>>twwg^C>>twwPW`C "9KL L+1##C( r"c"[US5(d0UlX0US.nUc#[R"URSX%5nO,[R"URURX%5nUS:Xa [ S5eX@RU'U$)rFrrNrz)virConnectDomainEventRegisterAny() failed)rrr virConnectDomainEventRegisterAnyrr)rrJrr|rgryr]s r domainEventRegisterAny!virConnect.domainEventRegisterAny-st455)+D &F; ;==dggtW]C==dggsvvw_C "9JK K*0""3' r"poolrc<USnUSnU"U[XS9X#U5 g)zHDispatches events to python user storage pool lifecycle event callbacks r|rgrZrr)rrrfrKryr|rgs r *_dispatchStoragePoolEventLifecycleCallback5virConnect._dispatchStoragePoolEventLifecycleCallback<s-D\! 40%Hr"c:USnUSnU"U[XS9U5 g)zFDispatches events to python user storage pool generic event callbacks r|rgrZrr)rrryr|rgs r (_dispatchStoragePoolEventGenericCallback3virConnect._dispatchStoragePoolEventGenericCallbackFs+D\! 40&9r"c[R"URU5nUS:Xa [S5eURU g![ a gf=f)zzRemoves a Storage Pool Event Callback. De-registering for a storage pool callback will disable delivery of this event typerz0virConnectStoragePoolEventDeregisterAny() failedN)r'virConnectStoragePoolEventDeregisterAnyrrstoragePoolEventCallbackIDr5rs r storagePoolEventDeregisterAny(virConnect.storagePoolEventDeregisterAnyPsP DDTWWjYCby"#UVV// ;   rc"[US5(d0UlX0US.nUc#[R"URSX%5nO,[R"URURX%5nUS:Xa [ S5eX@RU'U$)znAdds a Storage Pool Event Callback. Registering for a storage pool callback will enable delivery of the eventsrrNrz.virConnectStoragePoolEventRegisterAny() failed)rrr%virConnectStoragePoolEventRegisterAnyrr)rrrr|rgryr]s r storagePoolEventRegisterAny&virConnect.storagePoolEventRegisterAny[st9::.0D +F; <BB477DRYbCBB477DGGU\eC "9OP P/5'', r"rqc<USnUSnU"U[XS9X#U5 g)zGDispatches events to python user node device lifecycle event callbacks r|rgrZrrq)rr"rfrKryr|rgs r )_dispatchNodeDeviceEventLifecycleCallback4virConnect._dispatchNodeDeviceEventLifecycleCallbackjs-D\! 4t.vFr"c:USnUSnU"U[XS9U5 g)zEDispatches events to python user node device generic event callbacks r|rgrZrr)rr"ryr|rgs r '_dispatchNodeDeviceEventGenericCallback2virConnect._dispatchNodeDeviceEventGenericCallbackts+D\! 4t.7r"c[R"URU5nUS:Xa [S5eURU g![ a gf=f)zxRemoves a Node Device Event Callback. De-registering for a node device callback will disable delivery of this event typerz/virConnectNodeDeviceEventDeregisterAny() failedN)r&virConnectNodeDeviceEventDeregisterAnyrrnodeDeviceEventCallbackIDr5rs r nodeDeviceEventDeregisterAny'virConnect.nodeDeviceEventDeregisterAny~sP CCDGGZXCby"#TUU..z:   rc"[US5(d0UlX0US.nUc#[R"URSX%5nO,[R"URURX%5nUS:Xa [ S5eX@RU'U$)zlAdds a Node Device Event Callback. Registering for a node device callback will enable delivery of the eventsrrNrz-virConnectNodeDeviceEventRegisterAny() failed)rrr$virConnectNodeDeviceEventRegisterAnyrr)rr"rr|rgryr]s r nodeDeviceEventRegisterAny%virConnect.nodeDeviceEventRegisterAnyst899-/D *F; ;AA$''4QXaCAA$''366SZcC "9NO O.4&&s+ r"secretrc<USnUSnU"U[XS9X#U5 g)zJDispatches events to python user secret lifecycle event callbacks r|rgrZrr)rrrfrKryr|rgs r %_dispatchSecretEventLifecycleCallback0virConnect._dispatchSecretEventLifecycleCallbacks-D\! 44-ufEr"c:USnUSnU"U[XS9U5 g)zHDispatches events to python user secret generic event callbacks r|rgrZrr)rrryr|rgs r #_dispatchSecretEventGenericCallback.virConnect._dispatchSecretEventGenericCallbacks+D\! 44-v6r"c[R"URU5nUS:Xa [S5eURU g![ a gf=f)znRemoves a Secret Event Callback. De-registering for a secret callback will disable delivery of this event typerz+virConnectSecretEventDeregisterAny() failedN)r"virConnectSecretEventDeregisterAnyrrsecretEventCallbackIDr5rs r secretEventDeregisterAny#virConnect.secretEventDeregisterAnyrrc"[US5(d0UlX0US.nUc#[R"URSX%5nO,[R"URURX%5nUS:Xa [ S5eX@RU'U$)zbAdds a Secret Event Callback. Registering for a secret callback will enable delivery of the eventsrrNrz)virConnectSecretEventRegisterAny() failed)rrr virConnectSecretEventRegisterAnyrr)rrrr|rgryr]s r secretEventRegisterAny!virConnect.secretEventRegisterAnyst455)+D &F; >==dggtW]C==dggvyyRYbC "9JK K*0""3' r"c[R"URU5nUc [S5eUVs/sH n[ XS9PM sn$s snf)z5List all domains and returns a list of domain objectsz!virConnectListAllDomains() failedrZ)rvirConnectListAllDomainsrrrrMs r listAllDomainsvirConnect.listAllDomainssF11$''5A ;BC C;>?3 $,3???rc[R"URU5nUc [S5eUVs/sH n[ XS9PM sn$s snf)z&Returns a list of storage pool objectsz&virConnectListAllStoragePools() failedrZ)rvirConnectListAllStoragePoolsrrr)rrXr]poolptrs r listAllStoragePoolsvirConnect.listAllStoragePoolssF66twwF ;GH HBEF#wt2#FFFrc[R"URU5nUc [S5eUVs/sH n[ XS9PM sn$s snf)z!Returns a list of network objectsz"virConnectListAllNetworks() failedrZ)rvirConnectListAllNetworksrrr)rrXr]netptrs r listAllNetworksvirConnect.listAllNetworkssF22477EB ;CD Dn[U[5(d [S5eUR UR 5 M@ [ R"UR XBU5nUc [S5eUVs/sHn[XSS9US4PM sn$s snf)ayQuery 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 elementszvirDomainListGetStats() failedrrZr+)listrorrappendrrvirDomainListGetStats)rrGrArXdomlistrJr]rDs r domainListGetStatsvirConnect.domainListGetStatsjs:&Cc9--"#MNN NN366 "  ..twwN ;?@ @EHIST41g.Q8SIIIsB!)rrr2rrrrrj)rrrr)NNNNrr$r|rrr)rIrJrKrLrrrHrMrVrZr^rbrfrkrprvrr~rrrrrrrrrrrrrrrrrrrrrrrrrcrrrrrrrr rrrrr"r'r+r/r3r9r=rBrHrNrRrWr[r_rdrhrmrrrvrzrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrLrr rrrrr!r%r)r,r/rr8rr BaseExceptionrr> _DomainCBrCrrHrNrNrrMrrRrUrXr\rbrfrnrrrwrzr~rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rr rrrr!r'r+r0r3r7r;r?r rErMrOrPr"r rrFs 6    &  $@  ( &     ",           ,    &     B,  (  "4         &2 (4 +>"?XVcMdrz|IsJOS  d  Mi M M MSRUZ^SZ]gkloqtltguz}{DQTVYQYN_bc[_`ceh`h[inq SZ^_bdg_gZhmp{S\_ilvz{~AD|DwEJM[SVbeor|JNORTWOWJX]` C\_mpBMPZ^_bdg_gZhmp  3 VY cf ptuxz}u}p~ DH +SVdgsvADNRSVX[S[N\ad+QT^akopsuxpxkyB SZ^_bdg_gZhmpc[_`ceh`h[inq[RU_cdgildl_mru[RU_cdgildl_mru[TWaefiknfnaotw{CY]^acf^fYglokRU_blpqtvyqylz@C;RU_cdgildl_mru+Z]gkloqtltguz}KQUVY[^V^Q_imnqsvnviw|;Z]gkloqtltguz}kRU^akopsuxpxkyBkPS[^knx{FJKNPSKSFTY\[UXbenq{ADFIAI|JORkZ]ehrvwz|wsAFIKPS]`jmw{|BE}ExFKN 3 4 ,s\_imnqsvnviw||TW`cmqruwzrzm{AD C D  8L+A C U] gi nq  (;*? # S[ eg lo ?OX[ehrvwz|wsAFI=MW[\_ad\dWejm    9I0J UX ^f pr wz _UXbeostwy|t|o}CF?TXY\^aYaTbgj s t  h.G RU [c mo tw KPS]`jnortwowjx~A+tTWY\T\~be 3 4  Xk-B S V^ hj or @C@[0A@GGT:J5KGASAl1CAGsG43GGDCD_0EDJcJ$}2EJQSQ>R9SQHCH[0AHS$sCx.SM "#d3iT_>.Js.Js.J4k[_`ceh`h[iNiHjCk.J`(JtK'8(J(JQT(J]abghsuyz}@C{CvDiDcE^F(J(Jr"c\rSrSrSSjrSrSrSrSSjrSr SS jr S r SS jr S r S rSrSrSrSrSrSrSrSrSSjrSSjrSrg)rqiNc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirNodeDevice.__init__rr"clURb [R"UR5 SUlgrj)rrvirNodeDeviceFreer&s r rvirNodeDevice.__del__rr"cUR$rjrr&s r rvirNodeDevice.connectrr"cB[R"UR5$r)rvirNodeDevice_pointerrr&s r rvirNodeDevice.c_pointerrr"cd[R"URU5nUc [S5eU$)z? ? r"cj[R"URX5nUS:Xa [S5eU$)aDetach 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. rz!virNodeDeviceDetachFlags() failed)rvirNodeDeviceDetachFlagsrr)r driverNamerXr]s r detachFlagsvirNodeDevice.detachFlagss2"11$'':M "9BC C r"ch[R"UR5nUS:Xa [S5eU$)aDetach 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. rzvirNodeDeviceDettach() failed)rvirNodeDeviceDettachrrrs r dettachvirNodeDevice.dettachs0$--dgg6 "9>? ? r"ch[R"UR5nUS:Xa [S5eU$)z1Determine if the node device is currently active rzvirNodeDeviceIsActive() failed)rvirNodeDeviceIsActiverrrs r rvirNodeDevice.isActiverr"ch[R"UR5nUS:Xa [S5eU$)zpDetermine if the node device has a persistent configuration which means it will still exist after shutting down rz"virNodeDeviceIsPersistent() failed)rvirNodeDeviceIsPersistentrrrs r rvirNodeDevice.isPersistents022477; "9CD D r"cb[R"UR5nUc [S5eU$)z$list the node device's capabilities zvirNodeDeviceListCaps() failed)rvirNodeDeviceListCapsrrrs r listCapsvirNodeDevice.listCapsrhr"cF[R"UR5nU$)zJust return the device name )rvirNodeDeviceGetNamerrs r r_virNodeDevice.names--dgg6 r"ch[R"UR5nUS:Xa [S5eU$)zAAccessor for the number of capabilities supported by the device. rzvirNodeDeviceNumOfCaps() failed)rvirNodeDeviceNumOfCapsrrrs r numOfCapsvirNodeDevice.numOfCaps"rr"cF[R"UR5nU$)z&Accessor for the parent of the device )rvirNodeDeviceGetParentrrs r parentvirNodeDevice.parent)s//8 r"ch[R"UR5nUS:Xa [S5eU$)aQRe-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. rzvirNodeDeviceReAttach() failed)rvirNodeDeviceReAttachrrrs r reAttachvirNodeDevice.reAttach.s0..tww7 "9?@ @ r"ch[R"UR5nUS:Xa [S5eU$)aReset 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. rzvirNodeDeviceReset() failed)rvirNodeDeviceResetrrrs r rvirNodeDevice.reset<s0++DGG4 "9<= = r"cj[R"URU5nUS:Xa [S5eU$)zzConfigure the node device to be automatically started when the host machine boots or the parent device becomes available. rz"virNodeDeviceSetAutostart() failed)rvirNodeDeviceSetAutostartrrrs r rvirNodeDevice.setAutostartLrr"cj[R"URU5nUS:Xa [S5eU$)zUndefine the device object. The virtual device is removed from the host operating system. This function may require privileged access. rzvirNodeDeviceUndefine() failed)rvirNodeDeviceUndefinerrrs r rvirNodeDevice.undefineTs2..tww> "9?@ @ r"cj[R"URX5nUS:Xa [S5eU$)zUpdate the definition of an existing node device, either its live running configuration, its persistent configuration, or both. rzvirNodeDeviceUpdate() failed)rvirNodeDeviceUpdaterrrjs r rIvirNodeDevice.update\s2,,TWWgE "9=> > r"rrjr)rIrJrKrLrrrrrrrrrlrprrrzr_rrrrrrrIrOrPr"r rqrqsk  9,.   r"rqcl\rSrSrSSjrSrSrSrSrSr SS jr SS jr S r S r S rSSjrSrg)ridNc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirSecret.__init__err"clURb [R"UR5 SUlgrj)rr virSecretFreer&s r rvirSecret.__del__krr"cUR$rjrr&s r rvirSecret.connectprr"cB[R"UR5$r)rvirSecret_pointerrr&s r rvirSecret.c_pointersrr"cb[R"UR5nUc [S5eU$)z0Extract the UUID unique Identifier of a secret. zvirSecretGetUUID() failed)rvirSecretGetUUIDrrrs r rvirSecret.UUID{rr"cb[R"UR5nUc [S5eU$)z4Fetch globally unique ID of the secret as a string. zvirSecretGetUUIDString() failed)rvirSecretGetUUIDStringrrrs r rvirSecret.UUIDStringrr"cd[R"URU5nUc [S5eU$)z=Fetches an XML document describing attributes of the secret. zvirSecretGetXMLDesc() failed)rvirSecretGetXMLDescrrrs r rvirSecret.XMLDescs.,,TWWe< ;=> > r"cj[R"URX5nUS:Xa [S5eU$)z"Associates a value with a secret. rzvirSecretSetValue() failed)rvirSecretSetValuerr)rvaluerXr]s r setValuevirSecret.setValues0**477EA "9;< < r"ch[R"UR5nUS:Xa [S5eU$)zVDeletes the specified secret. This does not free the associated virSecretPtr object. rzvirSecretUndefine() failed)rvirSecretUndefinerrrs r rvirSecret.undefines0**4773 "9;< < r"cF[R"UR5nU$)aGet 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. )rvirSecretGetUsageIDrrs r rvirSecret.usageIDs,,TWW5 r"cF[R"UR5nU$)aGet 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. )rvirSecretGetUsageTyperrs r rvirSecret.usageTypes ..tww7 r"cd[R"URU5nUc [S5eU$)z,Fetches the value associated with a secret. zvirSecretGetValue() failed)rvirSecretGetValuerrrs r rvirSecret.valuerr"rrjr)rIrJrKrLrrrrrrrrrrrrrOrPr"r rrds>  5 r"rcR\rSrSrS SjrSrSrSrSrSr SS jr S r S r S r g)riNc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirNWFilter.__init__rr"clURb [R"UR5 SUlgrj)rrvirNWFilterFreer&s r rvirNWFilter.__del__s% 77   & &tww /r"cUR$rjrr&s r rvirNWFilter.connectrr"cB[R"UR5$r)rvirNWFilter_pointerrr&s r rvirNWFilter.c_pointers--dgg66r"cb[R"UR5nUc [S5eU$)z8Extract the UUID unique Identifier of a network filter. zvirNWFilterGetUUID() failed)rvirNWFilterGetUUIDrrrs r rvirNWFilter.UUIDrr"cb[R"UR5nUc [S5eU$)z ;?@ @ r"cF[R"UR5nU$)z+Get the public name for the network filter )rvirNWFilterGetNamerrs r r_virNWFilter.names++DGG4 r"ch[R"UR5nUS:Xa [S5eU$)zUndefine the nwfilter object. This call will not succeed if a running VM is referencing the filter. This does not free the associated virNWFilterPtr object. rzvirNWFilterUndefine() failed)rvirNWFilterUndefinerrrs r rvirNWFilter.undefines0,,TWW5 "9=> > r"rrjr)rIrJrKrLrrrrrrrr_rrOrPr"r rrs/  7 r"rcL\rSrSrS SjrSrSrSrS SjrSr S r S r S r g)ri Nc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirNWFilterBinding.__init__ rr"clURb [R"UR5 SUlgrj)rrvirNWFilterBindingFreer&s r rvirNWFilterBinding.__del__s% 77   - -dgg 6r"cUR$rjrr&s r rvirNWFilterBinding.connectrr"cB[R"UR5$r)rvirNWFilterBinding_pointerrr&s r rvirNWFilterBinding.c_pointers44TWW==r"cd[R"URU5nUc [S5eU$)rz%virNWFilterBindingGetXMLDesc() failed)rvirNWFilterBindingGetXMLDescrrrs r rvirNWFilterBinding.XMLDesc!s055dgguE ;FG G r"ch[R"UR5nUS:Xa [S5eU$)avDelete 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. rz!virNWFilterBindingDelete() failed)rvirNWFilterBindingDeleterrrs r rrvirNWFilterBinding.delete)s011$'': "9BC C r"cF[R"UR5nU$)z3Get the filter name for the network filter binding )rvirNWFilterBindingGetFilterNamerrs r filterNamevirNWFilterBinding.filterName6s88A r"cF[R"UR5nU$)z5Get the port dev name for the network filter binding )rvirNWFilterBindingGetPortDevrrs r portDevvirNWFilterBinding.portDev;s55dgg> r"rrjr) rIrJrKrLrrrrrrrrrrOrPr"r rr s*  >  r"rc \rSrSrS#SjrSrSrSrSrSr S r S$S jr S \ S \ \\4S \ 4SjrS \ S\S\ \/S4S\S S4SjrS\S\\/\ 4S\S S4SjrS\S\ \/\4S\S S4SjrS\ S \4SjrS\S \ 4SjrS%S\ S \ 4SjjrS%S\ S\ S \ 4SjjrS%S\ S\ S \\\ 44SjjrS\S\\/\\\ 44S\S\ \/\\ 4S\S S4SjrS\S\ \/\\\ 44S\S\/\\ \ 44S \S\ \/\ 4S\S S4 S!jr!S"r"g)&rli@Nc|Xl[U5RS;a[S[U5-5eX lgrrrs r rvirStream.__init__Arr"cUR$rjrr&s r rvirStream.connectGrr"cB[R"UR5$r)rvirStream_pointerrr&s r rvirStream.c_pointerJrr"ch[R"UR5nUS:Xa [S5eU$)ayRequest 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. rzvirStreamAbort() failed)rvirStreamAbortrrrs r abortvirStream.abortRs0''0 "989 9 r"ch[R"UR5nUS:Xa [S5eU$)z)Remove an event callback from the stream rz%virStreamEventRemoveCallback() failed)rvirStreamEventRemoveCallbackrrrs r eventRemoveCallbackvirStream.eventRemoveCallbackas.55dgg> "9FG G r"cj[R"URU5nUS:Xa [S5eU$)zChanges 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 rz%virStreamEventUpdateCallback() failed)rvirStreamEventUpdateCallbackrr)rrxr]s r eventUpdateCallbackvirStream.eventUpdateCallbackhs2 55dggvF "9FG G r"ch[R"UR5nUS:Xa [S5eU$)aIndicate 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. rzvirStreamFinish() failed)rvirStreamFinishrrrs r finishvirStream.finishrs0((1 "99: : r"rcUR(a [R"UR5 URb [R "UR5 SUlg![a NAf=frj)r|rrrr5 virStreamFreer&s r rvirStream.__del__sY ww77@ 77   $ $TWW -    s1A(( A54A5rxryc*USnUSnU"XU5 g)z; Dispatches events to python user's stream event callbacks r|rgrrP)rrxryr|rgs r _dispatchStreamEventCallback&virStream._dispatchStreamEventCallbacks$D\! 4 r"r|rgc~X lXUS.n[R"URX5nUS:Xa [ S5eg)N)rr|rgrz"virStreamEventAddCallback() failed)r|rvirStreamEventAddCallbackrr)rrxr|rgryr]s r eventAddCallbackvirStream.eventAddCallbacks? f=22477FK "9CD D r"handlercNUR[R5nUS:Xa [S5e[ U5S:XagU"XU5n[ U[ 5(aUS:a[SU-5eMu![a# UR5 e![a ef=ff=f)aReceive 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) z*cannot use recvAll with nonblocking streamrzrecvAll handler returned %dN) recvrr<rrBrorN RuntimeErrorrPrrrr rggotr]s r recvAllvirStream.recvAlls))M778Cby"$8993x1} d0c3''C!G&'Ds'JKK! JJL! s02A77 B$BB$ B B$B  B$cU"U[RU5nU(dgUR U5nUS:Xa [ S5eME![a# UR5 e![a ef=ff=f)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 streamN)rr<rPrrsendrr s r sendAllvirStream.sendAlls dM$?$?H))C.Cby"$899! JJL! s/A A4A#"A4# A0-A4/A00A4nbytescd[R"URU5nUc [S5eU$)aReads 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. zvirStreamRecv() failed)r virStreamRecvrr)rr r]s r r virStream.recvs0&&tww7 ;78 8 r"datacj[R"URU5nUS:Xa [S5eU$)aWrite 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. rzvirStreamSend() failed)r virStreamSendrr)rr# r]s r r virStream.sends2&&tww5 "978 8 r"rXcd[R"URU5nUc [S5eU$)zThis 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. zvirStreamRecvHole() failed)rvirStreamRecvHolerrrs r recvHolevirStream.recvHoles0 **477E: ;;< < r"rcj[R"URX5nUS:Xa [S5eU$)zRather 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. rzvirStreamSendHole() failed)rvirStreamSendHolerr)rrrXr]s r sendHolevirStream.sendHoles2**477FB "9;< < r"cd[R"URX5nUc [S5eU$)aReads 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. zvirStreamRecvFlags() failed)rvirStreamRecvFlagsrr)rr rXr]s r recvFlagsvirStream.recvFlagss0++DGGVC ;<= = r" holeHandlerc[RnURU[5nUS:Xa [ S5eUS:XarUR 5nUcUR 5 [S5eU"XU5n[U[5(a$US:aUR 5 [SU-5eM[U[5(a [U5e[U[5(d[[U55e[U5S:XagU"XU5n[U[5(a$US:aUR 5 [SU-5eGMM) aReceive 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 streamNzrecvHole handler failedrzholeHandler handler returned %dz!sparseRecvAll handler returned %d)rr<r1 VIR_STREAM_RECV_STOP_AT_HOLErr) rr rorN ValueErrorbytes TypeErrorrrB) rr r3 rgwantr rret_holeret_datas r sparseRecvAllvirStream.sparseRecvAll1s#. ..D..'CDCby"$899>JJL&'@AA&tV<h,,AJJL&'H8'STTC%% o%U++S **3x1}t&1H(C((X\ "#F#QRR7r" skipHandlercU"X5upVU(d:US:a4URU5S:d U"XU5S:aUR5 ML[RnXv:aUnU"XU5n[ U[ 5(a$US:aUR5 [ SU-5eU(dg[ U[5(deURU5n U S:Xa [S5eM)aSSend 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) rz!sparseSendAll handler returned %dr z0cannot use sparseSendAll with nonblocking streamN) r- rrr<rorNr r8 r r) rr r3 r? rginData sectionLenr: r r]s r sparseSendAllvirStream.sparseSendAlles<#.t#< Vj1nMM*-1#Df=AJJL ..D!!$f-C#s##a "#F#LMMc5)) ))))C.Cby"$899/r")rrr|rjr|r)#rIrJrKrLrrrrrr r rrNrrMrr rrr r8 r r r r r) r- r r1 rr= r boolrC rOrPr"r rlrl@s 5 ( 3S#XSVEsE+sB9OQU9U0VE`bEgkExeR(@#(EFPRW[@9xc2(>(EF9PR9W[9@35$3& c #  s 3 s CeSj8I&2SX{E2.FeUXjHY.Y%Z2Siqs~ADFHsIKSTWKXsXjY2Sce2Sjn2Sh69X{C.DeESVJFW.W%X69goq|AqBDIJNPSJSDTqThU69dlny{~@BmCEHmHdI69SU69Z^69r"rlc\rSrSrSSjrSrSrSrSrSSjr S r SS jr SS jr SS jr SSjrSS\S \S4SjjrSrg)rkiNcXlUR5Ul[U5RS;a[ S[U5-5eX lgr_domrrrrIrrrrJr[s r rvirDomainCheckpoint.__init__rVr"clURb [R"UR5 SUlgrj)rrvirDomainCheckpointFreer&s r rvirDomainCheckpoint.__del__s% 77   . .tww 7r"cUR$rjrr&s r rvirDomainCheckpoint.connectrr"cUR$rjrI r&s r domainvirDomainCheckpoint.domainr`r"cB[R"UR5$r)rvirDomainCheckpoint_pointerrr&s r rvirDomainCheckpoint.c_pointers55dgg>>r"cj[R"URU5nUS:Xa [S5eU$)aRemoves 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. rz"virDomainCheckpointDelete() failed)rvirDomainCheckpointDeleterrrs r rrvirDomainCheckpoint.deletes2$22477EB "9CD D r"cb[R"UR5nUc [S5eU$)z(Get the public name for that checkpoint z#virDomainCheckpointGetName() failed)rvirDomainCheckpointGetNamerrrs r getNamevirDomainCheckpoint.getNamer5r"c[R"URU5nUc [S5e[ UR US9nU$)zGet the parent checkpoint for @checkpoint, if any. virDomainCheckpointFree should be used to free the resources after the checkpoint object is no longer needed. z%virDomainCheckpointGetParent() failedrZ)rvirDomainCheckpointGetParentrrrkrI )rrXr]_virDomainCheckpoint__tmps r getParentvirDomainCheckpoint.getParents@ 55dgguE ;FG G#DIIC8 r"cd[R"URU5nUc [S5eU$)aProvide 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 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. z&virDomainCheckpointGetXMLDesc() failed)rvirDomainCheckpointGetXMLDescrrrs r getXMLDescvirDomainCheckpoint.getXMLDescs0*66twwF ;GH H r"rc"UR5$)zIGet the connection that owns the domain that a checkpoint was created forrr&s r getConnectvirDomainCheckpoint.getConnect||~r"c"UR5$)z0Get the domain that a checkpoint was created forrS r&s r getDomainvirDomainCheckpoint.getDomain{{}r"rXc[R"URU5nUc [S5eUVs/sHn[ UR 5US9PM sn$s snf)zCList all child checkpoints and returns a list of checkpoint objectsz+virDomainCheckpointListAllChildren() failedrZ)r"virDomainCheckpointListAllChildrenrrrkrS rs r listAllChildren#virDomainCheckpoint.listAllChildrensO;;DGGUK ;LM MNQRcF#DKKM?cRRR"ArrI rrjrrOrr)rIrJrKrLrrrrS rrrr] rb rf rj ro rNrrt rOrPr"r rkrks[ ?. :SSS6K1LSSr"rkc\rSrSrSSjrSrSrSrSrSSjr S r SS jr SS jr SS jr SS jrSSjrSSjrSSjrSSjrSS\S\S4SjjrSrg)riNcXlUR5Ul[U5RS;a[ S[U5-5eX lgrrH rJ s r rvirDomainSnapshot.__init__rVr"clURb [R"UR5 SUlgrj)rrvirDomainSnapshotFreer&s r rvirDomainSnapshot.__del__s% 77   , ,TWW 5r"cUR$rjrr&s r rvirDomainSnapshot.connectrr"cUR$rjrR r&s r rS virDomainSnapshot.domainr`r"cB[R"UR5$r)rvirDomainSnapshot_pointerrr&s r rvirDomainSnapshot.c_pointer!s33DGG<. No security-sensitive data will be included unless @flags contains VIR_DOMAIN_SNAPSHOT_XML_SECURE; this flag is rejected on read-only connections. z$virDomainSnapshotGetXMLDesc() failed)rvirDomainSnapshotGetXMLDescrrrs r rf virDomainSnapshot.getXMLDescWs044TWWeD ;EF F r"cj[R"URU5nUS:Xa [S5eU$)zsDetermine if the given snapshot is associated with libvirt metadata that would prevent the deletion of the domain. rz%virDomainSnapshotHasMetadata() failed)rvirDomainSnapshotHasMetadatarrrs r hasMetadatavirDomainSnapshot.hasMetadatacs255dgguE "9FG G r"cj[R"URU5nUS:Xa [S5eU$)zkDetermine if the given snapshot is the domain's current snapshot. See also virDomainHasCurrentSnapshot(). rz#virDomainSnapshotIsCurrent() failed)rvirDomainSnapshotIsCurrentrrrs r isCurrentvirDomainSnapshot.isCurrentks233DGGUC "9DE E r"cd[R"URU5nUc [S5eU$)z@collect the list of child snapshot names for the given snapshot z+virDomainSnapshotListChildrenNames() failed)r"virDomainSnapshotListChildrenNamesrrrs r listChildrenNames#virDomainSnapshot.listChildrenNamesws.;;DGGUK ;LM M r"cj[R"URU5nUS:Xa [S5eU$)aProvides 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(). rz%virDomainSnapshotNumChildren() failed)rvirDomainSnapshotNumChildrenrrrs r numChildrenvirDomainSnapshot.numChildrens255dgguE "9FG G r"rc"UR5$)zGGet the connection that owns the domain that a snapshot was created forri r&s r rj virDomainSnapshot.getConnectrl r"c"UR5$)z.Get the domain that a snapshot was created forrn r&s r ro virDomainSnapshot.getDomainrq r"rXc[R"URU5nUc [S5eUVs/sHn[ UR 5US9PM sn$s snf)z?List all child snapshots and returns a list of snapshot objectsz)virDomainSnapshotListAllChildren() failedrZ)r virDomainSnapshotListAllChildrenrrrrS rs r rt !virDomainSnapshot.listAllChildrensO99$''5I ;JK KNQRc7!$++-g>cRRRrv rw rjrrOrx )rIrJrKrLrrrrS rrrr] rb rf r r r r rj ro rNrrt rOrPr"r rrso =8  (SSS6I1JSSr"rr+rr2r6r:r>rrBrF  @i i@liiiii i@iiiiiii i@iir !"#$%&'()*+r-./0123456789:;<=>?ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqz 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.peakdevice_read_bytes_secdevice_read_iops_sec device_weightdevice_write_bytes_secdevice_write_iops_secweightr,zbuf-size granularity group_nameread_bytes_secread_bytes_sec_maxread_bytes_sec_max_length read_iops_secread_iops_sec_maxread_iops_sec_max_length size_iops_sectotal_bytes_sectotal_bytes_sec_maxtotal_bytes_sec_max_lengthtotal_iops_sectotal_iops_sec_maxtotal_iops_sec_max_lengthwrite_bytes_secwrite_bytes_sec_maxwrite_bytes_sec_max_lengthwrite_iops_secwrite_iops_sec_maxwrite_iops_sec_max_lengtherrsflush_operationsflush_total_timesrd_bytes rd_operationsrd_total_timeswr_bytes wr_operationswr_total_timescpu_time system_time user_time vcpu_timez disk.countzdisk.z.aliasz.dependency.countz .dependency.z.namez .guest_aliasz .guest_busz .partitionz.serialzfs.countzfs.z .disk.countz.disk.z.devicez.fstypez .mountpointz .total-bytesz .used-bytesrzif.countzif.z .addr.countz.addr.z.addrz.prefixz.typez.hwaddrzload.15mzload.1mzload.5mzos.idzos.kernel-releasezos.kernel-versionz os.machinezos.namezos.pretty-namez os.variantz os.variant-idz os.versionz os.version-idz timezone.nameztimezone.offsetz user.countzuser.z.domainz .login-time poll_grow poll_max_ns poll_shrinkthread_pool_maxthread_pool_minauto_converge_throttlecompression_bytescompression_cachecompression_cache_missescompression_overflowcompression_pagesdata_processeddata_remaining data_totaldisk_bpsdisk_processeddisk_remainingdisk_temp_totaldisk_temp_used disk_totalrd downtime_neterrmsg memory_bpsmemory_constantmemory_dirty_ratememory_iteration memory_normalmemory_normal_bytesmemory_page_sizememory_postcopy_requestsmemory_processedmemory_remaining memory_total operation setup_timesuccess time_elapsedtime_elapsed_nettime_remainingvfio_data_transferredz sev-api-majorz sev-api-minorz sev-build-idzsev-measurementz sev-policyz sev-secretzsev-secret-headerzsev-secret-set-addresszsev-snp-policy hard_limit min_guarantee soft_limitswap_hard_limit numa_mode numa_nodesetrr image_formatzparallel.channelsr cpu_sharesemulator_periodemulator_quota global_period global_quotaiothread_periodiothread_quotalimit reservationshares vcpu_period vcpu_quotazballoon.availablezballoon.currentzballoon.disk_cacheszballoon.hugetlb_pgalloczballoon.hugetlb_pgfailzballoon.last-updatezballoon.major_faultzballoon.maximumzballoon.minor_faultz balloon.rsszballoon.swap_inzballoon.swap_outzballoon.unusedzballoon.usablez block.countzblock.z .allocationz .backingIndexz .capacityz.errorsz.fl.reqsz .fl.timesz.pathz .physicalz .rd.bytesz.rd.reqsz .rd.timesz .thresholdz .wr.bytesz.wr.reqsz .wr.timeszcpu.cache.monitor.countzcpu.cache.monitor.z .bank.countz.bank.z.bytesz.idz.vcpuszcpu.haltpoll.fail.timezcpu.haltpoll.success.timez cpu.systemzcpu.timezcpu.userz.curz.maxz.sumzdirtyrate.calc_modezdirtyrate.calc_periodzdirtyrate.calc_start_timezdirtyrate.calc_statuszdirtyrate.megabytes_per_secondzdirtyrate.vcpu.z.megabytes_per_secondziothread.countz iothread.z .poll-growz .poll-max-nsz .poll-shrinkzmemory.bandwidth.monitor.countzmemory.bandwidth.monitor.z .node.countz.node.z .bytes.localz .bytes.totalz net.countznet.z .rx.bytesz.rx.dropz.rx.errsz.rx.pktsz .tx.bytesz.tx.dropz.tx.errsz.tx.pktszperf.alignment_faultszperf.branch_instructionszperf.branch_misseszperf.bus_cycleszperf.cache_misseszperf.cache_referenceszperf.cmtzperf.context_switcheszperf.cpu_clockzperf.cpu_cycleszperf.cpu_migrationszperf.emulation_faultszperf.instructionsz perf.mbmlz perf.mbmtzperf.page_faultszperf.page_faults_majzperf.page_faults_minzperf.ref_cpu_cycleszperf.stalled_cycles_backendzperf.stalled_cycles_frontendzperf.task_clockz state.reasonz state.statez vcpu.currentz vcpu.maximumzvcpu.z.delayz.haltedz.statez.timez.waitzvm.zblkdeviotune.diskzblkdeviotune.group_namezblkdeviotune.read_bytes_seczblkdeviotune.read_bytes_sec_maxz&blkdeviotune.read_bytes_sec_max_lengthzblkdeviotune.read_iops_seczblkdeviotune.read_iops_sec_maxz%blkdeviotune.read_iops_sec_max_lengthzblkdeviotune.size_iops_seczblkdeviotune.total_bytes_secz blkdeviotune.total_bytes_sec_maxz'blkdeviotune.total_bytes_sec_max_lengthzblkdeviotune.total_iops_seczblkdeviotune.total_iops_sec_maxz&blkdeviotune.total_iops_sec_max_lengthzblkdeviotune.write_bytes_secz blkdeviotune.write_bytes_sec_maxz'blkdeviotune.write_bytes_sec_max_lengthzblkdeviotune.write_iops_seczblkdeviotune.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.avail.switchoverzbandwidth.postcopy compressionzcompression.mt.dthreadszcompression.mt.levelzcompression.mt.threadszcompression.xbzrle.cachezcompression.zlib.levelzcompression.zstd.leveldestination_namedestination_xml disks_port disks_uri graphics_urilisten_address migrate_disksmigrate_disks_detect_zeroeszparallel.connectionspersistent_xmlztls.destination migrate_uriidleintriowaitkernelr utilizationshm_full_scansshm_merge_across_nodesshm_pages_sharedshm_pages_sharingshm_pages_to_scanshm_pages_unsharedshm_pages_volatileshm_sleep_millisecsbufferscachedfreercbitposz cert-chainzcpu0-idz max-es-guestsz max-guestspdhzreduced-phys-bitsalignment_faultsbranch_instructions branch_misses bus_cycles cache_missescache_referencescmtcontext_switches cpu_clock cpu_cyclescpu_migrationsemulation_faults instructionsmbmlmbmt page_faultspage_faults_majpage_faults_minref_cpu_cyclesstalled_cycles_backendstalled_cycles_frontend task_clockrrj(r ImportErrorlib_e cygvirtmodcyg_erMrrtypingrrrrrr r r r r rrN_EventCB_EventAddHandleFunc_EventUpdateHandleFunc_EventRemoveHandleFunc_TimerCB_EventAddTimeoutFunc_EventUpdateTimeoutFunc_EventRemoveTimeoutFuncrQ_BlkioParameter_MemoryParameter_SchedParameter_TypedParameterrrrUr^rcrlrwr}rrrrrrrrrrrrrrrrrrrobjectrrr+r~rrrrqrrrrlrkrVIR_DOMAIN_BLKIO_PARAM_INTVIR_DOMAIN_BLKIO_PARAM_UINTVIR_DOMAIN_BLKIO_PARAM_LLONGVIR_DOMAIN_BLKIO_PARAM_ULLONGVIR_DOMAIN_BLKIO_PARAM_DOUBLEVIR_DOMAIN_BLKIO_PARAM_BOOLEANVIR_CPU_COMPARE_ERRORVIR_CPU_COMPARE_INCOMPATIBLEVIR_CPU_COMPARE_IDENTICALVIR_CPU_COMPARE_SUPERSET(VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES#VIR_CONNECT_BASELINE_CPU_MIGRATABLEVIR_CONNECT_CLOSE_REASON_ERRORVIR_CONNECT_CLOSE_REASON_EOF"VIR_CONNECT_CLOSE_REASON_KEEPALIVEVIR_CONNECT_CLOSE_REASON_CLIENT)VIR_CONNECT_COMPARE_CPU_FAIL_INCOMPATIBLE$VIR_CONNECT_COMPARE_CPU_VALIDATE_XMLVIR_CRED_USERNAMEVIR_CRED_AUTHNAMEVIR_CRED_LANGUAGEVIR_CRED_CNONCEVIR_CRED_PASSPHRASEVIR_CRED_ECHOPROMPTVIR_CRED_NOECHOPROMPTVIR_CRED_REALMVIR_CRED_EXTERNAL7VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_UNKNOWN>VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_DOMAIN_STARTED7VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_CHANNEL8VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_CONNECTED;VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_DISCONNECTEDVIR_DOMAIN_BLOCK_JOB_COMPLETEDVIR_DOMAIN_BLOCK_JOB_FAILEDVIR_DOMAIN_BLOCK_JOB_CANCELEDVIR_DOMAIN_BLOCK_JOB_READY-VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START+VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_STARTVIR_CONNECT_ROVIR_CONNECT_NO_ALIASES(VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE*VIR_CONNECT_GET_ALL_DOMAINS_STATS_INACTIVE,VIR_CONNECT_GET_ALL_DOMAINS_STATS_PERSISTENT+VIR_CONNECT_GET_ALL_DOMAINS_STATS_TRANSIENT)VIR_CONNECT_GET_ALL_DOMAINS_STATS_RUNNING(VIR_CONNECT_GET_ALL_DOMAINS_STATS_PAUSED)VIR_CONNECT_GET_ALL_DOMAINS_STATS_SHUTOFF'VIR_CONNECT_GET_ALL_DOMAINS_STATS_OTHER(VIR_CONNECT_GET_ALL_DOMAINS_STATS_NOWAIT)VIR_CONNECT_GET_ALL_DOMAINS_STATS_BACKING/VIR_CONNECT_GET_ALL_DOMAINS_STATS_ENFORCE_STATS?VIR_CONNECT_GET_DOMAIN_CAPABILITIES_DISABLE_DEPRECATED_FEATURESVIR_CONNECT_LIST_DOMAINS_ACTIVE!VIR_CONNECT_LIST_DOMAINS_INACTIVE#VIR_CONNECT_LIST_DOMAINS_PERSISTENT"VIR_CONNECT_LIST_DOMAINS_TRANSIENT VIR_CONNECT_LIST_DOMAINS_RUNNINGVIR_CONNECT_LIST_DOMAINS_PAUSED VIR_CONNECT_LIST_DOMAINS_SHUTOFFVIR_CONNECT_LIST_DOMAINS_OTHER$VIR_CONNECT_LIST_DOMAINS_MANAGEDSAVE'VIR_CONNECT_LIST_DOMAINS_NO_MANAGEDSAVE"VIR_CONNECT_LIST_DOMAINS_AUTOSTART%VIR_CONNECT_LIST_DOMAINS_NO_AUTOSTART%VIR_CONNECT_LIST_DOMAINS_HAS_SNAPSHOT$VIR_CONNECT_LIST_DOMAINS_NO_SNAPSHOT'VIR_CONNECT_LIST_DOMAINS_HAS_CHECKPOINT&VIR_CONNECT_LIST_DOMAINS_NO_CHECKPOINT$VIR_CONNECT_LIST_INTERFACES_INACTIVE"VIR_CONNECT_LIST_INTERFACES_ACTIVE"VIR_CONNECT_LIST_NETWORKS_INACTIVE VIR_CONNECT_LIST_NETWORKS_ACTIVE$VIR_CONNECT_LIST_NETWORKS_PERSISTENT#VIR_CONNECT_LIST_NETWORKS_TRANSIENT#VIR_CONNECT_LIST_NETWORKS_AUTOSTART&VIR_CONNECT_LIST_NETWORKS_NO_AUTOSTART(VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM)VIR_CONNECT_LIST_NODE_DEVICES_CAP_PCI_DEV)VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_DEV/VIR_CONNECT_LIST_NODE_DEVICES_CAP_USB_INTERFACE%VIR_CONNECT_LIST_NODE_DEVICES_CAP_NET+VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_HOST-VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_TARGET&VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI)VIR_CONNECT_LIST_NODE_DEVICES_CAP_STORAGE)VIR_CONNECT_LIST_NODE_DEVICES_CAP_FC_HOST(VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPORTS.VIR_CONNECT_LIST_NODE_DEVICES_CAP_SCSI_GENERIC%VIR_CONNECT_LIST_NODE_DEVICES_CAP_DRM,VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV_TYPES&VIR_CONNECT_LIST_NODE_DEVICES_CAP_MDEV)VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCW_DEV)VIR_CONNECT_LIST_NODE_DEVICES_CAP_CSS_DEV&VIR_CONNECT_LIST_NODE_DEVICES_CAP_VDPA)VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_CARD*VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_QUEUE+VIR_CONNECT_LIST_NODE_DEVICES_CAP_AP_MATRIX%VIR_CONNECT_LIST_NODE_DEVICES_CAP_VPD.VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCWGROUP_DEV1VIR_CONNECT_LIST_NODE_DEVICES_CAP_CCWGROUP_MEMBER(VIR_CONNECT_LIST_NODE_DEVICES_PERSISTENT'VIR_CONNECT_LIST_NODE_DEVICES_TRANSIENT&VIR_CONNECT_LIST_NODE_DEVICES_INACTIVE$VIR_CONNECT_LIST_NODE_DEVICES_ACTIVE"VIR_CONNECT_LIST_SECRETS_EPHEMERAL%VIR_CONNECT_LIST_SECRETS_NO_EPHEMERAL VIR_CONNECT_LIST_SECRETS_PRIVATE#VIR_CONNECT_LIST_SECRETS_NO_PRIVATE'VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE%VIR_CONNECT_LIST_STORAGE_POOLS_ACTIVE)VIR_CONNECT_LIST_STORAGE_POOLS_PERSISTENT(VIR_CONNECT_LIST_STORAGE_POOLS_TRANSIENT(VIR_CONNECT_LIST_STORAGE_POOLS_AUTOSTART+VIR_CONNECT_LIST_STORAGE_POOLS_NO_AUTOSTART"VIR_CONNECT_LIST_STORAGE_POOLS_DIR!VIR_CONNECT_LIST_STORAGE_POOLS_FS$VIR_CONNECT_LIST_STORAGE_POOLS_NETFS&VIR_CONNECT_LIST_STORAGE_POOLS_LOGICAL#VIR_CONNECT_LIST_STORAGE_POOLS_DISK$VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI#VIR_CONNECT_LIST_STORAGE_POOLS_SCSI$VIR_CONNECT_LIST_STORAGE_POOLS_MPATH"VIR_CONNECT_LIST_STORAGE_POOLS_RBD'VIR_CONNECT_LIST_STORAGE_POOLS_SHEEPDOG&VIR_CONNECT_LIST_STORAGE_POOLS_GLUSTER"VIR_CONNECT_LIST_STORAGE_POOLS_ZFS'VIR_CONNECT_LIST_STORAGE_POOLS_VSTORAGE+VIR_CONNECT_LIST_STORAGE_POOLS_ISCSI_DIRECTVIR_DOMAIN_ABORT_JOB_POSTCOPY'VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK)VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_DEFAULT(VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_NOWAIT)VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_APPEND)VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_REMOVE&VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNALVIR_DOMAIN_BLOCK_COMMIT_SHALLOWVIR_DOMAIN_BLOCK_COMMIT_DELETEVIR_DOMAIN_BLOCK_COMMIT_ACTIVE VIR_DOMAIN_BLOCK_COMMIT_RELATIVE'VIR_DOMAIN_BLOCK_COMMIT_BANDWIDTH_BYTESVIR_DOMAIN_BLOCK_COPY_SHALLOWVIR_DOMAIN_BLOCK_COPY_REUSE_EXT#VIR_DOMAIN_BLOCK_COPY_TRANSIENT_JOB(VIR_DOMAIN_BLOCK_COPY_SYNCHRONOUS_WRITES VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC VIR_DOMAIN_BLOCK_JOB_ABORT_PIVOT)VIR_DOMAIN_BLOCK_JOB_INFO_BANDWIDTH_BYTES*VIR_DOMAIN_BLOCK_JOB_SPEED_BANDWIDTH_BYTES!VIR_DOMAIN_BLOCK_JOB_TYPE_UNKNOWNVIR_DOMAIN_BLOCK_JOB_TYPE_PULLVIR_DOMAIN_BLOCK_JOB_TYPE_COPY VIR_DOMAIN_BLOCK_JOB_TYPE_COMMIT'VIR_DOMAIN_BLOCK_JOB_TYPE_ACTIVE_COMMIT VIR_DOMAIN_BLOCK_JOB_TYPE_BACKUP%VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTESVIR_DOMAIN_BLOCK_REBASE_SHALLOW!VIR_DOMAIN_BLOCK_REBASE_REUSE_EXT VIR_DOMAIN_BLOCK_REBASE_COPY_RAWVIR_DOMAIN_BLOCK_REBASE_COPY VIR_DOMAIN_BLOCK_REBASE_RELATIVE VIR_DOMAIN_BLOCK_REBASE_COPY_DEV'VIR_DOMAIN_BLOCK_REBASE_BANDWIDTH_BYTESVIR_DOMAIN_BLOCK_RESIZE_BYTES VIR_DOMAIN_BLOCK_RESIZE_CAPACITYVIR_DOMAIN_BLOCKED_UNKNOWNVIR_DOMAIN_CHANNEL_FORCE%VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE$VIR_DOMAIN_CHECKPOINT_CREATE_QUIESCE.VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE_VALIDATE%VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN*VIR_DOMAIN_CHECKPOINT_DELETE_METADATA_ONLY*VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN_ONLY&VIR_DOMAIN_CHECKPOINT_LIST_DESCENDANTS VIR_DOMAIN_CHECKPOINT_LIST_ROOTS&VIR_DOMAIN_CHECKPOINT_LIST_TOPOLOGICAL!VIR_DOMAIN_CHECKPOINT_LIST_LEAVES$VIR_DOMAIN_CHECKPOINT_LIST_NO_LEAVES VIR_DOMAIN_CHECKPOINT_XML_SECURE#VIR_DOMAIN_CHECKPOINT_XML_NO_DOMAINVIR_DOMAIN_CHECKPOINT_XML_SIZEVIR_DOMAIN_CONSOLE_FORCEVIR_DOMAIN_CONSOLE_SAFE$VIR_DOMAIN_CONTROL_ERROR_REASON_NONE'VIR_DOMAIN_CONTROL_ERROR_REASON_UNKNOWN'VIR_DOMAIN_CONTROL_ERROR_REASON_MONITOR(VIR_DOMAIN_CONTROL_ERROR_REASON_INTERNALVIR_DOMAIN_CONTROL_OKVIR_DOMAIN_CONTROL_JOBVIR_DOMAIN_CONTROL_OCCUPIEDVIR_DOMAIN_CONTROL_ERRORVIR_DUMP_CRASH VIR_DUMP_LIVEVIR_DUMP_BYPASS_CACHEVIR_DUMP_RESETVIR_DUMP_MEMORY_ONLYVIR_DOMAIN_CORE_DUMP_FORMAT_RAW&VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_ZLIB%VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_LZO(VIR_DOMAIN_CORE_DUMP_FORMAT_KDUMP_SNAPPY#VIR_DOMAIN_CORE_DUMP_FORMAT_WIN_DMPVIR_DOMAIN_CRASHED_UNKNOWNVIR_DOMAIN_CRASHED_PANICKEDVIR_DOMAIN_NONEVIR_DOMAIN_START_PAUSEDVIR_DOMAIN_START_AUTODESTROYVIR_DOMAIN_START_BYPASS_CACHEVIR_DOMAIN_START_FORCE_BOOTVIR_DOMAIN_START_VALIDATEVIR_DOMAIN_START_RESET_NVRAMVIR_DOMAIN_DEFINE_VALIDATEVIR_DOMAIN_DESTROY_DEFAULTVIR_DOMAIN_DESTROY_GRACEFULVIR_DOMAIN_DESTROY_REMOVE_LOGS VIR_DOMAIN_DEVICE_MODIFY_CURRENTVIR_DOMAIN_DEVICE_MODIFY_LIVEVIR_DOMAIN_DEVICE_MODIFY_CONFIGVIR_DOMAIN_DEVICE_MODIFY_FORCE'VIR_DOMAIN_DIRTYRATE_MODE_PAGE_SAMPLING&VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_BITMAP$VIR_DOMAIN_DIRTYRATE_MODE_DIRTY_RINGVIR_DOMAIN_DIRTYRATE_UNSTARTEDVIR_DOMAIN_DIRTYRATE_MEASURINGVIR_DOMAIN_DIRTYRATE_MEASUREDVIR_DOMAIN_DISK_ERROR_NONEVIR_DOMAIN_DISK_ERROR_UNSPECVIR_DOMAIN_DISK_ERROR_NO_SPACE!VIR_DOMAIN_EVENT_CRASHED_PANICKED$VIR_DOMAIN_EVENT_CRASHED_CRASHLOADEDVIR_DOMAIN_EVENT_DEFINED_ADDED VIR_DOMAIN_EVENT_DEFINED_UPDATED VIR_DOMAIN_EVENT_DEFINED_RENAMED&VIR_DOMAIN_EVENT_DEFINED_FROM_SNAPSHOT&VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4&VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV6&VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_UNIX!VIR_DOMAIN_EVENT_GRAPHICS_CONNECT$VIR_DOMAIN_EVENT_GRAPHICS_INITIALIZE$VIR_DOMAIN_EVENT_GRAPHICS_DISCONNECTVIR_DOMAIN_EVENT_ID_LIFECYCLEVIR_DOMAIN_EVENT_ID_REBOOTVIR_DOMAIN_EVENT_ID_RTC_CHANGEVIR_DOMAIN_EVENT_ID_WATCHDOGVIR_DOMAIN_EVENT_ID_IO_ERRORVIR_DOMAIN_EVENT_ID_GRAPHICS#VIR_DOMAIN_EVENT_ID_IO_ERROR_REASON!VIR_DOMAIN_EVENT_ID_CONTROL_ERRORVIR_DOMAIN_EVENT_ID_BLOCK_JOBVIR_DOMAIN_EVENT_ID_DISK_CHANGEVIR_DOMAIN_EVENT_ID_TRAY_CHANGEVIR_DOMAIN_EVENT_ID_PMWAKEUPVIR_DOMAIN_EVENT_ID_PMSUSPEND"VIR_DOMAIN_EVENT_ID_BALLOON_CHANGE"VIR_DOMAIN_EVENT_ID_PMSUSPEND_DISK"VIR_DOMAIN_EVENT_ID_DEVICE_REMOVEDVIR_DOMAIN_EVENT_ID_BLOCK_JOB_2VIR_DOMAIN_EVENT_ID_TUNABLE#VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE VIR_DOMAIN_EVENT_ID_DEVICE_ADDED'VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION!VIR_DOMAIN_EVENT_ID_JOB_COMPLETED)VIR_DOMAIN_EVENT_ID_DEVICE_REMOVAL_FAILED#VIR_DOMAIN_EVENT_ID_METADATA_CHANGE#VIR_DOMAIN_EVENT_ID_BLOCK_THRESHOLD"VIR_DOMAIN_EVENT_ID_MEMORY_FAILURE-VIR_DOMAIN_EVENT_ID_MEMORY_DEVICE_SIZE_CHANGE"VIR_DOMAIN_EVENT_ID_NIC_MAC_CHANGEVIR_DOMAIN_EVENT_IO_ERROR_NONEVIR_DOMAIN_EVENT_IO_ERROR_PAUSE VIR_DOMAIN_EVENT_IO_ERROR_REPORT#VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY!VIR_DOMAIN_EVENT_PMSUSPENDED_DISK!VIR_DOMAIN_EVENT_RESUMED_UNPAUSED!VIR_DOMAIN_EVENT_RESUMED_MIGRATED&VIR_DOMAIN_EVENT_RESUMED_FROM_SNAPSHOT!VIR_DOMAIN_EVENT_RESUMED_POSTCOPY(VIR_DOMAIN_EVENT_RESUMED_POSTCOPY_FAILED"VIR_DOMAIN_EVENT_SHUTDOWN_FINISHEDVIR_DOMAIN_EVENT_SHUTDOWN_GUESTVIR_DOMAIN_EVENT_SHUTDOWN_HOSTVIR_DOMAIN_EVENT_STARTED_BOOTED!VIR_DOMAIN_EVENT_STARTED_MIGRATED!VIR_DOMAIN_EVENT_STARTED_RESTORED&VIR_DOMAIN_EVENT_STARTED_FROM_SNAPSHOTVIR_DOMAIN_EVENT_STARTED_WAKEUP!VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN"VIR_DOMAIN_EVENT_STOPPED_DESTROYED VIR_DOMAIN_EVENT_STOPPED_CRASHED!VIR_DOMAIN_EVENT_STOPPED_MIGRATEDVIR_DOMAIN_EVENT_STOPPED_SAVEDVIR_DOMAIN_EVENT_STOPPED_FAILED&VIR_DOMAIN_EVENT_STOPPED_FROM_SNAPSHOT!VIR_DOMAIN_EVENT_SUSPENDED_PAUSED#VIR_DOMAIN_EVENT_SUSPENDED_MIGRATED"VIR_DOMAIN_EVENT_SUSPENDED_IOERROR#VIR_DOMAIN_EVENT_SUSPENDED_WATCHDOG#VIR_DOMAIN_EVENT_SUSPENDED_RESTORED(VIR_DOMAIN_EVENT_SUSPENDED_FROM_SNAPSHOT$VIR_DOMAIN_EVENT_SUSPENDED_API_ERROR#VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY*VIR_DOMAIN_EVENT_SUSPENDED_POSTCOPY_FAILED!VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN"VIR_DOMAIN_EVENT_TRAY_CHANGE_CLOSEVIR_DOMAIN_EVENT_DEFINEDVIR_DOMAIN_EVENT_UNDEFINEDVIR_DOMAIN_EVENT_STARTEDVIR_DOMAIN_EVENT_SUSPENDEDVIR_DOMAIN_EVENT_RESUMEDVIR_DOMAIN_EVENT_STOPPEDVIR_DOMAIN_EVENT_SHUTDOWNVIR_DOMAIN_EVENT_PMSUSPENDEDVIR_DOMAIN_EVENT_CRASHED"VIR_DOMAIN_EVENT_UNDEFINED_REMOVED"VIR_DOMAIN_EVENT_UNDEFINED_RENAMEDVIR_DOMAIN_EVENT_WATCHDOG_NONEVIR_DOMAIN_EVENT_WATCHDOG_PAUSEVIR_DOMAIN_EVENT_WATCHDOG_RESET"VIR_DOMAIN_EVENT_WATCHDOG_POWEROFF"VIR_DOMAIN_EVENT_WATCHDOG_SHUTDOWNVIR_DOMAIN_EVENT_WATCHDOG_DEBUG#VIR_DOMAIN_EVENT_WATCHDOG_INJECTNMI(VIR_DOMAIN_FD_ASSOCIATE_SECLABEL_RESTORE)VIR_DOMAIN_FD_ASSOCIATE_SECLABEL_WRITABLEVIR_DOMAIN_GET_HOSTNAME_LEASEVIR_DOMAIN_GET_HOSTNAME_AGENTVIR_DOMAIN_JOB_STATS_COMPLETED#VIR_DOMAIN_JOB_STATS_KEEP_COMPLETED#VIR_DOMAIN_GRAPHICS_RELOAD_TYPE_ANY#VIR_DOMAIN_GRAPHICS_RELOAD_TYPE_VNCVIR_DOMAIN_GUEST_INFO_USERSVIR_DOMAIN_GUEST_INFO_OSVIR_DOMAIN_GUEST_INFO_TIMEZONEVIR_DOMAIN_GUEST_INFO_HOSTNAME VIR_DOMAIN_GUEST_INFO_FILESYSTEMVIR_DOMAIN_GUEST_INFO_DISKS VIR_DOMAIN_GUEST_INFO_INTERFACESVIR_DOMAIN_GUEST_INFO_LOAD(VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE(VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENT&VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_ARP VIR_DOMAIN_JOB_OPERATION_UNKNOWNVIR_DOMAIN_JOB_OPERATION_STARTVIR_DOMAIN_JOB_OPERATION_SAVE VIR_DOMAIN_JOB_OPERATION_RESTORE%VIR_DOMAIN_JOB_OPERATION_MIGRATION_IN&VIR_DOMAIN_JOB_OPERATION_MIGRATION_OUT!VIR_DOMAIN_JOB_OPERATION_SNAPSHOT(VIR_DOMAIN_JOB_OPERATION_SNAPSHOT_REVERTVIR_DOMAIN_JOB_OPERATION_DUMPVIR_DOMAIN_JOB_OPERATION_BACKUP(VIR_DOMAIN_JOB_OPERATION_SNAPSHOT_DELETEVIR_DOMAIN_JOB_NONEVIR_DOMAIN_JOB_BOUNDEDVIR_DOMAIN_JOB_UNBOUNDEDVIR_DOMAIN_JOB_COMPLETEDVIR_DOMAIN_JOB_FAILEDVIR_DOMAIN_JOB_CANCELLEDVIR_DOMAIN_LIFECYCLE_POWEROFFVIR_DOMAIN_LIFECYCLE_REBOOTVIR_DOMAIN_LIFECYCLE_CRASH#VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY#VIR_DOMAIN_LIFECYCLE_ACTION_RESTART*VIR_DOMAIN_LIFECYCLE_ACTION_RESTART_RENAME$VIR_DOMAIN_LIFECYCLE_ACTION_PRESERVE,VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_DESTROY,VIR_DOMAIN_LIFECYCLE_ACTION_COREDUMP_RESTART-VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_IGNORE-VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_INJECT,VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_FATAL,VIR_DOMAIN_EVENT_MEMORY_FAILURE_ACTION_RESET)VIR_DOMAIN_MEMORY_FAILURE_ACTION_REQUIRED#VIR_DOMAIN_MEMORY_FAILURE_RECURSIVE4VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_HYPERVISOR/VIR_DOMAIN_EVENT_MEMORY_FAILURE_RECIPIENT_GUESTVIR_MEMORY_VIRTUALVIR_MEMORY_PHYSICALVIR_DOMAIN_MEM_CURRENTVIR_DOMAIN_MEM_LIVEVIR_DOMAIN_MEM_CONFIGVIR_DOMAIN_MEM_MAXIMUMVIR_DOMAIN_MEMORY_STAT_SWAP_INVIR_DOMAIN_MEMORY_STAT_SWAP_OUT"VIR_DOMAIN_MEMORY_STAT_MAJOR_FAULT"VIR_DOMAIN_MEMORY_STAT_MINOR_FAULTVIR_DOMAIN_MEMORY_STAT_UNUSED VIR_DOMAIN_MEMORY_STAT_AVAILABLE%VIR_DOMAIN_MEMORY_STAT_ACTUAL_BALLOONVIR_DOMAIN_MEMORY_STAT_RSSVIR_DOMAIN_MEMORY_STAT_USABLE"VIR_DOMAIN_MEMORY_STAT_LAST_UPDATE"VIR_DOMAIN_MEMORY_STAT_DISK_CACHES&VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGALLOC%VIR_DOMAIN_MEMORY_STAT_HUGETLB_PGFAILVIR_DOMAIN_MEMORY_STAT_LASTVIR_DOMAIN_MEMORY_STAT_NRVIR_DOMAIN_MESSAGE_DEPRECATIONVIR_DOMAIN_MESSAGE_TAINTINGVIR_DOMAIN_MESSAGE_IOERRORSVIR_DOMAIN_METADATA_DESCRIPTIONVIR_DOMAIN_METADATA_TITLEVIR_DOMAIN_METADATA_ELEMENTVIR_MIGRATE_LIVEVIR_MIGRATE_PEER2PEERVIR_MIGRATE_TUNNELLEDVIR_MIGRATE_PERSIST_DESTVIR_MIGRATE_UNDEFINE_SOURCEVIR_MIGRATE_PAUSEDVIR_MIGRATE_NON_SHARED_DISKVIR_MIGRATE_NON_SHARED_INCVIR_MIGRATE_CHANGE_PROTECTIONVIR_MIGRATE_UNSAFEVIR_MIGRATE_OFFLINEVIR_MIGRATE_COMPRESSEDVIR_MIGRATE_ABORT_ON_ERRORVIR_MIGRATE_AUTO_CONVERGEVIR_MIGRATE_RDMA_PIN_ALLVIR_MIGRATE_POSTCOPYVIR_MIGRATE_TLSVIR_MIGRATE_PARALLEL)VIR_MIGRATE_NON_SHARED_SYNCHRONOUS_WRITESVIR_MIGRATE_POSTCOPY_RESUMEVIR_MIGRATE_ZEROCOPY%VIR_DOMAIN_MIGRATE_MAX_SPEED_POSTCOPYVIR_DOMAIN_AFFECT_CURRENTVIR_DOMAIN_AFFECT_LIVEVIR_DOMAIN_AFFECT_CONFIGVIR_DOMAIN_NOSTATE_UNKNOWNVIR_DOMAIN_NUMATUNE_MEM_STRICT!VIR_DOMAIN_NUMATUNE_MEM_PREFERRED"VIR_DOMAIN_NUMATUNE_MEM_INTERLEAVE#VIR_DOMAIN_NUMATUNE_MEM_RESTRICTIVE!VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH#VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWNVIR_DOMAIN_PMSUSPENDED_UNKNOWNVIR_DOMAIN_PAUSED_UNKNOWNVIR_DOMAIN_PAUSED_USERVIR_DOMAIN_PAUSED_MIGRATIONVIR_DOMAIN_PAUSED_SAVEVIR_DOMAIN_PAUSED_DUMPVIR_DOMAIN_PAUSED_IOERRORVIR_DOMAIN_PAUSED_WATCHDOGVIR_DOMAIN_PAUSED_FROM_SNAPSHOTVIR_DOMAIN_PAUSED_SHUTTING_DOWNVIR_DOMAIN_PAUSED_SNAPSHOTVIR_DOMAIN_PAUSED_CRASHEDVIR_DOMAIN_PAUSED_STARTING_UPVIR_DOMAIN_PAUSED_POSTCOPY!VIR_DOMAIN_PAUSED_POSTCOPY_FAILEDVIR_DOMAIN_PAUSED_API_ERRORVIR_DOMAIN_PROCESS_SIGNAL_NOPVIR_DOMAIN_PROCESS_SIGNAL_HUPVIR_DOMAIN_PROCESS_SIGNAL_INTVIR_DOMAIN_PROCESS_SIGNAL_QUITVIR_DOMAIN_PROCESS_SIGNAL_ILLVIR_DOMAIN_PROCESS_SIGNAL_TRAPVIR_DOMAIN_PROCESS_SIGNAL_ABRTVIR_DOMAIN_PROCESS_SIGNAL_BUSVIR_DOMAIN_PROCESS_SIGNAL_FPEVIR_DOMAIN_PROCESS_SIGNAL_KILLVIR_DOMAIN_PROCESS_SIGNAL_USR1VIR_DOMAIN_PROCESS_SIGNAL_SEGVVIR_DOMAIN_PROCESS_SIGNAL_USR2VIR_DOMAIN_PROCESS_SIGNAL_PIPEVIR_DOMAIN_PROCESS_SIGNAL_ALRMVIR_DOMAIN_PROCESS_SIGNAL_TERM VIR_DOMAIN_PROCESS_SIGNAL_STKFLTVIR_DOMAIN_PROCESS_SIGNAL_CHLDVIR_DOMAIN_PROCESS_SIGNAL_CONTVIR_DOMAIN_PROCESS_SIGNAL_STOPVIR_DOMAIN_PROCESS_SIGNAL_TSTPVIR_DOMAIN_PROCESS_SIGNAL_TTINVIR_DOMAIN_PROCESS_SIGNAL_TTOUVIR_DOMAIN_PROCESS_SIGNAL_URGVIR_DOMAIN_PROCESS_SIGNAL_XCPUVIR_DOMAIN_PROCESS_SIGNAL_XFSZ VIR_DOMAIN_PROCESS_SIGNAL_VTALRMVIR_DOMAIN_PROCESS_SIGNAL_PROFVIR_DOMAIN_PROCESS_SIGNAL_WINCHVIR_DOMAIN_PROCESS_SIGNAL_POLLVIR_DOMAIN_PROCESS_SIGNAL_PWRVIR_DOMAIN_PROCESS_SIGNAL_SYSVIR_DOMAIN_PROCESS_SIGNAL_RT0VIR_DOMAIN_PROCESS_SIGNAL_RT1VIR_DOMAIN_PROCESS_SIGNAL_RT2VIR_DOMAIN_PROCESS_SIGNAL_RT3VIR_DOMAIN_PROCESS_SIGNAL_RT4VIR_DOMAIN_PROCESS_SIGNAL_RT5VIR_DOMAIN_PROCESS_SIGNAL_RT6VIR_DOMAIN_PROCESS_SIGNAL_RT7VIR_DOMAIN_PROCESS_SIGNAL_RT8VIR_DOMAIN_PROCESS_SIGNAL_RT9VIR_DOMAIN_PROCESS_SIGNAL_RT10VIR_DOMAIN_PROCESS_SIGNAL_RT11VIR_DOMAIN_PROCESS_SIGNAL_RT12VIR_DOMAIN_PROCESS_SIGNAL_RT13VIR_DOMAIN_PROCESS_SIGNAL_RT14VIR_DOMAIN_PROCESS_SIGNAL_RT15VIR_DOMAIN_PROCESS_SIGNAL_RT16VIR_DOMAIN_PROCESS_SIGNAL_RT17VIR_DOMAIN_PROCESS_SIGNAL_RT18VIR_DOMAIN_PROCESS_SIGNAL_RT19VIR_DOMAIN_PROCESS_SIGNAL_RT20VIR_DOMAIN_PROCESS_SIGNAL_RT21VIR_DOMAIN_PROCESS_SIGNAL_RT22VIR_DOMAIN_PROCESS_SIGNAL_RT23VIR_DOMAIN_PROCESS_SIGNAL_RT24VIR_DOMAIN_PROCESS_SIGNAL_RT25VIR_DOMAIN_PROCESS_SIGNAL_RT26VIR_DOMAIN_PROCESS_SIGNAL_RT27VIR_DOMAIN_PROCESS_SIGNAL_RT28VIR_DOMAIN_PROCESS_SIGNAL_RT29VIR_DOMAIN_PROCESS_SIGNAL_RT30VIR_DOMAIN_PROCESS_SIGNAL_RT31VIR_DOMAIN_PROCESS_SIGNAL_RT32VIR_DOMAIN_REBOOT_DEFAULT VIR_DOMAIN_REBOOT_ACPI_POWER_BTNVIR_DOMAIN_REBOOT_GUEST_AGENTVIR_DOMAIN_REBOOT_INITCTLVIR_DOMAIN_REBOOT_SIGNALVIR_DOMAIN_REBOOT_PARAVIRTVIR_DOMAIN_RUNNING_UNKNOWNVIR_DOMAIN_RUNNING_BOOTEDVIR_DOMAIN_RUNNING_MIGRATEDVIR_DOMAIN_RUNNING_RESTORED VIR_DOMAIN_RUNNING_FROM_SNAPSHOTVIR_DOMAIN_RUNNING_UNPAUSED%VIR_DOMAIN_RUNNING_MIGRATION_CANCELED VIR_DOMAIN_RUNNING_SAVE_CANCELEDVIR_DOMAIN_RUNNING_WAKEUPVIR_DOMAIN_RUNNING_CRASHEDVIR_DOMAIN_RUNNING_POSTCOPY"VIR_DOMAIN_RUNNING_POSTCOPY_FAILED VIR_DOMAIN_SAVE_IMAGE_XML_SECUREVIR_DOMAIN_SAVE_BYPASS_CACHEVIR_DOMAIN_SAVE_RUNNINGVIR_DOMAIN_SAVE_PAUSEDVIR_DOMAIN_SAVE_RESET_NVRAMVIR_DOMAIN_TIME_SYNCVIR_DOMAIN_PASSWORD_ENCRYPTEDVIR_DOMAIN_SHUTDOWN_DEFAULT"VIR_DOMAIN_SHUTDOWN_ACPI_POWER_BTNVIR_DOMAIN_SHUTDOWN_GUEST_AGENTVIR_DOMAIN_SHUTDOWN_INITCTLVIR_DOMAIN_SHUTDOWN_SIGNALVIR_DOMAIN_SHUTDOWN_PARAVIRTVIR_DOMAIN_SHUTDOWN_UNKNOWNVIR_DOMAIN_SHUTDOWN_USERVIR_DOMAIN_SHUTOFF_UNKNOWNVIR_DOMAIN_SHUTOFF_SHUTDOWNVIR_DOMAIN_SHUTOFF_DESTROYEDVIR_DOMAIN_SHUTOFF_CRASHEDVIR_DOMAIN_SHUTOFF_MIGRATEDVIR_DOMAIN_SHUTOFF_SAVEDVIR_DOMAIN_SHUTOFF_FAILED VIR_DOMAIN_SHUTOFF_FROM_SNAPSHOTVIR_DOMAIN_SHUTOFF_DAEMON#VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE"VIR_DOMAIN_SNAPSHOT_CREATE_CURRENT&VIR_DOMAIN_SNAPSHOT_CREATE_NO_METADATAVIR_DOMAIN_SNAPSHOT_CREATE_HALT$VIR_DOMAIN_SNAPSHOT_CREATE_DISK_ONLY$VIR_DOMAIN_SNAPSHOT_CREATE_REUSE_EXT"VIR_DOMAIN_SNAPSHOT_CREATE_QUIESCE!VIR_DOMAIN_SNAPSHOT_CREATE_ATOMICVIR_DOMAIN_SNAPSHOT_CREATE_LIVE#VIR_DOMAIN_SNAPSHOT_CREATE_VALIDATE#VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN(VIR_DOMAIN_SNAPSHOT_DELETE_METADATA_ONLY(VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN_ONLY$VIR_DOMAIN_SNAPSHOT_LIST_DESCENDANTSVIR_DOMAIN_SNAPSHOT_LIST_ROOTS!VIR_DOMAIN_SNAPSHOT_LIST_METADATAVIR_DOMAIN_SNAPSHOT_LIST_LEAVES"VIR_DOMAIN_SNAPSHOT_LIST_NO_LEAVES$VIR_DOMAIN_SNAPSHOT_LIST_NO_METADATA!VIR_DOMAIN_SNAPSHOT_LIST_INACTIVEVIR_DOMAIN_SNAPSHOT_LIST_ACTIVE"VIR_DOMAIN_SNAPSHOT_LIST_DISK_ONLY!VIR_DOMAIN_SNAPSHOT_LIST_INTERNAL!VIR_DOMAIN_SNAPSHOT_LIST_EXTERNAL$VIR_DOMAIN_SNAPSHOT_LIST_TOPOLOGICAL"VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING!VIR_DOMAIN_SNAPSHOT_REVERT_PAUSED VIR_DOMAIN_SNAPSHOT_REVERT_FORCE&VIR_DOMAIN_SNAPSHOT_REVERT_RESET_NVRAMVIR_DOMAIN_SNAPSHOT_XML_SECUREVIR_DOMAIN_NOSTATEVIR_DOMAIN_RUNNINGVIR_DOMAIN_BLOCKEDVIR_DOMAIN_PAUSEDVIR_DOMAIN_SHUTDOWNVIR_DOMAIN_SHUTOFFVIR_DOMAIN_CRASHEDVIR_DOMAIN_PMSUSPENDEDVIR_DOMAIN_STATS_STATEVIR_DOMAIN_STATS_CPU_TOTALVIR_DOMAIN_STATS_BALLOONVIR_DOMAIN_STATS_VCPUVIR_DOMAIN_STATS_INTERFACEVIR_DOMAIN_STATS_BLOCKVIR_DOMAIN_STATS_PERFVIR_DOMAIN_STATS_IOTHREADVIR_DOMAIN_STATS_MEMORYVIR_DOMAIN_STATS_DIRTYRATEVIR_DOMAIN_STATS_VM VIR_DOMAIN_UNDEFINE_MANAGED_SAVE&VIR_DOMAIN_UNDEFINE_SNAPSHOTS_METADATAVIR_DOMAIN_UNDEFINE_NVRAMVIR_DOMAIN_UNDEFINE_KEEP_NVRAM(VIR_DOMAIN_UNDEFINE_CHECKPOINTS_METADATAVIR_DOMAIN_UNDEFINE_TPMVIR_DOMAIN_UNDEFINE_KEEP_TPMVIR_DOMAIN_VCPU_CURRENTVIR_DOMAIN_VCPU_LIVEVIR_DOMAIN_VCPU_CONFIGVIR_DOMAIN_VCPU_MAXIMUMVIR_DOMAIN_VCPU_GUESTVIR_DOMAIN_VCPU_HOTPLUGGABLEVIR_DOMAIN_XML_SECUREVIR_DOMAIN_XML_INACTIVEVIR_DOMAIN_XML_UPDATE_CPUVIR_DOMAIN_XML_MIGRATABLE VIR_FROM_NONE VIR_FROM_XEN VIR_FROM_XENDVIR_FROM_XENSTOREVIR_FROM_SEXPR VIR_FROM_XML VIR_FROM_DOM VIR_FROM_RPCVIR_FROM_PROXY VIR_FROM_CONF VIR_FROM_QEMU VIR_FROM_NET VIR_FROM_TESTVIR_FROM_REMOTEVIR_FROM_OPENVZVIR_FROM_XENXMVIR_FROM_STATS_LINUX VIR_FROM_LXCVIR_FROM_STORAGEVIR_FROM_NETWORKVIR_FROM_DOMAIN VIR_FROM_UMLVIR_FROM_NODEDEVVIR_FROM_XEN_INOTIFYVIR_FROM_SECURITY VIR_FROM_VBOXVIR_FROM_INTERFACE VIR_FROM_ONE VIR_FROM_ESX VIR_FROM_PHYPVIR_FROM_SECRET VIR_FROM_CPUVIR_FROM_XENAPIVIR_FROM_NWFILTER VIR_FROM_HOOKVIR_FROM_DOMAIN_SNAPSHOTVIR_FROM_AUDITVIR_FROM_SYSINFOVIR_FROM_STREAMSVIR_FROM_VMWAREVIR_FROM_EVENTVIR_FROM_LIBXLVIR_FROM_LOCKINGVIR_FROM_HYPERVVIR_FROM_CAPABILITIES VIR_FROM_URI VIR_FROM_AUTH VIR_FROM_DBUSVIR_FROM_PARALLELSVIR_FROM_DEVICE VIR_FROM_SSHVIR_FROM_LOCKSPACEVIR_FROM_INITCTLVIR_FROM_IDENTITYVIR_FROM_CGROUPVIR_FROM_ACCESSVIR_FROM_SYSTEMDVIR_FROM_BHYVEVIR_FROM_CRYPTOVIR_FROM_FIREWALLVIR_FROM_POLKITVIR_FROM_THREADVIR_FROM_ADMINVIR_FROM_LOGGINGVIR_FROM_XENXL VIR_FROM_PERFVIR_FROM_LIBSSHVIR_FROM_RESCTRLVIR_FROM_FIREWALLDVIR_FROM_DOMAIN_CHECKPOINT VIR_FROM_TPM VIR_FROM_BPF VIR_FROM_CH VIR_ERR_NONEVIR_ERR_WARNING VIR_ERR_ERROR VIR_ERR_OKVIR_ERR_INTERNAL_ERRORVIR_ERR_NO_MEMORYVIR_ERR_NO_SUPPORTVIR_ERR_UNKNOWN_HOSTVIR_ERR_NO_CONNECTVIR_ERR_INVALID_CONNVIR_ERR_INVALID_DOMAINVIR_ERR_INVALID_ARGVIR_ERR_OPERATION_FAILEDVIR_ERR_GET_FAILEDVIR_ERR_POST_FAILEDVIR_ERR_HTTP_ERRORVIR_ERR_SEXPR_SERIALVIR_ERR_NO_XENVIR_ERR_XEN_CALLVIR_ERR_OS_TYPEVIR_ERR_NO_KERNELVIR_ERR_NO_ROOTVIR_ERR_NO_SOURCEVIR_ERR_NO_TARGETVIR_ERR_NO_NAME VIR_ERR_NO_OSVIR_ERR_NO_DEVICEVIR_ERR_NO_XENSTOREVIR_ERR_DRIVER_FULLVIR_ERR_CALL_FAILEDVIR_ERR_XML_ERRORVIR_ERR_DOM_EXISTVIR_ERR_OPERATION_DENIEDVIR_ERR_OPEN_FAILEDVIR_ERR_READ_FAILEDVIR_ERR_PARSE_FAILEDVIR_ERR_CONF_SYNTAXVIR_ERR_WRITE_FAILEDVIR_ERR_XML_DETAILVIR_ERR_INVALID_NETWORKVIR_ERR_NETWORK_EXISTVIR_ERR_SYSTEM_ERROR VIR_ERR_RPCVIR_ERR_GNUTLS_ERRORVIR_WAR_NO_NETWORKVIR_ERR_NO_DOMAINVIR_ERR_NO_NETWORKVIR_ERR_INVALID_MACVIR_ERR_AUTH_FAILEDVIR_ERR_INVALID_STORAGE_POOLVIR_ERR_INVALID_STORAGE_VOLVIR_WAR_NO_STORAGEVIR_ERR_NO_STORAGE_POOLVIR_ERR_NO_STORAGE_VOLVIR_WAR_NO_NODEVIR_ERR_INVALID_NODE_DEVICEVIR_ERR_NO_NODE_DEVICEVIR_ERR_NO_SECURITY_MODELVIR_ERR_OPERATION_INVALIDVIR_WAR_NO_INTERFACEVIR_ERR_NO_INTERFACEVIR_ERR_INVALID_INTERFACEVIR_ERR_MULTIPLE_INTERFACESVIR_WAR_NO_NWFILTERVIR_ERR_INVALID_NWFILTERVIR_ERR_NO_NWFILTERVIR_ERR_BUILD_FIREWALLVIR_WAR_NO_SECRETVIR_ERR_INVALID_SECRETVIR_ERR_NO_SECRETVIR_ERR_CONFIG_UNSUPPORTEDVIR_ERR_OPERATION_TIMEOUTVIR_ERR_MIGRATE_PERSIST_FAILEDVIR_ERR_HOOK_SCRIPT_FAILEDVIR_ERR_INVALID_DOMAIN_SNAPSHOTVIR_ERR_NO_DOMAIN_SNAPSHOTVIR_ERR_INVALID_STREAMVIR_ERR_ARGUMENT_UNSUPPORTEDVIR_ERR_STORAGE_PROBE_FAILEDVIR_ERR_STORAGE_POOL_BUILTVIR_ERR_SNAPSHOT_REVERT_RISKYVIR_ERR_OPERATION_ABORTEDVIR_ERR_AUTH_CANCELLEDVIR_ERR_NO_DOMAIN_METADATAVIR_ERR_MIGRATE_UNSAFEVIR_ERR_OVERFLOWVIR_ERR_BLOCK_COPY_ACTIVEVIR_ERR_OPERATION_UNSUPPORTED VIR_ERR_SSHVIR_ERR_AGENT_UNRESPONSIVEVIR_ERR_RESOURCE_BUSYVIR_ERR_ACCESS_DENIEDVIR_ERR_DBUS_SERVICEVIR_ERR_STORAGE_VOL_EXISTVIR_ERR_CPU_INCOMPATIBLEVIR_ERR_XML_INVALID_SCHEMAVIR_ERR_MIGRATE_FINISH_OKVIR_ERR_AUTH_UNAVAILABLEVIR_ERR_NO_SERVERVIR_ERR_NO_CLIENTVIR_ERR_AGENT_UNSYNCEDVIR_ERR_LIBSSHVIR_ERR_DEVICE_MISSING VIR_ERR_INVALID_NWFILTER_BINDINGVIR_ERR_NO_NWFILTER_BINDING!VIR_ERR_INVALID_DOMAIN_CHECKPOINTVIR_ERR_NO_DOMAIN_CHECKPOINTVIR_ERR_NO_DOMAIN_BACKUPVIR_ERR_INVALID_NETWORK_PORTVIR_ERR_NETWORK_PORT_EXISTVIR_ERR_NO_NETWORK_PORTVIR_ERR_NO_HOSTNAMEVIR_ERR_CHECKPOINT_INCONSISTENTVIR_ERR_MULTIPLE_DOMAINSVIR_ERR_NO_NETWORK_METADATAVIR_ERR_AGENT_COMMAND_TIMEOUTVIR_ERR_AGENT_COMMAND_FAILEDVIR_EVENT_HANDLE_READABLEVIR_EVENT_HANDLE_WRITABLEVIR_EVENT_HANDLE_ERRORVIR_EVENT_HANDLE_HANGUPVIR_IP_ADDR_TYPE_IPV4VIR_IP_ADDR_TYPE_IPV6VIR_INTERFACE_DEFINE_VALIDATEVIR_INTERFACE_XML_INACTIVEVIR_KEYCODE_SET_LINUXVIR_KEYCODE_SET_XTVIR_KEYCODE_SET_ATSET1VIR_KEYCODE_SET_ATSET2VIR_KEYCODE_SET_ATSET3VIR_KEYCODE_SET_OSXVIR_KEYCODE_SET_XT_KBDVIR_KEYCODE_SET_USBVIR_KEYCODE_SET_WIN32VIR_KEYCODE_SET_QNUMVIR_DOMAIN_MEMORY_PARAM_INTVIR_DOMAIN_MEMORY_PARAM_UINTVIR_DOMAIN_MEMORY_PARAM_LLONGVIR_DOMAIN_MEMORY_PARAM_ULLONGVIR_DOMAIN_MEMORY_PARAM_DOUBLEVIR_DOMAIN_MEMORY_PARAM_BOOLEAN$VIR_NWFILTER_BINDING_CREATE_VALIDATEVIR_NWFILTER_DEFINE_VALIDATEVIR_NETWORK_CREATE_VALIDATEVIR_NETWORK_DEFINE_VALIDATEVIR_NETWORK_EVENT_ID_LIFECYCLE$VIR_NETWORK_EVENT_ID_METADATA_CHANGEVIR_NETWORK_EVENT_DEFINEDVIR_NETWORK_EVENT_UNDEFINEDVIR_NETWORK_EVENT_STARTEDVIR_NETWORK_EVENT_STOPPED VIR_NETWORK_METADATA_DESCRIPTIONVIR_NETWORK_METADATA_TITLEVIR_NETWORK_METADATA_ELEMENTVIR_NETWORK_PORT_CREATE_RECLAIM VIR_NETWORK_PORT_CREATE_VALIDATEVIR_NETWORK_UPDATE_COMMAND_NONE!VIR_NETWORK_UPDATE_COMMAND_MODIFY!VIR_NETWORK_UPDATE_COMMAND_DELETE#VIR_NETWORK_UPDATE_COMMAND_ADD_LAST$VIR_NETWORK_UPDATE_COMMAND_ADD_FIRST!VIR_NETWORK_UPDATE_AFFECT_CURRENTVIR_NETWORK_UPDATE_AFFECT_LIVE VIR_NETWORK_UPDATE_AFFECT_CONFIGVIR_NETWORK_SECTION_NONEVIR_NETWORK_SECTION_BRIDGEVIR_NETWORK_SECTION_DOMAINVIR_NETWORK_SECTION_IP VIR_NETWORK_SECTION_IP_DHCP_HOST!VIR_NETWORK_SECTION_IP_DHCP_RANGEVIR_NETWORK_SECTION_FORWARD%VIR_NETWORK_SECTION_FORWARD_INTERFACEVIR_NETWORK_SECTION_FORWARD_PFVIR_NETWORK_SECTION_PORTGROUPVIR_NETWORK_SECTION_DNS_HOSTVIR_NETWORK_SECTION_DNS_TXTVIR_NETWORK_SECTION_DNS_SRVVIR_NETWORK_XML_INACTIVEVIR_NODE_ALLOC_PAGES_ADDVIR_NODE_ALLOC_PAGES_SET#VIR_NODE_DEVICE_CREATE_XML_VALIDATE#VIR_NODE_DEVICE_DEFINE_XML_VALIDATE"VIR_NODE_DEVICE_EVENT_ID_LIFECYCLEVIR_NODE_DEVICE_EVENT_ID_UPDATEVIR_NODE_DEVICE_EVENT_CREATEDVIR_NODE_DEVICE_EVENT_DELETEDVIR_NODE_DEVICE_EVENT_DEFINEDVIR_NODE_DEVICE_EVENT_UNDEFINED%VIR_NODE_DEVICE_UPDATE_AFFECT_CURRENT"VIR_NODE_DEVICE_UPDATE_AFFECT_LIVE$VIR_NODE_DEVICE_UPDATE_AFFECT_CONFIGVIR_NODE_DEVICE_XML_INACTIVEVIR_NODE_CPU_STATS_ALL_CPUSVIR_NODE_MEMORY_STATS_ALL_CELLSVIR_NODE_SUSPEND_TARGET_MEMVIR_NODE_SUSPEND_TARGET_DISKVIR_NODE_SUSPEND_TARGET_HYBRIDVIR_DOMAIN_SCHED_FIELD_INTVIR_DOMAIN_SCHED_FIELD_UINTVIR_DOMAIN_SCHED_FIELD_LLONGVIR_DOMAIN_SCHED_FIELD_ULLONGVIR_DOMAIN_SCHED_FIELD_DOUBLEVIR_DOMAIN_SCHED_FIELD_BOOLEANVIR_SECRET_DEFINE_VALIDATEVIR_SECRET_EVENT_ID_LIFECYCLE!VIR_SECRET_EVENT_ID_VALUE_CHANGEDVIR_SECRET_EVENT_DEFINEDVIR_SECRET_EVENT_UNDEFINEDVIR_SECRET_USAGE_TYPE_NONEVIR_SECRET_USAGE_TYPE_VOLUMEVIR_SECRET_USAGE_TYPE_CEPHVIR_SECRET_USAGE_TYPE_ISCSIVIR_SECRET_USAGE_TYPE_TLSVIR_SECRET_USAGE_TYPE_VTPMVIR_STORAGE_POOL_BUILD_NEWVIR_STORAGE_POOL_BUILD_REPAIRVIR_STORAGE_POOL_BUILD_RESIZE#VIR_STORAGE_POOL_BUILD_NO_OVERWRITE VIR_STORAGE_POOL_BUILD_OVERWRITEVIR_STORAGE_POOL_CREATE_NORMAL"VIR_STORAGE_POOL_CREATE_WITH_BUILD,VIR_STORAGE_POOL_CREATE_WITH_BUILD_OVERWRITE/VIR_STORAGE_POOL_CREATE_WITH_BUILD_NO_OVERWRITE VIR_STORAGE_POOL_DEFINE_VALIDATEVIR_STORAGE_POOL_DELETE_NORMALVIR_STORAGE_POOL_DELETE_ZEROED#VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE!VIR_STORAGE_POOL_EVENT_ID_REFRESHVIR_STORAGE_POOL_EVENT_DEFINED VIR_STORAGE_POOL_EVENT_UNDEFINEDVIR_STORAGE_POOL_EVENT_STARTEDVIR_STORAGE_POOL_EVENT_STOPPEDVIR_STORAGE_POOL_EVENT_CREATEDVIR_STORAGE_POOL_EVENT_DELETEDVIR_STORAGE_POOL_INACTIVEVIR_STORAGE_POOL_BUILDINGVIR_STORAGE_POOL_RUNNINGVIR_STORAGE_POOL_DEGRADEDVIR_STORAGE_POOL_INACCESSIBLE(VIR_STORAGE_VOL_CREATE_PREALLOC_METADATAVIR_STORAGE_VOL_CREATE_REFLINKVIR_STORAGE_VOL_CREATE_VALIDATEVIR_STORAGE_VOL_DELETE_NORMALVIR_STORAGE_VOL_DELETE_ZEROED%VIR_STORAGE_VOL_DELETE_WITH_SNAPSHOTS&VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAMVIR_STORAGE_VOL_USE_ALLOCATIONVIR_STORAGE_VOL_GET_PHYSICALVIR_STORAGE_VOL_RESIZE_ALLOCATEVIR_STORAGE_VOL_RESIZE_DELTAVIR_STORAGE_VOL_RESIZE_SHRINKVIR_STORAGE_VOL_FILEVIR_STORAGE_VOL_BLOCKVIR_STORAGE_VOL_DIRVIR_STORAGE_VOL_NETWORKVIR_STORAGE_VOL_NETDIRVIR_STORAGE_VOL_PLOOP$VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAMVIR_STORAGE_VOL_WIPE_ALG_ZEROVIR_STORAGE_VOL_WIPE_ALG_NNSAVIR_STORAGE_VOL_WIPE_ALG_DODVIR_STORAGE_VOL_WIPE_ALG_BSI VIR_STORAGE_VOL_WIPE_ALG_GUTMANN!VIR_STORAGE_VOL_WIPE_ALG_SCHNEIER"VIR_STORAGE_VOL_WIPE_ALG_PFITZNER7#VIR_STORAGE_VOL_WIPE_ALG_PFITZNER33VIR_STORAGE_VOL_WIPE_ALG_RANDOMVIR_STORAGE_VOL_WIPE_ALG_TRIMVIR_STORAGE_XML_INACTIVEVIR_STREAM_EVENT_READABLEVIR_STREAM_EVENT_WRITABLEVIR_STREAM_EVENT_ERRORVIR_STREAM_EVENT_HANGUPVIR_STREAM_NONBLOCKr6 VIR_TYPED_PARAM_STRING_OKAYVIR_TYPED_PARAM_INTVIR_TYPED_PARAM_UINTVIR_TYPED_PARAM_LLONGVIR_TYPED_PARAM_ULLONGVIR_TYPED_PARAM_DOUBLEVIR_TYPED_PARAM_BOOLEANVIR_TYPED_PARAM_STRINGVIR_VCPU_INFO_CPU_UNAVAILABLEVIR_VCPU_INFO_CPU_OFFLINEVIR_VCPU_OFFLINEVIR_VCPU_RUNNINGVIR_VCPU_BLOCKEDVIR_CONNECT_IDENTITY_GROUP_NAMEVIR_CONNECT_IDENTITY_PROCESS_ID!VIR_CONNECT_IDENTITY_PROCESS_TIME#VIR_CONNECT_IDENTITY_SASL_USER_NAME$VIR_CONNECT_IDENTITY_SELINUX_CONTEXT"VIR_CONNECT_IDENTITY_UNIX_GROUP_ID!VIR_CONNECT_IDENTITY_UNIX_USER_IDVIR_CONNECT_IDENTITY_USER_NAME,VIR_CONNECT_IDENTITY_X509_DISTINGUISHED_NAMEVIR_DOMAIN_BANDWIDTH_IN_AVERAGEVIR_DOMAIN_BANDWIDTH_IN_BURSTVIR_DOMAIN_BANDWIDTH_IN_FLOORVIR_DOMAIN_BANDWIDTH_IN_PEAK VIR_DOMAIN_BANDWIDTH_OUT_AVERAGEVIR_DOMAIN_BANDWIDTH_OUT_BURSTVIR_DOMAIN_BANDWIDTH_OUT_PEAK VIR_DOMAIN_BLKIO_DEVICE_READ_BPS!VIR_DOMAIN_BLKIO_DEVICE_READ_IOPSVIR_DOMAIN_BLKIO_DEVICE_WEIGHT!VIR_DOMAIN_BLKIO_DEVICE_WRITE_BPS"VIR_DOMAIN_BLKIO_DEVICE_WRITE_IOPSVIR_DOMAIN_BLKIO_WEIGHTVIR_DOMAIN_BLOCK_COPY_BANDWIDTHVIR_DOMAIN_BLOCK_COPY_BUF_SIZE!VIR_DOMAIN_BLOCK_COPY_GRANULARITY"VIR_DOMAIN_BLOCK_IOTUNE_GROUP_NAME&VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC*VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX1VIR_DOMAIN_BLOCK_IOTUNE_READ_BYTES_SEC_MAX_LENGTH%VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC)VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX0VIR_DOMAIN_BLOCK_IOTUNE_READ_IOPS_SEC_MAX_LENGTH%VIR_DOMAIN_BLOCK_IOTUNE_SIZE_IOPS_SEC'VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC+VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX2VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_BYTES_SEC_MAX_LENGTH&VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC*VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX1VIR_DOMAIN_BLOCK_IOTUNE_TOTAL_IOPS_SEC_MAX_LENGTH'VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC+VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX2VIR_DOMAIN_BLOCK_IOTUNE_WRITE_BYTES_SEC_MAX_LENGTH&VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC*VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX1VIR_DOMAIN_BLOCK_IOTUNE_WRITE_IOPS_SEC_MAX_LENGTHVIR_DOMAIN_BLOCK_STATS_ERRS VIR_DOMAIN_BLOCK_STATS_FLUSH_REQ(VIR_DOMAIN_BLOCK_STATS_FLUSH_TOTAL_TIMES!VIR_DOMAIN_BLOCK_STATS_READ_BYTESVIR_DOMAIN_BLOCK_STATS_READ_REQ'VIR_DOMAIN_BLOCK_STATS_READ_TOTAL_TIMES"VIR_DOMAIN_BLOCK_STATS_WRITE_BYTES VIR_DOMAIN_BLOCK_STATS_WRITE_REQ(VIR_DOMAIN_BLOCK_STATS_WRITE_TOTAL_TIMESVIR_DOMAIN_CPU_STATS_CPUTIMEVIR_DOMAIN_CPU_STATS_SYSTEMTIMEVIR_DOMAIN_CPU_STATS_USERTIMEVIR_DOMAIN_CPU_STATS_VCPUTIME VIR_DOMAIN_GUEST_INFO_DISK_COUNT!VIR_DOMAIN_GUEST_INFO_DISK_PREFIX'VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_ALIAS2VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_DEPENDENCY_COUNT3VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_DEPENDENCY_PREFIX8VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_DEPENDENCY_SUFFIX_NAME-VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_GUEST_ALIAS+VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_GUEST_BUS&VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_NAME+VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_PARTITION(VIR_DOMAIN_GUEST_INFO_DISK_SUFFIX_SERIALVIR_DOMAIN_GUEST_INFO_FS_COUNTVIR_DOMAIN_GUEST_INFO_FS_PREFIX*VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_DISK_COUNT+VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_DISK_PREFIX1VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_DISK_SUFFIX_ALIAS2VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_DISK_SUFFIX_DEVICE2VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_DISK_SUFFIX_SERIAL&VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_FSTYPE*VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_MOUNTPOINT$VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_NAME+VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_TOTAL_BYTES*VIR_DOMAIN_GUEST_INFO_FS_SUFFIX_USED_BYTES'VIR_DOMAIN_GUEST_INFO_HOSTNAME_HOSTNAMEVIR_DOMAIN_GUEST_INFO_IF_COUNTVIR_DOMAIN_GUEST_INFO_IF_PREFIX*VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_ADDR_COUNT+VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_ADDR_PREFIX0VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_ADDR_SUFFIX_ADDR2VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_ADDR_SUFFIX_PREFIX0VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_ADDR_SUFFIX_TYPE&VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_HWADDR$VIR_DOMAIN_GUEST_INFO_IF_SUFFIX_NAMEVIR_DOMAIN_GUEST_INFO_LOAD_15MVIR_DOMAIN_GUEST_INFO_LOAD_1MVIR_DOMAIN_GUEST_INFO_LOAD_5MVIR_DOMAIN_GUEST_INFO_OS_ID'VIR_DOMAIN_GUEST_INFO_OS_KERNEL_RELEASE'VIR_DOMAIN_GUEST_INFO_OS_KERNEL_VERSION VIR_DOMAIN_GUEST_INFO_OS_MACHINEVIR_DOMAIN_GUEST_INFO_OS_NAME$VIR_DOMAIN_GUEST_INFO_OS_PRETTY_NAME VIR_DOMAIN_GUEST_INFO_OS_VARIANT#VIR_DOMAIN_GUEST_INFO_OS_VARIANT_ID VIR_DOMAIN_GUEST_INFO_OS_VERSION#VIR_DOMAIN_GUEST_INFO_OS_VERSION_ID#VIR_DOMAIN_GUEST_INFO_TIMEZONE_NAME%VIR_DOMAIN_GUEST_INFO_TIMEZONE_OFFSET VIR_DOMAIN_GUEST_INFO_USER_COUNT!VIR_DOMAIN_GUEST_INFO_USER_PREFIX(VIR_DOMAIN_GUEST_INFO_USER_SUFFIX_DOMAIN,VIR_DOMAIN_GUEST_INFO_USER_SUFFIX_LOGIN_TIME&VIR_DOMAIN_GUEST_INFO_USER_SUFFIX_NAMEVIR_DOMAIN_IOTHREAD_POLL_GROWVIR_DOMAIN_IOTHREAD_POLL_MAX_NSVIR_DOMAIN_IOTHREAD_POLL_SHRINK#VIR_DOMAIN_IOTHREAD_THREAD_POOL_MAX#VIR_DOMAIN_IOTHREAD_THREAD_POOL_MIN%VIR_DOMAIN_JOB_AUTO_CONVERGE_THROTTLE VIR_DOMAIN_JOB_COMPRESSION_BYTES VIR_DOMAIN_JOB_COMPRESSION_CACHE'VIR_DOMAIN_JOB_COMPRESSION_CACHE_MISSES#VIR_DOMAIN_JOB_COMPRESSION_OVERFLOW VIR_DOMAIN_JOB_COMPRESSION_PAGESVIR_DOMAIN_JOB_DATA_PROCESSEDVIR_DOMAIN_JOB_DATA_REMAININGVIR_DOMAIN_JOB_DATA_TOTALVIR_DOMAIN_JOB_DISK_BPSVIR_DOMAIN_JOB_DISK_PROCESSEDVIR_DOMAIN_JOB_DISK_REMAININGVIR_DOMAIN_JOB_DISK_TEMP_TOTALVIR_DOMAIN_JOB_DISK_TEMP_USEDVIR_DOMAIN_JOB_DISK_TOTALVIR_DOMAIN_JOB_DOWNTIMEVIR_DOMAIN_JOB_DOWNTIME_NETVIR_DOMAIN_JOB_ERRMSGVIR_DOMAIN_JOB_MEMORY_BPSVIR_DOMAIN_JOB_MEMORY_CONSTANT VIR_DOMAIN_JOB_MEMORY_DIRTY_RATEVIR_DOMAIN_JOB_MEMORY_ITERATIONVIR_DOMAIN_JOB_MEMORY_NORMAL"VIR_DOMAIN_JOB_MEMORY_NORMAL_BYTESVIR_DOMAIN_JOB_MEMORY_PAGE_SIZE#VIR_DOMAIN_JOB_MEMORY_POSTCOPY_REQSVIR_DOMAIN_JOB_MEMORY_PROCESSEDVIR_DOMAIN_JOB_MEMORY_REMAININGVIR_DOMAIN_JOB_MEMORY_TOTALVIR_DOMAIN_JOB_OPERATIONVIR_DOMAIN_JOB_SETUP_TIMEVIR_DOMAIN_JOB_SUCCESSVIR_DOMAIN_JOB_TIME_ELAPSEDVIR_DOMAIN_JOB_TIME_ELAPSED_NETVIR_DOMAIN_JOB_TIME_REMAINING$VIR_DOMAIN_JOB_VFIO_DATA_TRANSFERRED(VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MAJOR(VIR_DOMAIN_LAUNCH_SECURITY_SEV_API_MINOR'VIR_DOMAIN_LAUNCH_SECURITY_SEV_BUILD_ID*VIR_DOMAIN_LAUNCH_SECURITY_SEV_MEASUREMENT%VIR_DOMAIN_LAUNCH_SECURITY_SEV_POLICY%VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET,VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_HEADER1VIR_DOMAIN_LAUNCH_SECURITY_SEV_SECRET_SET_ADDRESS)VIR_DOMAIN_LAUNCH_SECURITY_SEV_SNP_POLICYVIR_DOMAIN_MEMORY_HARD_LIMITVIR_DOMAIN_MEMORY_MIN_GUARANTEEVIR_DOMAIN_MEMORY_SOFT_LIMIT!VIR_DOMAIN_MEMORY_SWAP_HARD_LIMITVIR_DOMAIN_NUMA_MODEVIR_DOMAIN_NUMA_NODESETVIR_DOMAIN_SAVE_PARAM_DXMLVIR_DOMAIN_SAVE_PARAM_FILE"VIR_DOMAIN_SAVE_PARAM_IMAGE_FORMAT'VIR_DOMAIN_SAVE_PARAM_PARALLEL_CHANNELSVIR_DOMAIN_SCHEDULER_CAPVIR_DOMAIN_SCHEDULER_CPU_SHARES$VIR_DOMAIN_SCHEDULER_EMULATOR_PERIOD#VIR_DOMAIN_SCHEDULER_EMULATOR_QUOTA"VIR_DOMAIN_SCHEDULER_GLOBAL_PERIOD!VIR_DOMAIN_SCHEDULER_GLOBAL_QUOTA$VIR_DOMAIN_SCHEDULER_IOTHREAD_PERIOD#VIR_DOMAIN_SCHEDULER_IOTHREAD_QUOTAVIR_DOMAIN_SCHEDULER_LIMIT VIR_DOMAIN_SCHEDULER_RESERVATIONVIR_DOMAIN_SCHEDULER_SHARES VIR_DOMAIN_SCHEDULER_VCPU_PERIODVIR_DOMAIN_SCHEDULER_VCPU_QUOTAVIR_DOMAIN_SCHEDULER_WEIGHT"VIR_DOMAIN_STATS_BALLOON_AVAILABLE VIR_DOMAIN_STATS_BALLOON_CURRENT$VIR_DOMAIN_STATS_BALLOON_DISK_CACHES(VIR_DOMAIN_STATS_BALLOON_HUGETLB_PGALLOC'VIR_DOMAIN_STATS_BALLOON_HUGETLB_PGFAIL$VIR_DOMAIN_STATS_BALLOON_LAST_UPDATE$VIR_DOMAIN_STATS_BALLOON_MAJOR_FAULT VIR_DOMAIN_STATS_BALLOON_MAXIMUM$VIR_DOMAIN_STATS_BALLOON_MINOR_FAULTVIR_DOMAIN_STATS_BALLOON_RSS VIR_DOMAIN_STATS_BALLOON_SWAP_IN!VIR_DOMAIN_STATS_BALLOON_SWAP_OUTVIR_DOMAIN_STATS_BALLOON_UNUSEDVIR_DOMAIN_STATS_BALLOON_USABLEVIR_DOMAIN_STATS_BLOCK_COUNTVIR_DOMAIN_STATS_BLOCK_PREFIX(VIR_DOMAIN_STATS_BLOCK_SUFFIX_ALLOCATION*VIR_DOMAIN_STATS_BLOCK_SUFFIX_BACKINGINDEX&VIR_DOMAIN_STATS_BLOCK_SUFFIX_CAPACITY$VIR_DOMAIN_STATS_BLOCK_SUFFIX_ERRORS%VIR_DOMAIN_STATS_BLOCK_SUFFIX_FL_REQS&VIR_DOMAIN_STATS_BLOCK_SUFFIX_FL_TIMES"VIR_DOMAIN_STATS_BLOCK_SUFFIX_NAME"VIR_DOMAIN_STATS_BLOCK_SUFFIX_PATH&VIR_DOMAIN_STATS_BLOCK_SUFFIX_PHYSICAL&VIR_DOMAIN_STATS_BLOCK_SUFFIX_RD_BYTES%VIR_DOMAIN_STATS_BLOCK_SUFFIX_RD_REQS&VIR_DOMAIN_STATS_BLOCK_SUFFIX_RD_TIMES'VIR_DOMAIN_STATS_BLOCK_SUFFIX_THRESHOLD&VIR_DOMAIN_STATS_BLOCK_SUFFIX_WR_BYTES%VIR_DOMAIN_STATS_BLOCK_SUFFIX_WR_REQS&VIR_DOMAIN_STATS_BLOCK_SUFFIX_WR_TIMES(VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_COUNT)VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_PREFIX4VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_SUFFIX_BANK_COUNT5VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_SUFFIX_BANK_PREFIX;VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_SUFFIX_BANK_SUFFIX_BYTES8VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_SUFFIX_BANK_SUFFIX_ID.VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_SUFFIX_NAME/VIR_DOMAIN_STATS_CPU_CACHE_MONITOR_SUFFIX_VCPUS'VIR_DOMAIN_STATS_CPU_HALTPOLL_FAIL_TIME*VIR_DOMAIN_STATS_CPU_HALTPOLL_SUCCESS_TIMEVIR_DOMAIN_STATS_CPU_SYSTEMVIR_DOMAIN_STATS_CPU_TIMEVIR_DOMAIN_STATS_CPU_USER'VIR_DOMAIN_STATS_CUSTOM_SUFFIX_TYPE_CUR'VIR_DOMAIN_STATS_CUSTOM_SUFFIX_TYPE_MAX'VIR_DOMAIN_STATS_CUSTOM_SUFFIX_TYPE_SUM$VIR_DOMAIN_STATS_DIRTYRATE_CALC_MODE&VIR_DOMAIN_STATS_DIRTYRATE_CALC_PERIOD*VIR_DOMAIN_STATS_DIRTYRATE_CALC_START_TIME&VIR_DOMAIN_STATS_DIRTYRATE_CALC_STATUS/VIR_DOMAIN_STATS_DIRTYRATE_MEGABYTES_PER_SECOND&VIR_DOMAIN_STATS_DIRTYRATE_VCPU_PREFIX;VIR_DOMAIN_STATS_DIRTYRATE_VCPU_SUFFIX_MEGABYTES_PER_SECONDVIR_DOMAIN_STATS_IOTHREAD_COUNT VIR_DOMAIN_STATS_IOTHREAD_PREFIX*VIR_DOMAIN_STATS_IOTHREAD_SUFFIX_POLL_GROW,VIR_DOMAIN_STATS_IOTHREAD_SUFFIX_POLL_MAX_NS,VIR_DOMAIN_STATS_IOTHREAD_SUFFIX_POLL_SHRINK/VIR_DOMAIN_STATS_MEMORY_BANDWIDTH_MONITOR_COUNT0VIR_DOMAIN_STATS_MEMORY_BANDWIDTH_MONITOR_PREFIX5VIR_DOMAIN_STATS_MEMORY_BANDWIDTH_MONITOR_SUFFIX_NAME;VIR_DOMAIN_STATS_MEMORY_BANDWIDTH_MONITOR_SUFFIX_NODE_COUNTr*s& ]]] T] S#sB'- .S(B7<=!3*d"23!3%*- S"ItO $h 3S 89"C:t#34"C5#:. lKc2> M N sCx.S>sCx.sCx.:9:@6Hb$Z%566R6C6  #  T  #  l  LXc]c0 EcEsE3EhXZlH[EkoE{E E wcwsw3ww`bwnrw wQcQsQ3QeT\^`T`NackNkHlQ}EFH}IQUYQ,GsGE%" :Mx:W4XGhpqshtGAEG&   c 4PSUXPX> ^a   d38n  #s",2#4@s@t@6 0  $*u>(3 50#l.l.^]hEhETPVPde6eNuJVuJneFeNL!JL!J\BNFN`eeN=&=~44l[9[9z oS&oSbVSVSr  ! !!" ,-(&'#"# %&""#-.)'($;<7AB>:;7<=8>?;"# !12-./+,-(-.*/0,./+,.)+-(,.)*-'+4(,6)2</CD?#$$%!&'#%&"#% "$#% !$'*$*-'%)"(,%(,%'+$*/').&()$%&"&'"#$ '($&'#&(#)+&,-(,-),-)23/(*%.0+02-),&,/),/)+/(15.(,%/3,).&,1),1))/&,2)-3*.5+(/%18.4;1+4(*3')3&'1$&'"()%#$ &'#+,'()%,-)+,(+-(.0+%'"$'!'*$),&&*#'+$&*#'+$%*"*/').&%+"*0'.4+!"+-',.)+,(-.),-)*+&#$!"!"#$ *,'!""#&'#+,($% #$ -.)./*%&!!"!"#$ *+'#$ )+%#$$%!#$  #% #% *,'!"#$ )*%'($12.)*%-.*-.**+&#$ )*&$%!'($$% &'#!"()$*+'*+'+,( #$)*&()%+,(&'#  !!!"$% !"#!"+,')*&'($"#!" ! !"%&!'($"##$ #$ )*&*+&)*&)*&%&!'($'($!"!"   &'#$%! !"#"$! "%'"%'"%'""$ &(##% *,'$&!,.)&(#&(#%'"02-%'""#"##$ '(#$%!%&!$%!)*&$%!+,(&'""#!"#$$%!$%!)*&"#%&!%&"#$ $%!!""#)*&%&!&'#%&"&'#&'#+,('($&'#-.*%&!%&" &'"%&""#"#"#%&"%&""#&'#,-(,-)!" !"#&'#'(#&'# !"!"#%  #%  ,-(+,()*&$% !" !#$ ()%)*&$%!+,( !"#+-(!"'(#&'#-.*'($/0,/0,12-01-/0,/0,-.)&'#89423/"#"#%&"%&" !#$ ()% !%&"%'")+&(*% "##$    #!  ,2)$)*%"#$%!%&"&'#%&!'(#"#"#"# "$&! !" ! !!" !!"!" ! !!"!#!#!#!#!#!##% !#!#!#!#!#!# "!#!##% !#"$!# " " " " " " " " " " " "!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!#!##$ !#$ ()%#$  %'"$%  !!" %&""#!  #$ '(#%&")*&"#')$')$%'"$'!"%&)#'(#+,(+,(()$!"$%!"#%&"')$$&!"$%("$'!$'!'+$&'"$%!#$ )*&"# $% )*&!"+-(!!                               !   !#"$!! " " #& !$'!"" "%! #"!"   !!"!""#()$ !  "#'($$%  #$#$ #$$%!$%!&'#'($%&!!"#$ #$ $%!()%!" !!  '(#'(#&'""#!" ! !"#)*%%&"'($ !!#%  !"  ! !!"!"$%!  ! !&'##$ "#%&"/0,23/$% "#!"'(#$%!"##$ !"!"!"!" !,-(!""#!" !()%*+&"# #$  !()$!" !  #$ $%!%&"&'#"# ! ! !##/".$2!&6#'8$%4"$2!!,/H,"3 / /-#5 !1 /#: $:!!0$<!%<"""-!+$1!%1")9&-A*4O1(7%,?)3M0(7%*;'.C+5Q2)9&-A*4O1*;'.C+5Q2)9&-A*4O1$#5 +>($.!"1*:'%/"#2 +;()"/ + +#/ $+!*2'5H26D3;B80>-.:+)0&.:++4(!+"'-:*.6+4<15>25>2)2&-:*'.$.<+-:**4'!+"'-:*.6+3:05>23:0)2&'.$!+ ) )%*='*='#/ )'7$#/ &5##/ &5#&5#(9%#/ $+!+4(/<,)0& +"/"/&7#&7#(@%#6 #6 *D'&<##6 0 0($ 0 0!2 0($, (!2#6 "4.%:""4&@#"4"4,&(","4 0'>$+:(+:(*8'->*(4%(4%/B,4L1,<)+"1+$5!"(##%3"*=' ".'8$&6#%4"$2!'8$&6#$#0 &#0 ".&%8"#4 '<$+D(*B''<$'<$#4 '<$,#4 $6!"2"2, (+8(-<*)4&'0$(2%)4&%,"%,")4&)4&(2%)4&*6')4&(2%)4&+D(,@)7D48@5>F;;@818.2:/*B'-H**&&*0'*0'*0''<$)@&-H*)@&2R/):&>U;"2#. -9*/=,/=,2R/3N08?5>K;?G%(>%'<$/L,0N-#4 ., . .&%-"&/#%-"$+!$+!"!4'@$+H(/P,6^3*F'.N+5\2*F',J)0R-7`4+H(/P,6^3,J)0R-7`4+H(/P,6^3$8!%:")B&(@%'>$&<#&=#)B&(@%!4%:"$8!,E)*A')/K,';$ -,E))?&+C(-G*+C(+C(0.+)!/#3 "10M-)?& 0$5!%(9%&5#&5#%3");&'7$&5#  $$ !.$4!,D)&8#':$':$(<%(<%)>& )'#% & ,&!4"4%:".(,"4"4&( 0"4,*!2!2 0(@%)B&(Cc''  E *K + *sFAM+M+AN'M2AM<M<ANNANNAN"NANNAN"N"AN'