lxc-create.sgml.in revision 0bb4f8cf3b3b984dc150a11cb2e4d83ba4c49970
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumilxc: linux Container library
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi(C) Copyright IBM Corp. 2007, 2008
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiDaniel Lezcano <dlezcano at fr.ibm.com>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiThis library is free software; you can redistribute it and/or
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumimodify it under the terms of the GNU Lesser General Public
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLicense as published by the Free Software Foundation; either
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumiversion 2.1 of the License, or (at your option) any later version.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiThis library is distributed in the hope that it will be useful,
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumibut WITHOUT ANY WARRANTY; without even the implied warranty of
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLesser General Public License for more details.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiYou should have received a copy of the GNU Lesser General Public
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLicense along with this library; if not, write to the Free Software
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH YasufumiFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
faefa7f8584a7d1567df2e6f1f9240a28a6466abStéphane Graber<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi creates a container
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </refpurpose>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </refnamediv>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <refsynopsisdiv>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <cmdsynopsis>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <command>lxc-create <replaceable>-n name</replaceable>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <optional>-f config_file</optional></command>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </cmdsynopsis>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </refsynopsisdiv>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <command>lxc-create</command> creates a system object where is
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi stored the configuration informations and where can be stored
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi user information. The identifier <replaceable>name</replaceable>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi is used to specify the container to be used with the different
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi lxc commands.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi This object is the definition of the different resources an
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi application can use or can see. The more the configuration file
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi contains informations, the more the container is isolated and
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi the more the application is jailed.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi If the configuration file <replaceable>config_file</replaceable>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi is not specified, the container will be created with the default
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi isolation: processes, sysv ipc and mount points.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <variablelist>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi <option>-f <replaceable>config_file</replaceable></option>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi Specify the configuration file to configure the virtualization
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi and isolation functionalities for the container.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi <varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <option>-t <replaceable>template</replaceable></option>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi 'template' is the short name of an existing 'lxc-template'
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi script that is called by lxc-create.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi eg: lxc-debian, lxc-busybox ...
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi Refer to those exemples for details of expecting script structure.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi </variablelist>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <variablelist>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi As the message mention it, you try to create a container
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi but there is a container with the same name. You can use
dc421f3aac1f0e516c763dd156629a8ed2a7b4caKATOH Yasufumi the <command>lxc-ls -l</command> command to list the
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi available containers on the system.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </variablelist>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi<!-- Keep this comment at the end of the file
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLocal variables:
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-omittag:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-shorttag:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-minimize-attributes:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-always-quote-attributes:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-indent-step:2
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-indent-data:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-parent-document:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-default-dtd-file:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-exposed-tags:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-local-catalogs:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-local-ecat-files:nil