mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-09-09 01:04:59 +00:00
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>
182 lines
7.2 KiB
XML
182 lines
7.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html>
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<body class="docs">
|
|
<div class="panel">
|
|
<h2>Deployment / operation</h2>
|
|
|
|
<dl>
|
|
<dt><a href="apps.html">Applications</a></dt>
|
|
<dd>Applications known to use libvirt</dd>
|
|
|
|
<dt><a href="windows.html">Windows</a></dt>
|
|
<dd>Downloads for Windows</dd>
|
|
|
|
<dt><a href="migration.html">Migration</a></dt>
|
|
<dd>Migrating guests between machines</dd>
|
|
|
|
<dt><a href="remote.html">Remote access</a></dt>
|
|
<dd>Enable remote access over TCP</dd>
|
|
|
|
<dt><a href="tlscerts.html">TLS certs</a></dt>
|
|
<dd>Generate and deploy x509 certificates for TLS</dd>
|
|
|
|
<dt><a href="auth.html">Authentication</a></dt>
|
|
<dd>Configure authentication for the libvirt daemon</dd>
|
|
|
|
<dt><a href="acl.html">Access control</a></dt>
|
|
<dd>Configure access control libvirt APIs with <a href="aclpolkit.html">polkit</a></dd>
|
|
|
|
<dt><a href="logging.html">Logging</a></dt>
|
|
<dd>The library and the daemon logging support</dd>
|
|
|
|
<dt><a href="auditlog.html">Audit log</a></dt>
|
|
<dd>Audit trail logs for host operations</dd>
|
|
|
|
<dt><a href="firewall.html">Firewall</a></dt>
|
|
<dd>Firewall and network filter configuration</dd>
|
|
|
|
<dt><a href="hooks.html">Hooks</a></dt>
|
|
<dd>Hooks for system specific management</dd>
|
|
|
|
<dt><a href="nss.html">NSS module</a></dt>
|
|
<dd>Enable domain host name translation to IP addresses</dd>
|
|
|
|
<dt><a href="http://wiki.libvirt.org/page/FAQ">FAQ</a></dt>
|
|
<dd>Frequently asked questions</dd>
|
|
</dl>
|
|
|
|
</div>
|
|
|
|
<div class="panel">
|
|
<h2>Application development</h2>
|
|
<dl>
|
|
<dt><a href="devguide.html">Development Guide</a></dt>
|
|
<dd>A guide and reference for developing with libvirt</dd>
|
|
|
|
<dt><a href="virshcmdref.html">Virsh Commands</a></dt>
|
|
<dd>Command reference for virsh</dd>
|
|
|
|
<dt><a href="bindings.html">Language bindings and API modules</a></dt>
|
|
<dd>Bindings of the libvirt API for
|
|
<a href="csharp.html">c#</a>,
|
|
<a href="https://godoc.org/github.com/libvirt/libvirt-go">go</a>,
|
|
<a href="java.html">java</a>,
|
|
<a href="https://libvirt.org/ocaml/">ocaml</a>,
|
|
<a href="http://search.cpan.org/dist/Sys-Virt/">perl</a>,
|
|
<a href="python.html">python</a>,
|
|
<a href="php.html">php</a>,
|
|
<a href="https://libvirt.org/ruby/">ruby</a>
|
|
and integration API modules for
|
|
<a href="dbus.html">D-Bus</a></dd>
|
|
|
|
|
|
<dt><a href="format.html">XML schemas</a></dt>
|
|
<dd>Description of the XML schemas for
|
|
<a href="formatdomain.html">domains</a>,
|
|
<a href="formatnetwork.html">networks</a>,
|
|
<a href="formatnetworkport.html">network ports</a>,
|
|
<a href="formatnwfilter.html">network filtering</a>,
|
|
<a href="formatstorage.html">storage</a>,
|
|
<a href="formatstorageencryption.html">storage encryption</a>,
|
|
<a href="formatcaps.html">capabilities</a>,
|
|
<a href="formatdomaincaps.html">domain capabilities</a>,
|
|
<a href="formatstoragecaps.html">storage pool capabilities</a>,
|
|
<a href="formatnode.html">node devices</a>,
|
|
<a href="formatsecret.html">secrets</a>,
|
|
<a href="formatsnapshot.html">snapshots</a>,
|
|
<a href="formatcheckpoint.html">checkpoints</a>,
|
|
<a href="formatbackup.html">backup jobs</a></dd>
|
|
|
|
<dt><a href="uri.html">URI format</a></dt>
|
|
<dd>The URI formats used for connecting to libvirt</dd>
|
|
|
|
<dt><a href="cgroups.html">CGroups</a></dt>
|
|
<dd>Control groups integration</dd>
|
|
|
|
<dt><a href="html/index.html">API reference</a></dt>
|
|
<dd>Reference manual for the C public API, split in
|
|
<a href="html/libvirt-libvirt-common.html">common</a>,
|
|
<a href="html/libvirt-libvirt-domain.html">domain</a>,
|
|
<a href="html/libvirt-libvirt-domain-checkpoint.html">domain checkpoint</a>,
|
|
<a href="html/libvirt-libvirt-domain-snapshot.html">domain snapshot</a>,
|
|
<a href="html/libvirt-virterror.html">error</a>,
|
|
<a href="html/libvirt-libvirt-event.html">event</a>,
|
|
<a href="html/libvirt-libvirt-host.html">host</a>,
|
|
<a href="html/libvirt-libvirt-interface.html">interface</a>,
|
|
<a href="html/libvirt-libvirt-network.html">network</a>,
|
|
<a href="html/libvirt-libvirt-nodedev.html">node device</a>,
|
|
<a href="html/libvirt-libvirt-nwfilter.html">network filter</a>,
|
|
<a href="html/libvirt-libvirt-secret.html">secret</a>,
|
|
<a href="html/libvirt-libvirt-storage.html">storage</a>,
|
|
<a href="html/libvirt-libvirt-stream.html">stream</a>
|
|
and
|
|
<a href="html/index-admin.html">admin</a>,
|
|
<a href="html/index-qemu.html">QEMU</a>,
|
|
<a href="html/index-lxc.html">LXC</a> libs
|
|
</dd>
|
|
|
|
<dt><a href="drivers.html">Drivers</a></dt>
|
|
<dd>Hypervisor specific driver information</dd>
|
|
|
|
<dt><a href="support.html">Support guarantees</a></dt>
|
|
<dd>Details of support status for various interfaces</dd>
|
|
|
|
<dt><a href="hvsupport.html">Driver support</a></dt>
|
|
<dd>matrix of API support per hypervisor per release</dd>
|
|
|
|
<dt><a href="kbase.html">Knowledge Base</a></dt>
|
|
<dd>Task oriented guides to key features</dd>
|
|
</dl>
|
|
</div>
|
|
|
|
<div class="panel">
|
|
<h2>Project development</h2>
|
|
<dl>
|
|
<dt><a href="hacking.html">Contributor guidelines</a></dt>
|
|
<dd>General hacking guidelines for contributors</dd>
|
|
|
|
<dt><a href="styleguide.html">Docs style guide</a></dt>
|
|
<dd>Style guidelines for reStructuredText docs</dd>
|
|
|
|
<dt><a href="strategy.html">Project strategy</a></dt>
|
|
<dd>Sets a vision for future direction & technical choices</dd>
|
|
|
|
<dt><a href="bugs.html">Bug reports</a></dt>
|
|
<dd>How and where to report bugs and request features</dd>
|
|
|
|
<dt><a href="compiling.html">Compiling</a></dt>
|
|
<dd>How to compile libvirt</dd>
|
|
|
|
<dt><a href="goals.html">Goals</a></dt>
|
|
<dd>Terminology and goals of libvirt API</dd>
|
|
|
|
<dt><a href="api.html">API concepts</a></dt>
|
|
<dd>The libvirt API concepts</dd>
|
|
|
|
<dt><a href="api_extension.html">API extensions</a></dt>
|
|
<dd>Adding new public libvirt APIs</dd>
|
|
|
|
<dt><a href="internals/eventloop.html">Event loop and worker pool</a></dt>
|
|
<dd>Libvirt's event loop and worker pool mode</dd>
|
|
|
|
<dt><a href="internals/command.html">Spawning commands</a></dt>
|
|
<dd>Spawning commands from libvirt driver code</dd>
|
|
|
|
<dt><a href="internals/rpc.html">RPC protocol & APIs</a></dt>
|
|
<dd>RPC protocol information and API / dispatch guide</dd>
|
|
|
|
<dt><a href="internals/locking.html">Lock managers</a></dt>
|
|
<dd>Use lock managers to protect disk content</dd>
|
|
|
|
<dt><a href="testsuites.html">Functional testing</a></dt>
|
|
<dd>Testing libvirt with <a href="testtck.html">TCK test suite</a> and
|
|
<a href="testapi.html">Libvirt-test-API</a></dd>
|
|
</dl>
|
|
</div>
|
|
|
|
<br class="clear"/>
|
|
|
|
</body>
|
|
</html>
|