mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-22 21:55:25 +00:00
4201a7ea1c
Each <domainsnapshot> can now contain an optional <memory> element that describes how the VM state was handled, similar to disk snapshots. The new element will always appear in output; for back-compat, an input that lacks the element will assume 'no' or 'internal' according to the domain state. Along with this change, it is now possible to pass <disks> in the XML for an offline snapshot; this also needs to be wired up in a future patch, to make it possible to choose internal vs. external on a per-disk basis for each disk in an offline domain. At that point, using the --disk-only flag for an offline domain will be able to work. For some examples below, remember that qemu supports the following snapshot actions: qemu-img: offline external and internal disk savevm: online internal VM and disk migrate: online external VM transaction: online external disk ===== <domainsnapshot> <memory snapshot='no'/> ... </domainsnapshot> implies that there is no VM state saved (mandatory for offline and disk-only snapshots, not possible otherwise); using qemu-img for offline domains and transaction for online. ===== <domainsnapshot> <memory snapshot='internal'/> ... </domainsnapshot> state is saved inside one of the disks (as in qemu's 'savevm' system checkpoint implementation). If needed in the future, we can also add an attribute pointing out _which_ disk saved the internal state; maybe disk='vda'. ===== <domainsnapshot> <memory snapshot='external' file='/path/to/state'/> ... </domainsnapshot> This is not wired up yet, but future patches will allow this to control a combination of 'virsh save /path/to/state' plus disk snapshots from the same point in time. ===== So for 1.0.1 (and later, as needed), I plan to implement this table of combinations, with '*' designating new code and '+' designating existing code reached through new combinations of xml and/or the existing DISK_ONLY flag: domain memory disk disk-only | result ----------------------------------------- offline omit omit any | memory=no disk=int, via qemu-img offline no omit any |+memory=no disk=int, via qemu-img offline omit/no no any | invalid combination (nothing to snapshot) offline omit/no int any |+memory=no disk=int, via qemu-img offline omit/no ext any |*memory=no disk=ext, via qemu-img offline int/ext any any | invalid combination (no memory to save) online omit omit off | memory=int disk=int, via savevm online omit omit on | memory=no disk=default, via transaction online omit no/ext off | unsupported for now online omit no on | invalid combination (nothing to snapshot) online omit ext on | memory=no disk=ext, via transaction online omit int off |+memory=int disk=int, via savevm online omit int on | unsupported for now online no omit any |+memory=no disk=default, via transaction online no no any | invalid combination (nothing to snapshot) online no int any | unsupported for now online no ext any |+memory=no disk=ext, via transaction online int/ext any on | invalid combination (disk-only vs. memory) online int omit off |+memory=int disk=int, via savevm online int no/ext off | unsupported for now online int int off |+memory=int disk=int, via savevm online ext omit off |*memory=ext disk=default, via migrate+trans online ext no off |+memory=ext disk=no, via migrate online ext int off | unsupported for now online ext ext off |*memory=ext disk=ext, via migrate+transaction * docs/schemas/domainsnapshot.rng (memory): New RNG element. * docs/formatsnapshot.html.in: Document it. * src/conf/snapshot_conf.h (virDomainSnapshotDef): New fields. * src/conf/domain_conf.c (virDomainSnapshotDefFree) (virDomainSnapshotDefParseString, virDomainSnapshotDefFormat): Manage new fields. * tests/domainsnapshotxml2xmltest.c: New test. * tests/domainsnapshotxml2xmlin/*.xml: Update existing tests. * tests/domainsnapshotxml2xmlout/*.xml: Likewise. |
||
|---|---|---|
| .. | ||
| api_extension | ||
| devhelp | ||
| html | ||
| internals | ||
| schemas | ||
| 32favicon.png | ||
| 404.html.in | ||
| api_extension.html.in | ||
| api.html.in | ||
| apibuild.py | ||
| apps.html.in | ||
| archdomain.html.in | ||
| architecture.fig | ||
| architecture.gif | ||
| architecture.html.in | ||
| archnetwork.html.in | ||
| archnode.html.in | ||
| archstorage.html.in | ||
| auth.html.in | ||
| bindings.html.in | ||
| bugs.html.in | ||
| compiling.html.in | ||
| contact.html.in | ||
| csharp.html.in | ||
| deployment.html.in | ||
| devguide.html.in | ||
| docs.html.in | ||
| downloads.html.in | ||
| drivers.html.in | ||
| drvesx.html.in | ||
| drvhyperv.html.in | ||
| drvlxc.html.in | ||
| drvopenvz.html.in | ||
| drvparallels.html.in | ||
| drvphyp.html.in | ||
| drvqemu.html.in | ||
| drvremote.html.in | ||
| drvtest.html.in | ||
| drvuml.html.in | ||
| drvvbox.html.in | ||
| drvvmware.html.in | ||
| drvxen.html.in | ||
| errors.html.in | ||
| et.png | ||
| firewall.html.in | ||
| footer_corner.png | ||
| footer_pattern.png | ||
| format.html.in | ||
| formatcaps.html.in | ||
| formatdomain.html.in | ||
| formatnetwork.html.in | ||
| formatnode.html.in | ||
| formatnwfilter.html.in | ||
| formatsecret.html.in | ||
| formatsnapshot.html.in | ||
| formatstorage.html.in | ||
| formatstorageencryption.html.in | ||
| generic.css | ||
| goals.html.in | ||
| hacking1.xsl | ||
| hacking2.xsl | ||
| hacking.html.in | ||
| hooks.html.in | ||
| hvsupport.pl | ||
| index.html.in | ||
| index.py | ||
| internals.html.in | ||
| intro.html.in | ||
| java.html.in | ||
| library.xen | ||
| libvirt-daemon-arch.fig | ||
| libvirt-daemon-arch.png | ||
| libvirt-driver-arch.fig | ||
| libvirt-driver-arch.png | ||
| libvirt-header-bg.png | ||
| libvirt-header-logo.png | ||
| libvirt-net-logical.fig | ||
| libvirt-net-logical.png | ||
| libvirt-net-physical.fig | ||
| libvirt-net-physical.png | ||
| libvirt-object-model.fig | ||
| libvirt-object-model.png | ||
| libvirt.css | ||
| libvirtLogo404.png | ||
| libvirtLogo.png | ||
| locking.html.in | ||
| logging.html.in | ||
| madeWith.png | ||
| main.css | ||
| Makefile.am | ||
| migration-managed-direct.fig | ||
| migration-managed-direct.png | ||
| migration-managed-p2p.fig | ||
| migration-managed-p2p.png | ||
| migration-native.fig | ||
| migration-native.png | ||
| migration-tunnel.fig | ||
| migration-tunnel.png | ||
| migration-unmanaged-direct.fig | ||
| migration-unmanaged-direct.png | ||
| migration.html.in | ||
| newapi.xsl | ||
| news.html.in | ||
| news.xsl | ||
| node.fig | ||
| node.gif | ||
| page.xsl | ||
| pending.html.in | ||
| php.html.in | ||
| python.html.in | ||
| relatedlinks.html.in | ||
| remote.html.in | ||
| search.php.code.in | ||
| search.php.in | ||
| site.xsl | ||
| sitemap.html.in | ||
| storage.html.in | ||
| structures.fig | ||
| subsite.xsl | ||
| testapi.html.in | ||
| testsuites.html.in | ||
| testtck.html.in | ||
| todo.cfg-example | ||
| todo.pl | ||
| uri.html.in | ||
| virshcmdref.html.in | ||
| windows.html.in | ||
| wrapstring.xsl | ||
