<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-start</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-start</refname>

<refpurpose>

run an application inside a container.

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis><command>lxc-start <replaceable>-n

name</replaceable> <optional>-f

config_file</optional> <optional>-s KEY=VAL</optional>

<optional>command</optional></command></cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para>

<command>lxc-start</command> runs the specified command inside

the container specified by name. It will setup the container

according the configuration previously defined with the

lxc-create command or with the configuration file parameter and

execute the command inside the container. If no configuration is

defined, the default isolation is used. The orphan process group

and daemon are not supported by this command, use

the <command>lxc-execute</command> command instead.

If no command is specified, <command>lxc-start</command> will

use the default

<command>"/sbin/init"</command> command to run a system

container.

</para>

</refsect1>

<refsect1>

<title>Options</title>

<variablelist>

<varlistentry>

<term>

<option>-d, --daemon</option>

</term>

<listitem>

<para>

Run the container as a daemon. As the container has no

more tty, if an error occurs nothing will be displayed,

the log file can be used to check the error.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-f <replaceable>config_file</replaceable></option>

</term>

<listitem>

<para>

Specify the configuration file to configure the virtualization

and isolation functionalities for the container.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-s <replaceable>KEY=VAL</replaceable></option>

</term>

<listitem>

<para>

Assign value <replaceable>VAL</replaceable> to configuration

variable <replaceable>KEY</replaceable>. This overrides any

assignment done in <replaceable>config_file</replaceable>.

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&commonoptions;

<refsect1>

<title>Diagnostic</title>

<variablelist>

<varlistentry>

<term>The container is busy</term>

<listitem>

<para>

The specified container is already running an

application. You should stop it before reuse this

container or create a new one.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>The container was not found</term>

<listitem>

<para>

The specified container was not created before with

the <command>lxc-create</command>

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&seealso;

<refsect1>

<title>Author</title>

<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

</refsect1>

</refentry>