configure.ac: add --enable-deprecated flag - lxc-clone and lxc-start-ephemeral are marked deprecated. We add a --enable-deprecated flag to configure.ac allowing us to enable these deprecated executables - update tests to use lxc-copy instead of lxc-clone Signed-off-by: Christian Brauner <christian.brauner@mailbox.org>

Remove legacy versions of lxc-ls lxc-ls nowadays is a C binary so there's no need to keep the python and shell versions around anymore, remove them from the branch and cleanup documentation and Makefiles. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com>

doc: always enable lxc-device.1 Commit ea4679694 replaced the python implementation with a C one. Signed-off-by: Wolfgang Bumiller <w.bumiller@proxmox.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

Add manpage for lxc-copy (A trivial fix for lxc-copy is included.) Signed-off-by: Christian Brauner <christian.brauner@mailbox.org>

doc: Add Korean man pages Signed-off-by: Sungbae Yoo <sungbae.yoo@samsung.com>

doc: Always include the lxc-top manpage Since it's no longer written in lua. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com>

Add support for checkpoint and restore via CRIU This patch adds support for checkpointing and restoring containers via CRIU. It adds two api calls, ->checkpoint and ->restore, which are wrappers around the CRIU CLI. CRIU has an RPC API, but reasons for preferring exec() are discussed in [1]. To checkpoint, users specify a directory to dump the container metadata (CRIU dump files, plus some additional information about veth pairs and which bridges they are attached to) into this directory. On restore, this information is read out of the directory, a CRIU command line is constructed, and CRIU is exec()d. CRIU uses the lxc-restore-net callback (which in turn inspects the image directory with the NIC data) to properly restore the network. This will only work with the current git master of CRIU; anything as of a152c843 should work. There is a known bug where containers which have been restored cannot be checkpointed [2]. [1]: http://lists.openvz.org/pipermail/criu/2014-July/015117.html [2]: http://lists.openvz.org/pipermail/criu/2014-August/015876.html v2: fixed some problems with the s/int/bool return code form api function v3: added a testcase, fixed up the man page synopsis v4: fix a small typo in lxc-test-checkpoint-restore v5: remove a reference to the old CRIU_PATH, and a bad error about the same Signed-off-by: Tycho Andersen <tycho.andersen@canonical.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

doc: Add manpage for lxc-config Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge Hallyn <serge.hallyn@ubuntu.com>

doc: Try to clear some confusion about lxc.conf Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

Remove lxc-version, lxc-ps and lxc-netstat lxc-ps and lxc-netstat have an unfortunate tendency to break every so often, produce mostly unreadable output and should be replaced by a lxc-attach call in 99% of the cases. In an effort to cleanup the lxc-* namespace, I think those two should go, so this patch gets rid of them as well as any reference to them in our documentation. I also think that lxc-version should disappear as it's only a one line shell script printing the version string, so having a whole command just for that seems to be a bit of a waste. Instead, this patch introduces a new --version common option which all binaries will automatically inherit and that'll print LXC_VERSION on stdout and exit 0. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

Deprecate lxc-checkpoint, lxc-kill and lxc-restart Checkpoint/restart isn't currently supported, so let's not carry those binaries around until we have proper CRIU support in the API. lxc-kill is redundant with lxc-stop -k and has been known to confuse user. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

lxc-usernsexec: add a manpage and fix the help output in the program Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

Add missing entry to dist target Apparently this file has gone over 5 years without getting into a dist tarball! Signed-off-by: Stéphane Graber <stgraber@ubuntu.com>

Add lxc-autostart This introduces a new lxc-autostart binary (and associated manpage) which will let you start/shutdown/kill/restart any container that's marked as lxc.start.auto=1. It respects the lxc.start.delay value, sorts by lxc.start.order and filters by lxc.group. By default it'll affect all containers that DO NOT have lxc.group set. If -g is specified, ONLY containers in those group will be affected. To have a command applied to all containers, the -a argument can be used. A -L flag is also offered for distributions wishing to start the containers themselves while still using LXC's calculated order and wait delays. Instead of performing the action, it'll print the container name and (if relevant for the action) the wait time. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

add manpages for lxc-user-nic Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

Add '--enable-api-docs' for doxygen-generated public API docs. Signed-off-by: James Hunt <james.hunt@ubuntu.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

always include the ja manpage sources in make dist These need to be in the dist tarball even if the host packaging system doesn't have docbook2x, otherwise configure will fail to find them. Also, the build system may have docbook2x, even if the packaging system does not. Signed-off-by: Dwight Engen <dwight.engen@oracle.com> Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

doc: Japanese man pages is not generated when docbook-utils is used Character encoding of Japanese man pages is UTF-8. But docbook-utils can't treat it (and don't have --encoding option that use in Makefile). So change to Japanese man pages is not generated when docbook-utils is used. Signed-off-by: KATOH Yasufumi <karma@jazz.email.ne.jp> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

snapshots: add man page and fix up help info a bit. Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

Add Japanese man pages. Japanese man pages is installed under $mandir/ja. At this time, it is based on version 0.9.0.

lxc-stop: use api, remove lxc_shutdown, extend lxc-stop functionality implement c->reboot(c) in the api. Also if the container is not running, return -2. Currently lxc-stop will return 0, so you cannot tell the difference between successfull stopping and noop. Per stgraber's email: - Remove lxc-shutdown - Change lxc-stop so that: * Default behaviour is to call shutdown(), wait 15s for STOPPED, if not STOPPED, print a message to the user and call stop() [ NOTE: actually 60 seconds per followup thread] * We have a -r option to reboot the container (with proper check that the container indeed rebooted within the next 15s) * We have a -s option to shutdown the container without the automatic fallback to stop() * Add a -k option allowing a user to just kill a container (equivalent to old lxc-stop, no shutdown() call and no delay). and update manpages. Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>

Fix 'make clean' This is mostly to make debuild happy as it doesn't tolerate any leftover file when building twice in a row. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

EXTRA_DIST: Fix missing files with "make dist" I recently noticed that the generated tarballs with "make dist" were incomplete unless the configure script was run on a machine with all possible build dependencies. That's wrong as you clearly don't need those dependencies to generate the tarball. This change fixes that. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

Add missing manpages This introduces manpages for: - lxc-checkconfig - lxc-device - lxc-info - lxc-netstat - lxc-shutdown (wasn't in Makefile) - lxc-start-ephemeral - lxc-version This commit also sorts configure.ac and Makefile.am. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

add lxc-unshare man page, and make 'lxc-unshare -h' work. Also fix some tabs-as-spaces in lxc_unshare.c itself. lxc-unshare: run usage() on '-h' Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

Add man page for lxc-clone And doing so pointed out a bug in lxc-clone itself - it claims default fssize is 2G. It's not. Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

add lua binding for the lxc API The lua binding is based closely on the python binding. Also included are a test program for excercising the binding, and an lxc-top utility for showing statistics on running containers. Signed-off-by: Dwight Engen <dwight.engen@oracle.com> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

Install legacy scripts when built without python. Re-introduce the old lxc-ls script and manpage under a new legacy sub-directory. Those will be installed in place of their python equivalent when LXC is built without --enable-python. Any other script ported to python should be added to those lists. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>

Detect which name to use for docbook2x-man docbook2x-man doesn't have the same name on Debian based systems as on RedHat based systems, add some magic to configure.ac to detect and substitute the proper name in Makefile.am Signed-off-by: Stéphane Graber <stgraber@ubuntu.com>

Update documentation to Docbook 4.5 The package 'docbook-tools' [1] required to format Docbook 3.0 into man pages has been obsoleted a long time ago and can no longer be downloaded from its former homepage. Recent versions of that package -- now called 'docbook2X' --, cannot deal with that old markup format anymore (and don't support the '-w all' command line switch either). To remedy these issues, all SGML files have been updated to Docbook 4.5 so that recent versions of docbook2man can process them. [1] http://sources.redhat.com/docbook-tools/ [2] http://docbook2x.sourceforge.net/ Signed-off-by: Peter Simons <simons@cryp.to> Acked-by: Stéphane Graber <stgraber@ubuntu.com>

Revert "Update documentation to Docbook 4.5" This reverts commit 9a84044bc97098821cce2721ea40a1368f17a091. The changes made the branch to fail to build on Ubuntu/Debian, so reverting the commits and re-opening the pull request. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com>

Update documentation to Docbook 4.5 The package 'docbook-tools' [1] required to format Docbook 3.0 into man pages has been obsoleted a long time ago and can no longer be downloaded from its former homepage. Recent versions of that package -- now called 'docbook2X' --, cannot deal with that old markup format anymore (and don't support the '-w all' command line switch either). To remedy these issues, all SGML files have been updated to Docbook 4.5 so that recent versions of docbook2man can process them. [1] http://sources.redhat.com/docbook-tools/ [2] http://docbook2x.sourceforge.net/ Signed-off-by: Peter Simons <simons@cryp.to>

Add man page for lxc-attach Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

update lxc-checkpoint / lxc-restart man Add documentation for checkpoint / restart CLI. Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

change the rootfs mount location and add the README Previous path was $libdir/lxc, changed to $libdir/lxc/rootfs. Added a README file to be placed in this directory, describing the purpose of this empty directory. Having a file to be installed in this directory makes the Makefile to automatically create the directory at install time. Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

lxc: introduce lxc-kill command (v4) lxc-kill send a signal to the process 1 of the container. If this command is used on an application container ran by lxc-execute, the lxc-init will receive the signal and will forward it to the process 2 which is the command specified in the command line. Signed-off-by: Greg Kurz <gkurz@fr.ibm.com> Signed-off-by: Michel Normand <normand@fr.ibm.com> Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

Q: general lxc architecture Patch moves etc/* contents into doc/examples/ and adds --disable-examples configure switch which may be used not to install examples. Default is to install them into ${docdir}/examples (commonly: /usr/share/doc/lxc/examples) Signed-off-by: Andrian Nord <NightNord@gmail.com> Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

Distribute manpages in source tarball Ship the manpages in the source tarball made by 'make dist', and clean them up only during the 'make maintainer-clean' step. This allows distributions not to depend on docbook at lxc build time, because the manpages are already there. Also update the configure warning message to sound less scary. Signed-off-by: Guido Trotter <ultrotter@quaqua.net> Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

don't remove the autoconf generated files Don't clean up the sgml which are generated by configure, otherwise at the next make, the documentation generation will complain about missing files. Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

change man pages to use a common file for common options the common options of lxc commands are now described in one file "common_options.sgml.in" Signed-off-by: Michel Normand <normand@fr.ibm.com> Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

change man pages to use a seealso file for references the common references to lxc man pages are now placed in one file "see_also.sgml.in" Note that the few man pages that refer to man pages that are not lxc ones have two "See Also" paragraph. Signed-off-by: Michel Normand <normand@fr.ibm.com> Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

From: Daniel Lezcano <daniel.lezcano@free.fr> Console support for the system container. Signed-off-by: Daniel Lezcano <daniel.lezcano@free.fr> Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

Add Frequently Asked Question to dist tarball From: Michel Normand <michel.mno@free.fr> Add FAQ to the dist tarball. Signed-off-by: Michel Normand <michel.mno@free.fr> Signed-off-by: Daniel Lezcano <daniel.lezcano@free.fr>

Add lxc.7 man page From: Daniel Lezcano <dlezcano@fr.ibm.com> Added the overview man page for lxc. Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

Added the man page lxc.conf.5 From: Daniel Lezcano <dlezcano@fr.ibm.com> Added the man page for the lxc.conf configuration file. Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

Add the lxc-cgroup man page From: Daniel Lezcano <dlezcano@fr.ibm.com> Added the lxc-cgroup man page Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>

Generate only if docbook is installed From: Daniel Lezcano <dlezcano@fr.ibm.com> Generate the man pages only if the docbook tool is available. Signed-off-by: Daniel Lezcano <dlezcano@fr.ibm.com>