lxc-create.sgml.in revision 4d67c1301b9cf6587b0cc2e42f4e61ed6c29097c
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 creates a container
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refpurpose>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refnamediv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <refsynopsisdiv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <cmdsynopsis>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <command>lxc-create <replaceable>-n name</replaceable>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </cmdsynopsis>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsynopsisdiv>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <command>lxc-create</command> creates a system object where is
6a22713f648be8bd21297f57d9b631eb4c537ffeDaniel Lezcano stored the configuration informations and where can be stored
6a22713f648be8bd21297f57d9b631eb4c537ffeDaniel Lezcano user information. The identifier <replaceable>name</replaceable>
6a22713f648be8bd21297f57d9b631eb4c537ffeDaniel Lezcano is used to specify the container to be used with the different
6a22713f648be8bd21297f57d9b631eb4c537ffeDaniel Lezcano lxc commands.
4d67c1301b9cf6587b0cc2e42f4e61ed6c29097cFerenc Wagner The object is a directory created in <filename>@LXCPATH@</filename>
4d67c1301b9cf6587b0cc2e42f4e61ed6c29097cFerenc Wagner and identified by its name.
becc0400fc83516b05a8e76f2cdfbf452cc46c94Michel Normand The object is the definition of the different resources an
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano application can use or can see. The more the configuration file
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano contains informations, the more the container is isolated and
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano the more the application is jailed.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano If the configuration file <replaceable>config_file</replaceable>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano is not specified, the container will be created with the default
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano isolation: processes, sysv ipc and mount points.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <option>-f <replaceable>config_file</replaceable></option>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano Specify the configuration file to configure the virtualization
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano and isolation functionalities for the container.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </listitem>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </varlistentry>
0bb4f8cf3b3b984dc150a11cb2e4d83ba4c49970Michel Normand <varlistentry>
0bb4f8cf3b3b984dc150a11cb2e4d83ba4c49970Michel Normand <option>-t <replaceable>template</replaceable></option>
0bb4f8cf3b3b984dc150a11cb2e4d83ba4c49970Michel Normand 'template' is the short name of an existing 'lxc-template'
4d67c1301b9cf6587b0cc2e42f4e61ed6c29097cFerenc Wagner script that is called by lxc-create,
4d67c1301b9cf6587b0cc2e42f4e61ed6c29097cFerenc Wagner eg. busybox, debian, fedora, ubuntu or sshd.
4d67c1301b9cf6587b0cc2e42f4e61ed6c29097cFerenc Wagner Refer to the examples in <filename>@LXCTEMPLATEDIR@</filename>
4d67c1301b9cf6587b0cc2e42f4e61ed6c29097cFerenc Wagner for details of the expected script structure.
0bb4f8cf3b3b984dc150a11cb2e4d83ba4c49970Michel Normand </varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano </refsect1>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <variablelist>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano <varlistentry>
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano As the message mention it, you try to create a container
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano but there is a container with the same name. You can use
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano the <command>lxc-ls -l</command> command to list the
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano available containers on the system.
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