[libvirt] [PATCH v9 02/13] backup: Introduce virDomainCheckpoint APIs

Cole Robinson crobinso at redhat.com
Tue Jul 16 15:38:42 UTC 2019


On 7/6/19 11:56 PM, Eric Blake wrote:
> Introduce a bunch of new public APIs related to backup checkpoints.
> Checkpoints are modeled heavily after virDomainSnapshotPtr (both
> represent a point in time of the guest), although a snapshot exists
> with the intent of rolling back to that state, while a checkpoint
> exists to make it possible to create an incremental backup at a later
> time.  We may have a future hypervisor that can completely manage
> checkpoints without libvirt metadata, but the first two planned
> hypervisors (qemu and test) both always use libvirt for tracking
> metadata relations between checkpoints, so for now, I've deferred
> the counterpart of virDomainSnapshotHasMetadata for a separate
> API addition at a later date if there is ever a need for it.
> 

...

> +/**
> + * virDomainCheckpointCreateXML:
> + * @domain: a domain object
> + * @xmlDesc: description of the checkpoint to create
> + * @flags: bitwise-OR of supported virDomainCheckpointCreateFlags
> + *
> + * Create a new checkpoint using @xmlDesc, with a top-level
> + * <domaincheckpoint> element, on a running @domain.  Note that @xmlDesc
> + * must validate against the <domaincheckpoint> XML schema.
> + *
> + * See <a href=formatcheckpoint.html#CheckpointAttributes">Checkpoint XML</a>

Missing a " after href=

- Cole




More information about the libvir-list mailing list