lxc-autostart.sgml.in revision 2da1f56ce304ad8dbd651d1305de9b6d58dd19db
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber(C) Copyright 2013 Canonical Ltd.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberStéphane Graber <stgraber@ubuntu.com>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberThis library is free software; you can redistribute it and/or
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabermodify it under the terms of the GNU Lesser General Public
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberLicense as published by the Free Software Foundation; either
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graberversion 2.1 of the License, or (at your option) any later version.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberThis library is distributed in the hope that it will be useful,
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graberbut WITHOUT ANY WARRANTY; without even the implied warranty of
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberLesser General Public License for more details.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberYou should have received a copy of the GNU Lesser General Public
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberLicense along with this library; if not, write to the Free Software
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <refentrytitle>lxc-autostart</refentrytitle>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </refpurpose>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </refnamediv>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <refsynopsisdiv>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <cmdsynopsis>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <arg choice="opt">-g <replaceable>groups</replaceable></arg>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </cmdsynopsis>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </refsynopsisdiv>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <command>lxc-autostart</command> processes containers
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber with lxc.start.auto set. It lets the user start, shutdown,
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber kill, restart containers in the right order, waiting the
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber right time. Supports filtering by lxc.group or just run
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber against all defined containers. It can also be used by
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber external tools in list mode where no action will be performed
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber and the list of affected containers (and if relevant, delays)
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber will be shown.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber The <optional>-r</optional>, <optional>-s</optional>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber and <optional>-k</optional> options specify the action to perform.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber If none is specified, then the containers will be started.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <optional>-a</optional> and <optional>-g</optional> are used to
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber specify which containers will be affected. By default only
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber containers without a lxc.group set will be affected.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <optional>-t TIMEOUT</optional> specifies the maximum amount
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber of time to wait for the container to complete the shutdown
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <variablelist>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber Request a reboot of the container.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber Only request a clean shutdown, do not kill the
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber container tasks if the clean shutdown fails.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber Rather than requesting a clean shutdown of the
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber container, explicitly kill all tasks in the container.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber Rather than performing the action, just print
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber the container name.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>
2da1f56ce304ad8dbd651d1305de9b6d58dd19dbKATOH Yasufumi Wait TIMEOUT seconds before hard-stopping the container.
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </varlistentry>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber </variablelist>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber <para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Graber<!-- Keep this comment at the end of the file
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane GraberLocal variables:
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-omittag:t
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-shorttag:t
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-minimize-attributes:nil
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-always-quote-attributes:t
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-indent-step:2
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-indent-data:t
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-parent-document:nil
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-default-dtd-file:nil
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-exposed-tags:nil
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-local-catalogs:nil
a6adab20ff4b58887ff1d4314c5736f54e139386Stéphane Grabersgml-local-ecat-files:nil