lxc-start.sgml.in revision 829dd9183cbefccdf38f87463fa5c2719e774204
1281N/A<!--
1186N/A
1186N/Alxc: linux Container library
0N/A
0N/A(C) Copyright IBM Corp. 2007, 2008
0N/A
1281N/AAuthors:
0N/ADaniel Lezcano <dlezcano at fr.ibm.com>
0N/A
0N/AThis library is free software; you can redistribute it and/or
0N/Amodify it under the terms of the GNU Lesser General Public
0N/ALicense as published by the Free Software Foundation; either
0N/Aversion 2.1 of the License, or (at your option) any later version.
0N/A
0N/AThis library is distributed in the hope that it will be useful,
0N/Abut WITHOUT ANY WARRANTY; without even the implied warranty of
0N/AMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
0N/ALesser General Public License for more details.
0N/A
0N/AYou should have received a copy of the GNU Lesser General Public
1297N/ALicense along with this library; if not, write to the Free Software
0N/AFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
1186N/A
1186N/A-->
1186N/A
1186N/A<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
1186N/A
1186N/A<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
1186N/A<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
1186N/A]>
0N/A
1186N/A<refentry>
1186N/A
1186N/A <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
1186N/A
1186N/A <refmeta>
1186N/A <refentrytitle>lxc-start</refentrytitle>
1186N/A <manvolnum>1</manvolnum>
962N/A </refmeta>
1186N/A
1186N/A <refnamediv>
1281N/A <refname>lxc-start</refname>
1281N/A
1281N/A <refpurpose>
1281N/A run an application inside a container.
1281N/A </refpurpose>
1281N/A </refnamediv>
1281N/A
962N/A <refsynopsisdiv>
1281N/A <cmdsynopsis><command>lxc-start <replaceable>-n
1281N/A name</replaceable> <optional>-f
1281N/A config_file</optional> <optional>-c
1281N/A console_file</optional> <optional>-d</optional> <optional>-s
1281N/A KEY=VAL</optional>
1281N/A <optional>command</optional></command></cmdsynopsis>
1281N/A </refsynopsisdiv>
1281N/A
1281N/A <refsect1>
1281N/A <title>Description</title>
1281N/A
1281N/A <para>
1281N/A <command>lxc-start</command> runs the specified
1281N/A <replaceable>command</replaceable> inside the container
1281N/A specified by <replaceable>name</replaceable>.
1281N/A </para>
1281N/A <para>
1281N/A It will setup the container
1281N/A according to the configuration previously defined with the
1281N/A lxc-create command or with the configuration file parameter.
1281N/A If no configuration is
1281N/A defined, the default isolation is used.
1281N/A </para>
1281N/A <para>
1281N/A The orphan process group
1281N/A and daemon are not supported by this command, use
1281N/A the <command>lxc-execute</command> command instead.
1281N/A </para>
1281N/A <para>
1281N/A If no command is specified, <command>lxc-start</command> will
1186N/A use the default
1186N/A <command>"/sbin/init"</command> command to run a system
1186N/A container.
1186N/A </para>
1186N/A
1281N/A </refsect1>
1281N/A
1281N/A <refsect1>
1281N/A
1281N/A <title>Options</title>
1281N/A
1281N/A <variablelist>
1281N/A
1281N/A <varlistentry>
1281N/A <term>
1281N/A <option>-d, --daemon</option>
1281N/A </term>
1281N/A <listitem>
1281N/A <para>
1281N/A Run the container as a daemon. As the container has no
1281N/A more tty, if an error occurs nothing will be displayed,
1281N/A the log file can be used to check the error.
1281N/A </para>
1281N/A </listitem>
1281N/A </varlistentry>
1281N/A
1281N/A <varlistentry>
1281N/A <term>
1281N/A <option>-f, --rcfile <replaceable>config_file</replaceable></option>
1281N/A </term>
1281N/A <listitem>
1281N/A <para>
1281N/A Specify the configuration file to configure the virtualization
1281N/A and isolation functionalities for the container.
1281N/A </para>
1281N/A <para>
1281N/A This configuration file if present will be used even if there is
1281N/A already a configuration file present in the previously created
1281N/A container (via lxc-create).
1281N/A </para>
1281N/A </listitem>
1281N/A </varlistentry>
1281N/A
1281N/A <varlistentry>
1281N/A <term>
1281N/A <option>-c,
1281N/A --console <replaceable>console_file</replaceable></option>
1281N/A </term>
1281N/A <listitem>
1281N/A <para>
1281N/A Specify a file to output the container console. If the
1281N/A option is not specified the output will go the terminal
1281N/A except if the <option>-d</option> is specified.
1281N/A </para>
1281N/A </listitem>
1281N/A </varlistentry>
1404N/A
1281N/A <varlistentry>
1281N/A <term>
1281N/A <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
1281N/A </term>
1281N/A <listitem>
1404N/A <para>
1281N/A Assign value <replaceable>VAL</replaceable> to configuration
1281N/A variable <replaceable>KEY</replaceable>. This overrides any
1281N/A assignment done in <replaceable>config_file</replaceable>.
1281N/A </para>
1281N/A </listitem>
1281N/A </varlistentry>
1281N/A
1281N/A </variablelist>
1281N/A
1281N/A </refsect1>
1281N/A
1281N/A &commonoptions;
1281N/A
1281N/A <refsect1>
1281N/A <title>Diagnostic</title>
1281N/A
1281N/A <variablelist>
1281N/A
1281N/A <varlistentry>
1297N/A <term>The container is busy</term>
1297N/A <listitem>
1281N/A <para>
1281N/A The specified container is already running an
1281N/A application. You should stop it before reuse this
1281N/A container or create a new one.
1281N/A </para>
1281N/A </listitem>
1281N/A </varlistentry>
1281N/A
1281N/A </variablelist>
1281N/A
1281N/A </refsect1>
1281N/A
1281N/A &seealso;
1281N/A
1281N/A <refsect1>
1281N/A <title>Author</title>
1281N/A <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
1281N/A </refsect1>
1281N/A
1281N/A</refentry>
1281N/A
1281N/A<!-- Keep this comment at the end of the file
1281N/ALocal variables:
1281N/Amode: sgml
1281N/Asgml-omittag:t
1281N/Asgml-shorttag:t
1281N/Asgml-minimize-attributes:nil
1281N/Asgml-always-quote-attributes:t
1281N/Asgml-indent-step:2
1281N/Asgml-indent-data:t
1186N/Asgml-parent-document:nil
1281N/Asgml-default-dtd-file:nil
1281N/Asgml-exposed-tags:nil
1186N/Asgml-local-catalogs:nil
1281N/Asgml-local-ecat-files:nil
1281N/AEnd:
1281N/A-->
1281N/A