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
2009-10-02 15:29:15 +04:00
DEVHELP_DIR = $( datadir) /gtk-doc/html/libvirt
2014-11-11 19:28:26 +03:00
apihtml = \
html/index.html \
2014-12-02 09:50:18 +03:00
$( apihtml_generated)
apihtml_generated = \
2016-04-21 15:35:29 +03:00
html/libvirt-libvirt-common.html \
2014-11-11 19:28:26 +03:00
html/libvirt-libvirt-domain.html \
html/libvirt-libvirt-domain-snapshot.html \
html/libvirt-libvirt-event.html \
html/libvirt-libvirt-host.html \
html/libvirt-libvirt-interface.html \
html/libvirt-libvirt-network.html \
html/libvirt-libvirt-nodedev.html \
html/libvirt-libvirt-nwfilter.html \
html/libvirt-libvirt-secret.html \
html/libvirt-libvirt-storage.html \
html/libvirt-libvirt-stream.html \
2008-04-28 12:29:35 +04:00
html/libvirt-virterror.html
2007-11-15 16:04:28 +03:00
2008-04-23 21:08:31 +04:00
apipng = \
2008-04-28 12:29:35 +04:00
html/left.png \
html/up.png \
html/home.png \
html/right.png
2007-11-15 16:04:28 +03:00
2010-02-25 11:28:51 +03:00
devhelphtml = \
2009-10-02 15:29:15 +04:00
devhelp/libvirt.devhelp \
devhelp/index.html \
devhelp/general.html \
devhelp/libvirt-virterror.html
2010-10-26 18:34:33 +04:00
css = \
generic.css \
libvirt.css \
main.css
2009-10-02 15:29:15 +04:00
devhelppng = \
devhelp/home.png \
devhelp/left.png \
devhelp/right.png \
devhelp/up.png
devhelpcss = devhelp/style.css
devhelpxsl = devhelp/devhelp.xsl devhelp/html.xsl
2008-04-23 21:08:31 +04:00
png = \
32favicon.png \
libvirt-header-bg.png \
libvirt-header-logo.png \
libvirtLogo.png \
libvirt-net-logical.png \
libvirt-net-physical.png \
2009-04-16 00:42:50 +04:00
libvirt-daemon-arch.png \
libvirt-driver-arch.png \
libvirt-object-model.png \
2008-04-23 21:08:31 +04:00
madeWith.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) )
internals_html = $( internals_html_in:%.html.in= %.html)
2013-08-31 02:05:43 +04:00
# todo.html is special - it is shipped in the tarball, but we
# have a dedicated 'todo' target to rebuild it from a proper
# config file, all other users are able to build it locally.
# For all other files, since we ship pre-built html in the
# tarball, we must also ship the sources, even when those
# sources are themselves generated.
2016-07-28 11:04:11 +03:00
# Generate hvsupport.html first, since it takes one extra step.
dot_html_in = \
hvsupport.html.in \
2012-10-21 04:29:47 +04:00
todo.html.in \
2016-07-28 11:04:11 +03:00
$( notdir $( wildcard $( srcdir) /*.html.in) )
2008-04-23 21:08:31 +04:00
dot_html = $( dot_html_in:%.html.in= %.html)
2007-11-15 16:04:28 +03:00
2012-08-01 17:29:27 +04:00
dot_php_in = $( notdir $( wildcard $( srcdir) /*.php.in) )
dot_php_code_in = $( dot_php_in:%.php.in= %.php.code.in)
dot_php = $( dot_php_in:%.php.in= %.php)
2011-02-19 00:40:35 +03:00
patches = $( patsubst $( srcdir) /%,%,$( wildcard $( srcdir) /api_extension/*.patch) )
2009-06-09 15:42:41 +04:00
2007-11-15 16:04:28 +03:00
xml = \
libvirt-api.xml \
2009-09-16 22:02:59 +04:00
libvirt-refs.xml
2007-11-15 16:04:28 +03:00
2011-09-14 07:38:39 +04:00
qemu_xml = \
libvirt-qemu-api.xml \
libvirt-qemu-refs.xml
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
lxc_xml = \
libvirt-lxc-api.xml \
libvirt-lxc-refs.xml
2015-04-15 17:23:25 +03:00
admin_xml = \
libvirt-admin-api.xml \
libvirt-admin-refs.xml
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 = \
libvirt-net-logical.fig \
2009-04-16 00:42:50 +04:00
libvirt-net-physical.fig \
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
2007-11-15 16:04:28 +03:00
EXTRA_DIST = \
2013-08-08 14:51:01 +04:00
apibuild.py genaclperms.pl \
2016-08-08 12:36:01 +03:00
site.xsl subsite.xsl newapi.xsl news.xsl page.xsl \
2011-02-11 13:03:31 +03:00
hacking1.xsl hacking2.xsl wrapstring.xsl \
2008-04-28 12:29:35 +04:00
$( dot_html) $( dot_html_in) $( gif) $( apihtml) $( apipng) \
2009-10-02 15:29:15 +04:00
$( devhelphtml) $( devhelppng) $( devhelpcss) $( devhelpxsl) \
2016-06-24 20:27:09 +03:00
$( xml) $( qemu_xml) $( lxc_xml) $( admin_xml) $( fig) $( png) $( css) \
2012-08-01 17:29:27 +04:00
$( patches) $( dot_php_in) $( dot_php_code_in) $( dot_php) \
2012-10-21 04:29:47 +04:00
$( internals_html_in) $( internals_html) \
2013-08-31 02:05:43 +04:00
sitemap.html.in aclperms.htmlinc \
2016-01-10 23:14:33 +03:00
todo.pl hvsupport.pl todo.cfg-example \
$( 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
$(srcdir)/aclperms.htmlinc : $( top_srcdir ) /src /access /viraccessperm .h \
$( 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
2011-02-18 14:12:28 +03:00
MAINTAINERCLEANFILES = \
$( addprefix $( srcdir) /,$( dot_html) ) \
$( addprefix $( srcdir) /,$( apihtml) ) \
2012-08-01 17:29:27 +04:00
$( addprefix $( srcdir) /,$( devhelphtml) ) \
2012-10-21 04:29:47 +04:00
$( addprefix $( srcdir) /,$( internals_html) ) \
2013-08-31 02:05:43 +04:00
$( addprefix $( srcdir) /,$( dot_php) ) \
$( srcdir) /hvsupport.html.in $( srcdir) /aclperms.htmlinc
2009-09-16 21:56:56 +04:00
2012-04-04 15:26:04 +04:00
all-am : web
2005-12-02 01:16:36 +03:00
2011-02-16 17:09:09 +03:00
api : $( srcdir ) /libvirt -api .xml $( srcdir ) /libvirt -refs .xml
2011-09-14 07:38:39 +04:00
qemu_api : $( srcdir ) /libvirt -qemu -api .xml $( srcdir ) /libvirt -qemu -refs .xml
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
lxc_api : $( srcdir ) /libvirt -lxc -api .xml $( srcdir ) /libvirt -lxc -refs .xml
2015-04-15 17:23:25 +03:00
admin_api : $( srcdir ) /libvirt -admin -api .xml $( srcdir ) /libvirt -admin -refs .xml
2005-12-02 01:16:36 +03:00
2012-10-21 04:29:47 +04:00
web : $( dot_html ) $( internals_html ) html /index .html devhelp /index .html \
$( dot_php)
2005-12-02 01:16:36 +03:00
2010-09-21 19:40:32 +04:00
todo.html.in : todo .pl
if [ -f todo.cfg ] ; then \
echo " Generating $@ " ; \
2011-07-14 19:41:38 +04:00
$( PERL) $< > $@ \
2010-09-21 19:40:32 +04:00
|| { rm $@ && exit 1; } ; \
else \
echo " Stubbing $@ " ; \
2013-07-18 19:37:52 +04:00
printf "%s\n" \
"<html xmlns=\"http://www.w3.org/1999/xhtml\">" \
"<body>" \
"<h1>Todo list unavailable: no config file</h1>" \
"</body></html>" > $@ ; \
2010-09-21 19:40:32 +04:00
fi
todo :
rm -f todo.html.in
$( MAKE) todo.html
2015-09-07 11:27:53 +03:00
hvsupport.html : $( srcdir ) /hvsupport .html .in
2013-08-31 02:05:43 +04:00
2014-12-01 16:36:13 +03:00
$(srcdir)/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
$( AM_V_GEN) $( PERL) $( srcdir) /hvsupport.pl $( top_srcdir) /src > $@ \
2013-07-18 19:37:52 +04:00
|| { rm $@ && exit 1; }
2011-05-13 14:00:56 +04:00
2010-09-21 19:40:32 +04:00
.PHONY : todo
2009-04-16 00:42:50 +04:00
%.png : %.fig
convert -rotate 90 $< $@
2016-01-20 18:27:24 +03:00
%.html.tmp : %.html .in site .xsl subsite .xsl page .xsl \
sitemap.html.in $( acl_generated)
2015-09-09 12:45:57 +03:00
@if [ -x $( XSLTPROC) ] ; then \
echo " Generating $@ " ; \
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 ; \
2015-09-09 12:45:57 +03:00
$( XSLTPROC) --stringparam pagename $$ name --nonet \
2016-01-20 15:22:19 +03:00
$( top_srcdir) /docs/$$ style $< > $@ \
2010-04-29 05:32:20 +04:00
|| { rm $@ && exit 1; } ; fi
2008-04-23 21:08:31 +04:00
%.html : %.html .tmp
2010-04-29 05:32:20 +04:00
@if test -x $( XMLLINT) && test -x $( XMLCATALOG) ; then \
2010-10-26 19:07:00 +04:00
if $( XMLCATALOG) '$(XML_CATALOG_FILE)' \
2010-04-29 05:32:20 +04:00
"-//W3C//DTD XHTML 1.0 Strict//EN" > /dev/null ; then \
2008-04-23 21:08:31 +04:00
echo " Validating $@ " ; \
2010-10-26 19:07:00 +04:00
SGML_CATALOG_FILES = '$(XML_CATALOG_FILE)' \
2011-02-17 00:47:39 +03:00
$( XMLLINT) --catalogs --nonet --format --valid $< > $( srcdir) /$@ \
|| { rm $( srcdir) /$@ && exit 1; } ; \
2014-11-28 17:36:18 +03:00
else echo "missing XHTML1 DTD" ; cat $< > $( srcdir) /$@ ; fi ; fi
2005-12-02 01:16:36 +03:00
2012-08-01 17:29:27 +04:00
%.php.tmp : %.php .in site .xsl page .xsl sitemap .html .in
@if [ -x $( XSLTPROC) ] ; then \
echo " Generating $@ " ; \
2013-05-03 18:25:37 +04:00
$( XSLTPROC) --stringparam pagename $( @:.tmp= ) --nonet \
2012-08-01 17:29:27 +04:00
$( top_srcdir) /docs/site.xsl $< > $@ \
|| { rm $@ && exit 1; } ; fi
%.php : %.php .tmp %.php .code .in
2012-09-05 21:55:42 +04:00
@if [ -x $( XSLTPROC) ] ; then \
echo " Scripting $@ " ; \
2013-09-12 13:18:32 +04:00
sed -e '/<span id="php_placeholder"><\/span>/r ' " $( srcdir) / $@ .code.in " \
2012-09-05 21:55:42 +04:00
-e /php_placeholder/d < $@ .tmp > $( srcdir) /$@ \
|| { rm $( srcdir) /$@ && exit 1; } ; fi
2005-12-02 01:16:36 +03:00
2014-12-02 09:50:18 +03:00
$(apihtml_generated) : html /index .html
2009-09-16 21:56:56 +04:00
html/index.html : libvirt -api .xml newapi .xsl page .xsl sitemap .html .in
2011-05-12 14:19:42 +04:00
$( AM_V_GEN) if [ -x $( XSLTPROC) ] ; then \
2011-02-18 14:12:28 +03:00
$( XSLTPROC) --nonet -o $( srcdir) / \
2013-09-20 13:47:39 +04:00
--stringparam builddir '$(abs_top_builddir)' \
2011-07-19 17:34:34 +04:00
$( srcdir) /newapi.xsl $( srcdir) /libvirt-api.xml ; fi && \
2011-05-12 14:19:42 +04:00
if test -x $( XMLLINT) && test -x $( XMLCATALOG) ; then \
2010-10-26 19:07:00 +04:00
if $( XMLCATALOG) '$(XML_CATALOG_FILE)' "-//W3C//DTD XHTML 1.0 Strict//EN" \
2010-04-01 00:58:40 +04:00
> /dev/null ; then \
2010-10-26 19:07:00 +04:00
SGML_CATALOG_FILES = '$(XML_CATALOG_FILE)' \
2011-02-18 14:12:28 +03:00
$( XMLLINT) --catalogs --nonet --valid --noout $( srcdir) /html/*.html ; \
2014-11-28 17:36:18 +03:00
else echo "missing XHTML1 DTD" ; cat $< > $( srcdir) /$@ ; fi ; fi
2005-12-02 01:16:36 +03:00
2010-06-26 02:27:07 +04:00
$(addprefix $(srcdir)/,$(devhelphtml)) : $( srcdir ) /libvirt -api .xml $( devhelpxsl )
2011-05-12 14:19:42 +04:00
$( AM_V_GEN) if [ -x $( XSLTPROC) ] ; then \
2011-02-18 14:12:28 +03:00
$( XSLTPROC) --nonet -o $( srcdir) /devhelp/ \
2011-02-16 17:09:09 +03:00
$( top_srcdir) /docs/devhelp/devhelp.xsl $( srcdir) /libvirt-api.xml ; fi
2009-10-02 15:29:15 +04:00
2011-09-14 07:38:39 +04:00
2010-06-26 02:27:07 +04:00
python_generated_files = \
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
$( srcdir) /html/libvirt-libvirt-lxc.html \
2011-09-14 07:38:39 +04:00
$( srcdir) /html/libvirt-libvirt-qemu.html \
2015-04-15 17:23:25 +03:00
$( srcdir) /html/libvirt-libvirt-admin.html \
2010-06-26 02:27:07 +04:00
$( srcdir) /html/libvirt-virterror.html \
$( srcdir) /libvirt-api.xml \
2011-09-14 07:38:39 +04:00
$( srcdir) /libvirt-refs.xml \
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
$( srcdir) /libvirt-lxc-api.xml \
$( srcdir) /libvirt-lxc-refs.xml \
2011-09-14 07:38:39 +04:00
$( srcdir) /libvirt-qemu-api.xml \
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
$( srcdir) /libvirt-qemu-refs.xml \
2015-04-15 17:23:25 +03:00
$( srcdir) /libvirt-admin-api.xml \
$( srcdir) /libvirt-admin-refs.xml \
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
2012-05-11 18:20:34 +04:00
APIBUILD = $( srcdir) /apibuild.py
APIBUILD_STAMP = $( APIBUILD) .stamp
build: fix 'make distcheck' issues
We had a distributed file (remote_protocol.h, which in turn was
a prereq to remote_driver.c) depending on a generated file
(libvirt_probes.h), which is a no-no for a VPATH build from a
read-only source tree (no wonder 'make distcheck' tests precisely
that situation):
File `libvirt_driver_remote.la' does not exist.
File `libvirt_driver_remote_la-remote_driver.lo' does not exist.
Prerequisite `libvirt_probes.h' is newer than target `../../src/remote/remote_protocol.h'.
Must remake target `../../src/remote/remote_protocol.h'.
Invoking recipe from Makefile:7464 to update target `../../src/remote/remote_protocol.h'.
make[3]: Entering directory `/home/remote/eblake/libvirt-tmp2/build/libvirt-0.9.12/_build/src'
GEN ../../src/remote/remote_protocol.h
cannot create ../../src/remote/remote_protocol.h: Permission denied at ../../src/rpc/genprotocol.pl line 31.
make[3]: *** [../../src/remote/remote_protocol.h] Error 13
Rather than making distributed .c files depend on generated files, we
really want to ensure that compilation into .lo files is not attempted
until the generated files are present, done by this patch. Since there
were two different sets of conditionally generated files that both
feed the .lo file, I had to introduce a new variable REMOTE_DRIVER_PREREQS
to keep automake happy.
After that fix, the next issue was that make treats './foo' and 'foo'
differently in determining whether an implicit %foo rule is applicable,
with the result that locking/qemu-sanlock.conf wasn't properly being
built at the right times. Also, the output for using the .aug test
files was a bit verbose.
After fixing the src directory, the next error is related to the docs
directory, where the tarball is missing a stamp file and thus tries to
regenerate files that are already present:
GEN ../../docs/apibuild.py.stamp
Traceback (most recent call last):
File "../../docs/apibuild.py", line 2511, in <module>
rebuild("libvirt")
File "../../docs/apibuild.py", line 2495, in rebuild
builder.serialize()
File "../../docs/apibuild.py", line 2424, in serialize
output = open(filename, "w")
IOError: [Errno 13] Permission denied: '../../docs/libvirt-api.xml'
make[5]: *** [../../docs/apibuild.py.stamp] Error 1
and fixing that exposed another case of a distributed file (generated
html) depending on a built file (libvirt.h), but only when doing an
in-tree build, because of a file glob.
* src/Makefile.am ($(srcdir)/remote/remote_driver.c): Change...
(libvirt_driver_remote_la-remote_driver.lo): ...to the real
dependency.
($(builddir)/locking/%-sanlock.conf): Drop $(builddir), so that
rule gets run in time for test_libvirt_sanlock.aug.
(test_libvir*.aug): Cater to silent build.
(conf_DATA): Don't ship qemu-sanlock.conf in the tarball, since it
is trivial to regenerate.
* docs/Makefile.am (EXTRA_DIST): Ship our stamp file.
($(APIBUILD_STAMP)): Don't depend on generated file.
2012-05-30 21:30:18 +04:00
EXTRA_DIST += $( APIBUILD_STAMP)
2012-04-27 20:05:12 +04:00
$(python_generated_files) : $( APIBUILD_STAMP )
$(APIBUILD_STAMP) : $( srcdir ) /apibuild .py \
2015-11-26 17:02:49 +03:00
$( top_srcdir) /include/libvirt/libvirt.h \
$( top_srcdir) /include/libvirt/libvirt-common.h.in \
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 \
$( top_srcdir) /src/libvirt-lxc.c \
$( top_srcdir) /src/libvirt-qemu.c \
2015-04-15 17:23:25 +03:00
$( top_srcdir) /src/libvirt-admin.c \
2015-04-27 12:08:59 +03:00
$( top_srcdir) /src/util/virerror.c \
$( top_srcdir) /src/util/virevent.c \
$( top_srcdir) /src/util/virtypedparam.c
2016-04-25 14:40:04 +03:00
$( AM_V_GEN) srcdir = $( srcdir) builddir = $( builddir) $( PYTHON) $( APIBUILD)
2012-04-27 20:05:12 +04:00
touch $@
2010-02-25 12:35:20 +03:00
2010-05-27 01:56:04 +04:00
check-local : all
2013-08-31 01:03:52 +04:00
dist-local : all
2010-05-27 01:56:04 +04:00
2005-12-02 01:16:36 +03:00
clean-local :
2010-07-10 16:49:26 +04:00
rm -f *~ *.bak *.hierarchy *.signals *-unused.txt *.html
2005-12-02 01:16:36 +03:00
maintainer-clean-local : clean -local
2013-07-18 19:37:52 +04:00
rm -rf $( srcdir) /libvirt-api.xml $( srcdir) /libvirt-refs.xml \
2013-08-31 02:05:43 +04:00
todo.html.in
2011-09-14 07:38:39 +04:00
rm -rf $( srcdir) /libvirt-qemu-api.xml $( srcdir) /libvirt-qemu-refs.xml
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
rm -rf $( srcdir) /libvirt-lxc-api.xml $( srcdir) /libvirt-lxc-refs.xml
2015-04-15 17:23:25 +03:00
rm -rf $( srcdir) /libvirt-admin-api.xml $( srcdir) /libvirt-admin-refs.xml
2012-04-27 20:05:12 +04:00
rm -rf $( APIBUILD_STAMP)
2005-12-02 01:16:36 +03:00
2015-04-15 17:23:25 +03:00
rebuild : api qemu_api lxc_api admin_api all
2005-12-02 01:16:36 +03:00
2008-02-05 22:27:37 +03:00
install-data-local :
2005-12-07 16:45:20 +03:00
$( mkinstalldirs) $( DESTDIR) $( HTML_DIR)
2010-10-26 18:34:33 +04:00
for f in $( css) $( dot_html) $( gif) $( png) ; do \
$( INSTALL) -m 0644 $( srcdir) /$$ f $( DESTDIR) $( HTML_DIR) ; done
2005-12-07 16:45:20 +03:00
$( mkinstalldirs) $( DESTDIR) $( HTML_DIR) /html
2008-04-23 21:08:31 +04:00
for h in $( apihtml) ; do \
2008-04-28 12:29:35 +04:00
$( INSTALL) -m 0644 $( srcdir) /$$ h $( DESTDIR) $( HTML_DIR) /html; done
2008-04-23 21:08:31 +04:00
for p in $( apipng) ; do \
2008-04-28 12:29:35 +04:00
$( INSTALL) -m 0644 $( srcdir) /$$ p $( DESTDIR) $( HTML_DIR) /html; done
2012-10-21 04:29:47 +04:00
$( mkinstalldirs) $( DESTDIR) $( HTML_DIR) /internals
for f in $( internals_html) ; do \
$( INSTALL) -m 0644 $( srcdir) /$$ f $( DESTDIR) $( HTML_DIR) /internals; done
2009-10-02 15:29:15 +04:00
$( mkinstalldirs) $( DESTDIR) $( DEVHELP_DIR)
for file in $( devhelphtml) $( devhelppng) $( devhelpcss) ; do \
2010-01-15 13:09:01 +03:00
$( INSTALL) -m 0644 $( srcdir) /$$ { file} $( DESTDIR) $( DEVHELP_DIR) ; \
2009-10-02 15:29:15 +04:00
done
2013-03-30 01:25:13 +04:00
$( INSTALL_DATA) $( srcdir) /libvirtLogo.png $( DESTDIR) $( pkgdatadir)
2007-11-15 16:04:28 +03:00
uninstall-local :
2016-04-19 14:22:27 +03:00
for f in $( css) $( dot_html) $( gif) $( png) ; do \
rm -f $( DESTDIR) $( HTML_DIR) /$$ f; \
done
2016-02-13 13:19:44 +03:00
for h in $( apihtml) ; do rm -f $( DESTDIR) $( HTML_DIR) /$$ h; done
for p in $( apipng) ; do rm -f $( DESTDIR) $( HTML_DIR) /$$ p; done
2016-04-19 14:22:27 +03:00
for f in $( internals_html) ; do \
rm -f $( DESTDIR) $( HTML_DIR) /$$ f; \
done
2009-10-02 15:29:15 +04:00
for f in $( devhelphtml) $( devhelppng) $( devhelpcss) ; do \
2016-02-13 13:19:44 +03:00
rm -f $( DESTDIR) $( DEVHELP_DIR) /$$ ( basename $$ f) ; \
2010-01-09 11:56:20 +03:00
done
2016-04-19 12:20:10 +03:00
rm -f $( DESTDIR) $( pkgdatadir) /libvirtLogo.png