libvirt/docs/schemas
Eric Blake 252958ee16 backup: Document new XML for backups
Prepare for new backup APIs by describing the XML that will represent
a backup.  The XML resembles snapshots and checkpoints in being able
to select actions for a set of disks, but has other differences.  It
can support both push model (the hypervisor does the backup directly
into the destination file) and pull model (the hypervisor exposes an
access port for a third party to grab what is necessary).  Add
testsuite coverage for some minimal uses of the XML.

The <disk> element within <domainbackup> tries to model the same
elements as a <disk> under <domain>, but sharing the RNG grammar
proved to be hairy. That is in part because while <domain> use
<source> to describe a host resource in use by the guest, a backup job
is using a host resource that is not visible to the guest: a push
backup action is instead describing a <target> (which ultimately could
be a remote network resource, but for simplicity the RNG just
validates a local file for now), and a pull backup action is instead
describing a temporary local file <scratch> (which probably should not
be a remote resource).  A future refactoring may thus introduce some
way to parameterize RNG to accept <disk type='FOO'>...</disk> so that
the name of the subelement can be <source> for domain, or <target> or
<scratch> as needed for backups. Future patches may improve this area
of code.

Signed-off-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
2019-12-10 12:41:56 +01:00
..
basictypes.rng virpci: Allow greater PCI domain value in virPCIDeviceAddressIsValid 2019-08-05 19:42:15 +02:00
capability.rng schema: capabilities: Add 'hap' feature flag 2019-11-13 08:16:04 +01:00
cputypes.rng conf: Introduce memoryBacking/discard 2018-05-14 09:42:20 +02:00
domain.rng conf: set up for per-grammar overrides in schemas 2014-04-15 21:07:59 +02:00
domainbackup.rng backup: Document new XML for backups 2019-12-10 12:41:56 +01:00
domaincaps.rng conf: domcaps: Add 'backingStoreInput' domain capability 2019-11-22 12:51:27 +01:00
domaincheckpoint.rng backup: Document new XML for checkpoints 2019-07-26 16:48:58 -05:00
domaincommon.rng rng: Extend the range of driveUnit 2019-12-04 13:20:57 +01:00
domainsnapshot.rng docs: schemas: Add 'seclabel' for external disk snapshot 2019-06-20 17:08:53 +02:00
interface.rng schema: remove reference to brctl 2018-06-07 16:30:59 +02:00
network.rng network: wire up dnsmasq option xmlns 2019-07-17 17:18:56 -04:00
networkcommon.rng conf: introduce virNetworkPortDefPtr struct and XML support 2019-06-17 15:19:54 +01:00
networkport.rng conf: introduce virNetworkPortDefPtr struct and XML support 2019-06-17 15:19:54 +01:00
nodedev.rng xml: nodedev: make pci capability class element optional 2019-03-22 12:59:56 +03:00
nwfilter_params.rng schemas: add schema for nwfilter binding XML document 2018-06-26 11:22:07 +01:00
nwfilter.rng schemas: add schema for nwfilter binding XML document 2018-06-26 11:22:07 +01:00
nwfilterbinding.rng schemas: add schema for nwfilter binding XML document 2018-06-26 11:22:07 +01:00
secret.rng secret: Add support for usage type vTPM, extend schema and test case 2019-07-26 09:59:27 +01:00
storagecommon.rng storage: optional 'refresh' elemement on pool 2019-03-19 16:46:21 +01:00
storagepool.rng storage: escape ipv6 for ceph mon hosts to librados 2019-06-18 17:14:17 +02:00
storagepoolcaps.rng docs: Add schema for storage pool capabilities 2019-03-06 11:12:48 -05:00
storagevol.rng docs: schemas: Fix missing timestamp inside backingStore 2018-09-11 10:44:26 +02:00