0c1a668aa5722b52a11ff165a61f77cab968e27fTim Reddehase

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

0c1a668aa5722b52a11ff165a61f77cab968e27fTim Reddehase

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

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

]>

<refentry>

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

<refmeta>

<refentrytitle>lxc-create</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-create</refname>

<refpurpose>

creates a container

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-create <replaceable>-n name</replaceable>

<optional>-f config_file</optional>

<optional>-t template</optional></command>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para>

<command>lxc-create</command> creates a system object where is

stored the configuration informations and where can be stored

user information. The identifier <replaceable>name</replaceable>

is used to specify the container to be used with the different

lxc commands.

</para>

<para>

The object is a directory created in <filename>@LXCPATH@</filename>

and identified by its name.

</para>

<para>

The object is the definition of the different resources an

application can use or can see. The more the configuration file

contains informations, the more the container is isolated and

the more the application is jailed.

</para>

<para>

If the configuration file <replaceable>config_file</replaceable>

is not specified, the container will be created with the default

isolation: processes, sysv ipc and mount points.

</para>

</refsect1>

<refsect1>

<title>Options</title>

<variablelist>

<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>-t <replaceable>template</replaceable></option>

</term>

<listitem>

<para>

'template' is the short name of an existing 'lxc-template'

script that is called by lxc-create,

eg. busybox, debian, fedora, lucid, maverick, natty or sshd.

Refer to the examples in <filename>@LXCTEMPLATEDIR@</filename>

for details of the expected script structure.

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title>Diagnostic</title>

<variablelist>

<varlistentry>

<term>The container already exists</term>

<listitem>

<para>

As the message mention it, you try to create a container

but there is a container with the same name. You can use

the <command>lxc-ls -l</command> command to list the

available containers on the system.

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&seealso;

<refsect1>

<title>Author</title>

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

</refsect1>

</refentry>