2005-12-02 01:16:36 +03:00
## Process this file with automake to produce Makefile.in
2011-07-28 22:56:24 +04:00
2016-01-10 23:14:33 +03:00
## Copyright (C) 2005-2016 Red Hat, Inc.
2013-05-15 03:42:12 +04:00
##
## This library is free software; you can redistribute it and/or
## modify it under the terms of the GNU Lesser General Public
## License as published by the Free Software Foundation; either
## version 2.1 of the License, or (at your option) any later version.
##
## This library is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
## Lesser General Public License for more details.
##
## You should have received a copy of the GNU Lesser General Public
## License along with this library. If not, see
## <http://www.gnu.org/licenses/>.
2011-07-28 22:56:24 +04:00
2019-05-10 17:22:11 +03:00
HTML_DIR = $( docdir) /html
2009-10-02 15:29:15 +04:00
2019-05-10 15:48:46 +03:00
modules = \
libvirt-common \
libvirt-domain \
backup: Introduce virDomainCheckpoint APIs
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.
Note that until we allow snapshots and checkpoints to exist
simultaneously on the same domain (although the actual prevention of
this will be in a separate patch for the sake of an easier revert down
the road), that it is not possible to branch out to create more than
one checkpoint child to a given parent, although it may become
possible later when we revert to a snapshot that coincides with a
checkpoint. This also means that for now, the decision of which
checkpoint becomes the parent of a newly created one is the only
checkpoint with no child (so while there are APIs for dealing with a
current snapshot, we do not need those for checkpoints). We may end
up exposing a notion of a current checkpoint later, but it's easier to
add stuff when proven needed than to blindly support it now and wish
we hadn't exposed it.
The following map shows the API relations to snapshots, with new APIs
on the right:
Operate on a domain object to create/redefine a child:
virDomainSnapshotCreateXML virDomainCheckpointCreateXML
Operate on a child object for lifetime management:
virDomainSnapshotDelete virDomainCheckpointDelete
virDomainSnapshotFree virDomainCheckpointFree
virDomainSnapshotRef virDomainCheckpointRef
Operate on a child object to learn more about it:
virDomainSnapshotGetXMLDesc virDomainCheckpointGetXMLDesc
virDomainSnapshotGetConnect virDomainCheckpointGetConnect
virDomainSnapshotGetDomain virDomainCheckpointGetDomain
virDomainSnapshotGetName virDomainCheckpiontGetName
virDomainSnapshotGetParent virDomainCheckpiontGetParent
virDomainSnapshotHasMetadata (deferred for later)
virDomainSnapshotIsCurrent (no counterpart, see note above)
Operate on a domain object to list all children:
virDomainSnapshotNum (no counterparts, these are the old
virDomainSnapshotListNames racy interfaces)
virDomainSnapshotListAllSnapshots virDomainListAllCheckpoints
Operate on a child object to list descendents:
virDomainSnapshotNumChildren (no counterparts, these are the old
virDomainSnapshotListChildrenNames racy interfaces)
virDomainSnapshotListAllChildren virDomainCheckpointListAllChildren
Operate on a domain to locate a particular child:
virDomainSnapshotLookupByName virDomainCheckpointLookupByName
virDomainSnapshotCurrent (no counterpart, see note above)
virDomainHasCurrentSnapshot (no counterpart, old racy interface)
Operate on a snapshot to roll back to earlier state:
virDomainSnapshotRevert (no counterpart, instead checkpoints
are used in incremental backups via
XML to virDomainBackupBegin)
Signed-off-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
2019-03-13 22:35:26 +03:00
libvirt-domain-checkpoint \
2019-05-10 15:48:46 +03:00
libvirt-domain-snapshot \
libvirt-event \
libvirt-host \
libvirt-interface \
libvirt-network \
libvirt-nodedev \
libvirt-nwfilter \
libvirt-secret \
libvirt-storage \
libvirt-stream \
virterror \
$( NULL)
2019-11-20 17:49:26 +03:00
modules_admin = libvirt-admin
modules_qemu = libvirt-qemu
modules_lxc = libvirt-lxc
2019-11-20 18:17:22 +03:00
all : vpathhack
# This hack enables us to view the web pages
# from within the uninstalled build tree
vpathhack :
@for dir in fonts js logos; \
do \
test -e $$ dir || ln -s $( srcdir) /$$ dir $$ dir ; \
done
@for file in $( css) ; \
do \
test -e $$ file || ln -s $( srcdir) /$$ file $$ file ; \
done
clean-local :
for dir in fonts js logos; \
do \
rm -f $$ dir ; \
done
for file in $( css) ; \
do \
rm -f $$ file ; \
done
2017-11-03 15:09:47 +03:00
apihtml = \
html/index.html \
2014-12-02 09:50:18 +03:00
$( apihtml_generated)
apihtml_generated = \
2019-05-10 15:48:46 +03:00
$( addprefix html/libvirt-,$( addsuffix .html,$( modules) ) ) \
$( NULL)
2007-11-15 16:04:28 +03:00
2019-11-20 17:49:26 +03:00
apiadminhtml = \
html/index-admin.html \
$( apiadminhtml_generated)
apiadminhtml_generated = \
$( addprefix html/libvirt-,$( addsuffix .html,$( modules_admin) ) ) \
$( NULL)
apiqemuhtml = \
html/index-qemu.html \
$( apiqemuhtml_generated)
apiqemuhtml_generated = \
$( addprefix html/libvirt-,$( addsuffix .html,$( modules_qemu) ) ) \
$( NULL)
apilxchtml = \
html/index-lxc.html \
$( apilxchtml_generated)
apilxchtml_generated = \
$( addprefix html/libvirt-,$( addsuffix .html,$( modules_lxc) ) ) \
$( NULL)
2017-11-03 15:09:47 +03:00
apipng = \
html/left.png \
html/up.png \
html/home.png \
2008-04-28 12:29:35 +04:00
html/right.png
2007-11-15 16:04:28 +03:00
2019-11-20 17:23:04 +03:00
apirefdir = $( HTML_DIR) /html
2019-11-20 17:49:26 +03:00
apiref_DATA = $( apihtml) $( apiadminhtml) $( apiqemuhtml) $( apilxchtml) $( apipng)
2019-11-20 17:23:04 +03:00
2017-11-03 15:09:47 +03:00
css = \
2010-10-26 18:34:33 +04:00
generic.css \
libvirt.css \
2017-08-04 15:29:43 +03:00
mobile.css \
2010-10-26 18:34:33 +04:00
main.css
2019-04-05 17:43:07 +03:00
javascript = \
2019-04-05 15:59:31 +03:00
js/main.js \
2019-06-19 17:49:15 +03:00
$( NULL)
2019-04-05 17:43:07 +03:00
2019-11-20 17:23:04 +03:00
javascriptdir = $( HTML_DIR) /js
javascript_DATA = $( javascript)
2017-05-11 12:01:27 +03:00
fonts = \
fonts/LICENSE.md \
fonts/stylesheet.css \
fonts/overpass-bold-italic.woff \
fonts/overpass-bold.woff \
fonts/overpass-italic.woff \
fonts/overpass-light-italic.woff \
fonts/overpass-light.woff \
fonts/overpass-mono-bold.woff \
fonts/overpass-mono-light.woff \
fonts/overpass-mono-regular.woff \
fonts/overpass-mono-semibold.woff \
fonts/overpass-regular.woff
2019-11-20 17:23:04 +03:00
fontsdir = $( HTML_DIR) /fonts
fonts_DATA = $( fonts)
2016-10-31 15:20:53 +03:00
logofiles = \
logos/logo-base.svg \
logos/logo-square.svg \
logos/logo-square-powered.svg \
logos/logo-banner-dark.svg \
logos/logo-banner-light.svg \
logos/logo-square-96.png \
logos/logo-square-128.png \
logos/logo-square-192.png \
logos/logo-square-256.png \
logos/logo-square-powered-96.png \
logos/logo-square-powered-128.png \
logos/logo-square-powered-192.png \
logos/logo-square-powered-256.png \
logos/logo-banner-dark-256.png \
logos/logo-banner-dark-800.png \
logos/logo-banner-light-256.png \
logos/logo-banner-light-800.png
2019-11-20 17:23:04 +03:00
logofilesdir = $( HTML_DIR) /logos
logofiles_DATA = $( logofiles)
2008-04-23 21:08:31 +04:00
png = \
32favicon.png \
2009-04-16 00:42:50 +04:00
libvirt-daemon-arch.png \
libvirt-driver-arch.png \
libvirt-object-model.png \
Add documentation about migration.
This adds a page documenting many aspects of migration:
- The types of migration (managed direct, p2p, unmanaged direct)
- Data transports (native, tunnelled)
- Migration URIs
- Config file handling
- Example scenarios
* libvirt.css: Rules for data tables and diagrams
* Makefile.am: Include extra png/fig files
* migration-managed-direct.fig, migration-managed-direct.png,
migration-managed-direct.png, migration-managed-p2p.png,
migration-native.fig, migration-native.png,
migration-tunnel.fig, migration-tunnel.png,
migration-unmanaged-direct.fig, migration-unmanaged-direct.png:
Diagrams of migration
* migration.html.in, sitemap.html.in: New migration doc
2009-10-02 20:53:51 +04:00
migration-managed-direct.png \
migration-managed-p2p.png \
migration-native.png \
migration-tunnel.png \
migration-unmanaged-direct.png
2008-04-23 21:08:31 +04:00
2007-11-15 16:04:28 +03:00
gif = \
architecture.gif \
2008-04-28 12:29:35 +04:00
node.gif
2007-11-15 16:04:28 +03:00
2012-10-21 04:29:47 +04:00
internals_html_in = \
$( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /internals/*.html.in) )
2019-12-06 20:26:18 +03:00
internals_rst = \
$( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /internals/*.rst) )
internals_rst_html_in = \
$( internals_rst:%.rst= %.html.in)
2019-10-18 16:18:36 +03:00
internals_html = \
$( internals_html_in:%.html.in= %.html) \
$( internals_rst_html_in:%.html.in= %.html)
2012-10-21 04:29:47 +04:00
2019-11-20 17:23:04 +03:00
internalsdir = $( HTML_DIR) /internals
internals_DATA = $( internals_html)
2019-07-08 15:58:56 +03:00
kbase_html_in = \
$( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /kbase/*.html.in) )
2019-10-18 16:18:36 +03:00
kbase_rst = \
$( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /kbase/*.rst) )
kbase_rst_html_in = \
$( kbase_rst:%.rst= %.html.in)
kbase_html = \
$( kbase_html_in:%.html.in= %.html) \
$( kbase_rst_html_in:%.html.in= %.html)
2019-07-08 15:58:56 +03:00
2019-11-20 17:23:04 +03:00
kbasedir = $( HTML_DIR) /kbase
kbase_DATA = $( kbase_html)
2019-10-18 16:18:36 +03:00
manpages_rst = \
manpages/index.rst \
$( NULL)
manpages1_rst = \
$( NULL)
manpages7_rst = \
$( NULL)
manpages8_rst = \
$( NULL)
manpages_rst += \
$( manpages1_rst) \
$( manpages7_rst) \
$( manpages8_rst) \
$( NULL)
manpages_rst_html_in = \
$( manpages_rst:%.rst= %.html.in)
manpages_html = \
$( manpages_rst_html_in:%.html.in= %.html)
man1_MANS = $( manpages1_rst:%.rst= %.1)
man7_MANS = $( manpages7_rst:%.rst= %.7)
man8_MANS = $( manpages8_rst:%.rst= %.8)
%.1 : %.rst
$( AM_V_GEN) $( MKDIR_P) ` dirname $@ ` && \
grep -v '^\.\. contents::' < $< | \
sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \
-e 's|RUNSTATEDIR|$(runstatedir)|g' | \
$( RST2MAN) > $@
%.7 : %.rst
$( AM_V_GEN) $( MKDIR_P) ` dirname $@ ` && \
grep -v '^\.\. contents::' < $< | \
sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \
-e 's|RUNSTATEDIR|$(runstatedir)|g' | \
$( RST2MAN) > $@
%.8 : %.rst
$( AM_V_GEN) $( MKDIR_P) ` dirname $@ ` && \
grep -v '^\.\. contents::' < $< | \
sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \
-e 's|RUNSTATEDIR|$(runstatedir)|g' | \
$( RST2MAN) > $@
manpagesdir = $( HTML_DIR) /manpages
manpages_DATA = $( manpages_html)
2017-01-03 14:22:54 +03:00
# Generate hvsupport.html and news.html first, since they take one extra step.
2019-10-18 18:21:06 +03:00
dot_html_generated_in = \
2016-07-28 11:04:11 +03:00
hvsupport.html.in \
2019-10-18 18:21:06 +03:00
news.html.in
dot_html_in = \
2016-07-28 11:04:11 +03:00
$( notdir $( wildcard $( srcdir) /*.html.in) )
2019-10-18 16:18:36 +03:00
dot_rst = \
$( notdir $( wildcard $( srcdir) /*.rst) )
dot_rst_html_in = \
$( dot_rst:%.rst= %.html)
2019-10-18 18:21:06 +03:00
dot_html = \
$( dot_html_generated_in:%.html.in= %.html) \
2019-10-18 16:18:36 +03:00
$( dot_html_in:%.html.in= %.html) \
$( dot_rst_html_in:%.html.in= %.html)
2007-11-15 16:04:28 +03:00
2019-11-20 17:23:04 +03:00
htmldir = $( HTML_DIR)
html_DATA = $( css) $( png) $( gif) $( dot_html)
2012-02-13 20:46:29 +04:00
apidir = $( pkgdatadir) /api
2015-04-15 17:23:25 +03:00
api_DATA = \
libvirt-api.xml \
libvirt-qemu-api.xml \
2016-06-24 20:27:09 +03:00
libvirt-lxc-api.xml \
libvirt-admin-api.xml
2012-02-13 20:46:29 +04:00
2008-04-23 21:08:31 +04:00
fig = \
2009-04-16 00:42:50 +04:00
libvirt-daemon-arch.fig \
libvirt-driver-arch.fig \
Add documentation about migration.
This adds a page documenting many aspects of migration:
- The types of migration (managed direct, p2p, unmanaged direct)
- Data transports (native, tunnelled)
- Migration URIs
- Config file handling
- Example scenarios
* libvirt.css: Rules for data tables and diagrams
* Makefile.am: Include extra png/fig files
* migration-managed-direct.fig, migration-managed-direct.png,
migration-managed-direct.png, migration-managed-p2p.png,
migration-native.fig, migration-native.png,
migration-tunnel.fig, migration-tunnel.png,
migration-unmanaged-direct.fig, migration-unmanaged-direct.png:
Diagrams of migration
* migration.html.in, sitemap.html.in: New migration doc
2009-10-02 20:53:51 +04:00
libvirt-object-model.fig \
migration-managed-direct.fig \
migration-managed-p2p.fig \
migration-native.fig \
migration-tunnel.fig \
migration-unmanaged-direct.fig
2008-04-23 21:08:31 +04:00
2016-01-10 23:14:33 +03:00
schemadir = $( pkgdatadir) /schemas
2016-01-12 18:22:24 +03:00
schema_DATA = $( wildcard $( srcdir) /schemas/*.rng)
2016-01-10 23:14:33 +03:00
2017-11-03 15:09:47 +03:00
EXTRA_DIST = \
2019-10-08 13:19:30 +03:00
genaclperms.pl \
2017-01-03 14:22:54 +03:00
site.xsl subsite.xsl newapi.xsl page.xsl \
2017-06-26 09:45:44 +03:00
wrapstring.xsl \
2019-10-18 16:18:36 +03:00
$( dot_html_in) $( dot_rst) $( gif) $( apipng) \
2019-10-18 18:21:06 +03:00
$( fig) $( png) $( css) \
2019-04-05 17:43:07 +03:00
$( javascript) $( logofiles) \
2019-10-18 16:18:36 +03:00
$( internals_html_in) $( internals_rst) $( fonts) \
$( kbase_html_in) $( kbase_rst) \
2019-10-18 16:18:36 +03:00
$( manpages_rst) \
2016-10-31 14:25:26 +03:00
aclperms.htmlinc \
2016-10-25 18:31:32 +03:00
hvsupport.pl \
2016-01-10 23:14:33 +03:00
$( schema_DATA)
2007-11-15 16:04:28 +03:00
2015-06-26 11:49:19 +03:00
acl_generated = aclperms.htmlinc
2013-08-08 14:51:01 +04:00
2019-10-18 18:21:06 +03:00
aclperms.htmlinc : $( top_srcdir ) /src /access /viraccessperm .h \
2013-08-08 14:51:01 +04:00
$( srcdir) /genaclperms.pl Makefile.am
2013-08-31 02:05:43 +04:00
$( AM_V_GEN) $( PERL) $( srcdir) /genaclperms.pl $< > $@
2013-08-08 14:51:01 +04:00
2019-10-18 18:21:06 +03:00
CLEANFILES = \
$( dot_html) \
$( apihtml) \
2019-11-20 17:49:26 +03:00
$( apiadminhtml) \
$( apiqemuhtml) \
$( apilxchtml) \
2019-10-18 18:21:06 +03:00
$( internals_html) \
$( kbase_html) \
2019-10-18 16:18:36 +03:00
$( manpages_html) \
$( man1_MANS) \
$( man7_MANS) \
$( man8_MANS) \
2019-11-20 17:37:41 +03:00
$( api_DATA) \
2019-10-18 18:21:06 +03:00
$( dot_html_generated_in) \
aclperms.htmlinc
2009-09-16 21:56:56 +04:00
2017-07-26 18:04:37 +03:00
timestamp = " $( shell if test -n " $$ SOURCE_DATE_EPOCH " ; \
then \
2017-07-28 11:45:26 +03:00
date -u --date= " @ $$ SOURCE_DATE_EPOCH " ; \
2017-07-26 18:04:37 +03:00
else \
2017-07-28 11:45:26 +03:00
date -u; \
2017-07-26 18:04:37 +03:00
fi ) "
2019-10-18 18:21:06 +03:00
hvsupport.html : hvsupport .html .in
2013-08-31 02:05:43 +04:00
2019-10-18 18:21:06 +03:00
hvsupport.html.in : $( srcdir ) /hvsupport .pl $( api_DATA ) \
2015-04-27 12:08:59 +03:00
$( top_srcdir) /src/libvirt_public.syms \
$( top_srcdir) /src/libvirt_qemu.syms $( top_srcdir) /src/libvirt_lxc.syms \
$( top_srcdir) /src/driver.h
2019-10-18 18:21:06 +03:00
$( AM_V_GEN) $( PERL) $( srcdir) /hvsupport.pl $( top_srcdir) $( top_builddir) > $@ \
2013-07-18 19:37:52 +04:00
|| { rm $@ && exit 1; }
2011-05-13 14:00:56 +04:00
2017-01-03 14:22:54 +03:00
news.html.in : \
$( srcdir) /news.xml \
$( srcdir) /news-html.xsl
2017-07-26 19:40:44 +03:00
$( AM_V_GEN) $( XSLTPROC) --nonet \
2017-01-03 14:22:54 +03:00
$( srcdir) /news-html.xsl \
$( srcdir) /news.xml \
2019-07-17 17:28:54 +03:00
>$@ \
|| { rm -f $@ ; exit 1; } ;
2017-01-03 14:22:54 +03:00
EXTRA_DIST += \
$( srcdir) /news.xml \
2017-04-05 14:17:53 +03:00
$( srcdir) /news.rng \
2017-01-03 14:22:54 +03:00
$( srcdir) /news-html.xsl
2009-04-16 00:42:50 +04:00
%.png : %.fig
convert -rotate 90 $< $@
2019-10-18 16:18:36 +03:00
manpages/%.html.in : manpages /%.rst
$( AM_V_GEN) $( MKDIR_P) ` dirname $@ ` && \
grep -v '^:Manual ' < $< | \
sed -e 's|SYSCONFDIR|$(sysconfdir)|g' \
-e 's|RUNSTATEDIR|$(runstatedir)|g' | \
$( RST2HTML) > $@
2019-10-18 16:18:36 +03:00
%.html.in : %.rst
$( AM_V_GEN) $( MKDIR_P) ` dirname $@ ` && \
$( RST2HTML) $< > $@
2016-01-20 18:27:24 +03:00
%.html.tmp : %.html .in site .xsl subsite .xsl page .xsl \
2016-10-31 14:25:26 +03:00
$( acl_generated)
2017-07-26 19:40:44 +03:00
$( AM_V_GEN) name = ` echo $@ | sed -e 's/.tmp//' ` ; \
2016-01-20 15:22:19 +03:00
dir = ` dirname $@ ` ; \
if test " $$ dir " = "." ; \
then \
style = site.xsl; \
else \
$( MKDIR_P) $$ dir; \
style = subsite.xsl; \
fi ; \
2017-07-26 18:04:37 +03:00
$( XSLTPROC) --stringparam pagename $$ name \
2019-11-20 18:24:18 +03:00
--stringparam builddir '$(abs_top_builddir)' \
2017-07-26 18:04:37 +03:00
--stringparam timestamp $( timestamp) --nonet \
2016-01-20 15:22:19 +03:00
$( top_srcdir) /docs/$$ style $< > $@ \
2017-07-26 19:40:44 +03:00
|| { rm $@ && exit 1; }
2008-04-23 21:08:31 +04:00
%.html : %.html .tmp
2019-10-18 18:21:06 +03:00
$( AM_V_GEN) $( XMLLINT) --nonet --format $< > $@ \
|| { rm $@ && exit 1; }
2005-12-02 01:16:36 +03:00
2014-12-02 09:50:18 +03:00
$(apihtml_generated) : html /index .html
2019-11-20 17:49:26 +03:00
$(apiadminhtml_generated) : html /index -admin .html
$(apiqemuhtml_generated) : html /index -qemu .html
$(apilxchtml_generated) : html /index -lxc .html
2014-12-02 09:50:18 +03:00
2016-12-06 16:38:46 +03:00
html/index.html : libvirt -api .xml newapi .xsl page .xsl $( APIBUILD_STAMP )
2019-10-18 18:21:06 +03:00
$( AM_V_GEN) $( XSLTPROC) --nonet -o ./ \
2013-09-20 13:47:39 +04:00
--stringparam builddir '$(abs_top_builddir)' \
2017-07-26 18:04:37 +03:00
--stringparam timestamp $( timestamp) \
2019-11-27 17:03:45 +03:00
$( srcdir) /newapi.xsl libvirt-api.xml
2005-12-02 01:16:36 +03:00
2019-11-20 17:49:26 +03:00
html/index-%.html : libvirt -%-api .xml newapi .xsl page .xsl $( APIBUILD_STAMP )
$( AM_V_GEN) $( XSLTPROC) --nonet -o ./ \
--stringparam builddir '$(abs_top_builddir)' \
--stringparam timestamp $( timestamp) \
--stringparam indexfile $( @:html/%= %) \
2019-11-27 17:03:45 +03:00
$( srcdir) /newapi.xsl $<
check-html :
$( XMLLINT) --nonet --noout html/*.html
check-local : check -html
2019-11-20 17:49:26 +03:00
2010-06-26 02:27:07 +04:00
python_generated_files = \
2019-10-18 18:21:06 +03:00
html/libvirt-libvirt-lxc.html \
html/libvirt-libvirt-qemu.html \
html/libvirt-libvirt-admin.html \
html/libvirt-virterror.html \
2019-11-20 17:37:41 +03:00
$( api_DATA) \
Introduce an LXC specific public API & library
This patch introduces support for LXC specific public APIs. In
common with what was done for QEMU, this creates a libvirt_lxc.so
library and libvirt/libvirt-lxc.h header file.
The actual APIs are
int virDomainLxcOpenNamespace(virDomainPtr domain,
int **fdlist,
unsigned int flags);
int virDomainLxcEnterNamespace(virDomainPtr domain,
unsigned int nfdlist,
int *fdlist,
unsigned int *noldfdlist,
int **oldfdlist,
unsigned int flags);
which provide a way to use the setns() system call to move the
calling process into the container's namespace. It is not
practical to write in a generically applicable manner. The
nearest that we could get to such an API would be an API which
allows to pass a command + argv to be executed inside a
container. Even if we had such a generic API, this LXC specific
API is still useful, because it allows the caller to maintain
the current process context, in particular any I/O streams they
have open.
NB the virDomainLxcEnterNamespace() API is special in that it
runs client side, so does not involve the internal driver API.
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
2012-12-21 17:15:19 +04:00
$( NULL)
2005-12-02 01:16:36 +03:00
2019-10-08 13:19:30 +03:00
APIBUILD = $( top_srcdir) /scripts/apibuild.py
2019-10-18 18:21:06 +03:00
APIBUILD_STAMP = apibuild.py.stamp
CLEANFILES += $( APIBUILD_STAMP)
2012-04-27 20:05:12 +04:00
$(python_generated_files) : $( APIBUILD_STAMP )
2019-10-08 13:19:30 +03:00
$(APIBUILD_STAMP) : $( top_srcdir ) /scripts /apibuild .py \
2015-11-26 17:02:49 +03:00
$( top_srcdir) /include/libvirt/libvirt.h \
$( top_srcdir) /include/libvirt/libvirt-common.h.in \
backup: Introduce virDomainCheckpoint APIs
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.
Note that until we allow snapshots and checkpoints to exist
simultaneously on the same domain (although the actual prevention of
this will be in a separate patch for the sake of an easier revert down
the road), that it is not possible to branch out to create more than
one checkpoint child to a given parent, although it may become
possible later when we revert to a snapshot that coincides with a
checkpoint. This also means that for now, the decision of which
checkpoint becomes the parent of a newly created one is the only
checkpoint with no child (so while there are APIs for dealing with a
current snapshot, we do not need those for checkpoints). We may end
up exposing a notion of a current checkpoint later, but it's easier to
add stuff when proven needed than to blindly support it now and wish
we hadn't exposed it.
The following map shows the API relations to snapshots, with new APIs
on the right:
Operate on a domain object to create/redefine a child:
virDomainSnapshotCreateXML virDomainCheckpointCreateXML
Operate on a child object for lifetime management:
virDomainSnapshotDelete virDomainCheckpointDelete
virDomainSnapshotFree virDomainCheckpointFree
virDomainSnapshotRef virDomainCheckpointRef
Operate on a child object to learn more about it:
virDomainSnapshotGetXMLDesc virDomainCheckpointGetXMLDesc
virDomainSnapshotGetConnect virDomainCheckpointGetConnect
virDomainSnapshotGetDomain virDomainCheckpointGetDomain
virDomainSnapshotGetName virDomainCheckpiontGetName
virDomainSnapshotGetParent virDomainCheckpiontGetParent
virDomainSnapshotHasMetadata (deferred for later)
virDomainSnapshotIsCurrent (no counterpart, see note above)
Operate on a domain object to list all children:
virDomainSnapshotNum (no counterparts, these are the old
virDomainSnapshotListNames racy interfaces)
virDomainSnapshotListAllSnapshots virDomainListAllCheckpoints
Operate on a child object to list descendents:
virDomainSnapshotNumChildren (no counterparts, these are the old
virDomainSnapshotListChildrenNames racy interfaces)
virDomainSnapshotListAllChildren virDomainCheckpointListAllChildren
Operate on a domain to locate a particular child:
virDomainSnapshotLookupByName virDomainCheckpointLookupByName
virDomainSnapshotCurrent (no counterpart, see note above)
virDomainHasCurrentSnapshot (no counterpart, old racy interface)
Operate on a snapshot to roll back to earlier state:
virDomainSnapshotRevert (no counterpart, instead checkpoints
are used in incremental backups via
XML to virDomainBackupBegin)
Signed-off-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
2019-03-13 22:35:26 +03:00
$( top_srcdir) /include/libvirt/libvirt-domain-checkpoint.h \
2015-04-27 12:08:59 +03:00
$( top_srcdir) /include/libvirt/libvirt-domain-snapshot.h \
$( top_srcdir) /include/libvirt/libvirt-domain.h \
$( top_srcdir) /include/libvirt/libvirt-event.h \
$( top_srcdir) /include/libvirt/libvirt-host.h \
$( top_srcdir) /include/libvirt/libvirt-interface.h \
$( top_srcdir) /include/libvirt/libvirt-network.h \
$( top_srcdir) /include/libvirt/libvirt-nodedev.h \
$( top_srcdir) /include/libvirt/libvirt-nwfilter.h \
$( top_srcdir) /include/libvirt/libvirt-secret.h \
$( top_srcdir) /include/libvirt/libvirt-storage.h \
$( top_srcdir) /include/libvirt/libvirt-stream.h \
$( top_srcdir) /include/libvirt/libvirt-lxc.h \
$( top_srcdir) /include/libvirt/libvirt-qemu.h \
2015-04-15 17:23:25 +03:00
$( top_srcdir) /include/libvirt/libvirt-admin.h \
2015-04-27 12:08:59 +03:00
$( top_srcdir) /include/libvirt/virterror.h \
$( top_srcdir) /src/libvirt.c \
backup: Introduce virDomainCheckpoint APIs
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.
Note that until we allow snapshots and checkpoints to exist
simultaneously on the same domain (although the actual prevention of
this will be in a separate patch for the sake of an easier revert down
the road), that it is not possible to branch out to create more than
one checkpoint child to a given parent, although it may become
possible later when we revert to a snapshot that coincides with a
checkpoint. This also means that for now, the decision of which
checkpoint becomes the parent of a newly created one is the only
checkpoint with no child (so while there are APIs for dealing with a
current snapshot, we do not need those for checkpoints). We may end
up exposing a notion of a current checkpoint later, but it's easier to
add stuff when proven needed than to blindly support it now and wish
we hadn't exposed it.
The following map shows the API relations to snapshots, with new APIs
on the right:
Operate on a domain object to create/redefine a child:
virDomainSnapshotCreateXML virDomainCheckpointCreateXML
Operate on a child object for lifetime management:
virDomainSnapshotDelete virDomainCheckpointDelete
virDomainSnapshotFree virDomainCheckpointFree
virDomainSnapshotRef virDomainCheckpointRef
Operate on a child object to learn more about it:
virDomainSnapshotGetXMLDesc virDomainCheckpointGetXMLDesc
virDomainSnapshotGetConnect virDomainCheckpointGetConnect
virDomainSnapshotGetDomain virDomainCheckpointGetDomain
virDomainSnapshotGetName virDomainCheckpiontGetName
virDomainSnapshotGetParent virDomainCheckpiontGetParent
virDomainSnapshotHasMetadata (deferred for later)
virDomainSnapshotIsCurrent (no counterpart, see note above)
Operate on a domain object to list all children:
virDomainSnapshotNum (no counterparts, these are the old
virDomainSnapshotListNames racy interfaces)
virDomainSnapshotListAllSnapshots virDomainListAllCheckpoints
Operate on a child object to list descendents:
virDomainSnapshotNumChildren (no counterparts, these are the old
virDomainSnapshotListChildrenNames racy interfaces)
virDomainSnapshotListAllChildren virDomainCheckpointListAllChildren
Operate on a domain to locate a particular child:
virDomainSnapshotLookupByName virDomainCheckpointLookupByName
virDomainSnapshotCurrent (no counterpart, see note above)
virDomainHasCurrentSnapshot (no counterpart, old racy interface)
Operate on a snapshot to roll back to earlier state:
virDomainSnapshotRevert (no counterpart, instead checkpoints
are used in incremental backups via
XML to virDomainBackupBegin)
Signed-off-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
2019-03-13 22:35:26 +03:00
$( top_srcdir) /src/libvirt-domain-checkpoint.c \
2016-12-06 16:38:46 +03:00
$( top_srcdir) /src/libvirt-domain-snapshot.c \
$( top_srcdir) /src/libvirt-domain.c \
$( top_srcdir) /src/libvirt-host.c \
$( top_srcdir) /src/libvirt-interface.c \
$( top_srcdir) /src/libvirt-network.c \
$( top_srcdir) /src/libvirt-nodedev.c \
$( top_srcdir) /src/libvirt-nwfilter.c \
$( top_srcdir) /src/libvirt-secret.c \
$( top_srcdir) /src/libvirt-storage.c \
$( top_srcdir) /src/libvirt-stream.c \
2015-04-27 12:08:59 +03:00
$( top_srcdir) /src/libvirt-lxc.c \
$( top_srcdir) /src/libvirt-qemu.c \
2019-10-15 13:41:29 +03:00
$( top_srcdir) /src/admin/libvirt-admin.c \
2015-04-27 12:08:59 +03:00
$( top_srcdir) /src/util/virerror.c \
$( top_srcdir) /src/util/virevent.c \
2019-09-17 20:21:14 +03:00
$( top_srcdir) /src/util/virtypedparam-public.c
2019-09-05 18:45:27 +03:00
$( AM_V_GEN) srcdir = $( srcdir) builddir = $( builddir) \
$( RUNUTF8) $( PYTHON) $( APIBUILD)
2012-04-27 20:05:12 +04:00
touch $@