lxc-execute.sgml.in revision 94b81f611fde1efdda844171d7b0d1f2d8f86ce6
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanolxc: linux Container library
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano(C) Copyright IBM Corp. 2007, 2008
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoDaniel Lezcano <dlezcano at fr.ibm.com>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoThis library is free software; you can redistribute it and/or
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanomodify it under the terms of the GNU Lesser General Public
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLicense as published by the Free Software Foundation; either
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoversion 2.1 of the License, or (at your option) any later version.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoThis library is distributed in the hope that it will be useful,
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanobut WITHOUT ANY WARRANTY; without even the implied warranty of
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLesser General Public License for more details.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoYou should have received a copy of the GNU Lesser General Public
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLicense along with this library; if not, write to the Free Software
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
10fba81b9d0221b8e47aa1e0b43236413b7d28dfMichel Normand<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refnamediv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refpurpose>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano run an application inside a container.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refpurpose>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refnamediv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refsynopsisdiv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <cmdsynopsis>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <command>lxc-execute <replaceable>-n name</replaceable>
201172806c477ecb36bc00fad92b85e067712c38Cedric Le Goater <optional>-f config_file</optional> <optional>-s KEY=VAL
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </cmdsynopsis>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsynopsisdiv>
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand <command>lxc-execute</command> runs the specified
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand <replaceable>command</replaceable> inside the container
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand specified by <replaceable>name</replaceable>.
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand It will setup the container
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand according to the configuration previously defined with the
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand lxc-create command or with the configuration file parameter.
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand If no configuration is
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand defined, the default isolation is used.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano This command is mainly used when you want to quickly launch an
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand application in an isolated environment.
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand <command>lxc-execute</command> command will run the
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand specified command into the container via an intermediate
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand This lxc-init after launching the specified command,
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand will wait for its end and all other reparented processes.
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand (that allows to support daemons in the container).
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand In other words, in the
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand container, <command>lxc-init</command> has the pid 1 and the
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand first process of the application has the pid 2.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand <option>-f, --rcfile <replaceable>config_file</replaceable></option>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano Specify the configuration file to configure the virtualization
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano and isolation functionalities for the container.
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand This configuration file if present will be used even if there is
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand already a configuration file present in the previously created
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand container (via lxc-create).
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </listitem>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </varlistentry>
201172806c477ecb36bc00fad92b85e067712c38Cedric Le Goater <varlistentry>
94b81f611fde1efdda844171d7b0d1f2d8f86ce6Michel Normand <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
201172806c477ecb36bc00fad92b85e067712c38Cedric Le Goater Assign value <replaceable>VAL</replaceable> to configuration
201172806c477ecb36bc00fad92b85e067712c38Cedric Le Goater variable <replaceable>KEY</replaceable>. This overrides any
201172806c477ecb36bc00fad92b85e067712c38Cedric Le Goater assignment done in <replaceable>config_file</replaceable>.
201172806c477ecb36bc00fad92b85e067712c38Cedric Le Goater </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
10fba81b9d0221b8e47aa1e0b43236413b7d28dfMichel Normand &commonoptions;
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano The specified container is already running an
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano application. You should stop it before reuse this
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano container or create a new one.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </listitem>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano<!-- Keep this comment at the end of the file
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoLocal variables:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-omittag:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-shorttag:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-minimize-attributes:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-always-quote-attributes:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-indent-step:2
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-indent-data:t
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-parent-document:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-default-dtd-file:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-exposed-tags:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-local-catalogs:nil
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanosgml-local-ecat-files:nil