Re: [libvirt] [PATCH 17/16] save: new API to manipulate save file images

Modifying the xml on either save or restore only gets you so far - you have to remember to 'virsh dumpxml dom' just prior to the 'virsh save' in order to have an xml file worth modifying that won't be rejected due to abi breaks. To make this more powerful, we need a way to grab the xml embedded within a state file, and from there, it's not much harder to also support modifying a state file in-place. Also, virDomainGetXMLDesc didn't document its flags. * include/libvirt/libvirt.h.in (virDomainSaveImageGetXMLDesc) (virDomainSaveImageDefineXML): New prototypes. * src/libvirt.c (virDomainSaveImageGetXMLDesc) (virDomainSaveImageDefineXML): New API. * src/libvirt_public.syms: Export them. * src/driver.h (virDrvDomainSaveImageGetXMLDesc) (virDrvDomainSaveImgeDefineXML): New driver callbacks. --- I've waffled over various choices for naming this API, such as virConnectDomainSaveGetXMLDesc, but I think what I've chosen works out well - it creates the new virDomainSaveImage* prefix for use with any other commands that might also later operate on a domain saved state file. Saved state is always inactive (the guest shuts down during virDomainSave), so the VIR_DOMAIN_XML_INACTIVE flag would be a no-op if it were accepted; I suppose I could silently ignore it, but as written the patches reject it instead. I'm not sure whether VIR_DOMAIN_XML_UPDATE_CPU makes sense, so I rejected it. include/libvirt/libvirt.h.in | 9 ++- src/driver.h | 11 +++ src/libvirt.c | 158 +++++++++++++++++++++++++++++++++++++++++- src/libvirt_public.syms | 2 + 4 files changed, 178 insertions(+), 2 deletions(-)