~ubuntu-branches/ubuntu/quantal/lxc/quantal-201205292108

« back to all changes in this revision

Viewing changes to doc/lxc-create.sgml.in

  • Committer: Bazaar Package Importer
  • Author(s): Guido Trotter
  • Date: 2009-04-29 17:49:13 UTC
  • Revision ID: james.westby@ubuntu.com-20090429174913-jvahs1ykizqtodje
Tags: upstream-0.6.2
ImportĀ upstreamĀ versionĀ 0.6.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- 
 
2
 
 
3
lxc: linux Container library
 
4
 
 
5
(C) Copyright IBM Corp. 2007, 2008
 
6
 
 
7
Authors:
 
8
Daniel Lezcano <dlezcano at fr.ibm.com>
 
9
 
 
10
This library is free software; you can redistribute it and/or
 
11
modify it under the terms of the GNU Lesser General Public
 
12
License as published by the Free Software Foundation; either
 
13
version 2.1 of the License, or (at your option) any later version.
 
14
 
 
15
This library is distributed in the hope that it will be useful,
 
16
but WITHOUT ANY WARRANTY; without even the implied warranty of
 
17
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 
18
Lesser General Public License for more details.
 
19
 
 
20
You should have received a copy of the GNU Lesser General Public
 
21
License along with this library; if not, write to the Free Software
 
22
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 
23
 
 
24
-->
 
25
 
 
26
<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
 
27
 
 
28
<refentry>
 
29
 
 
30
  <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
 
31
 
 
32
  <refmeta>
 
33
    <refentrytitle>lxc-create</refentrytitle>
 
34
    <manvolnum>1</manvolnum>
 
35
  </refmeta>
 
36
 
 
37
  <refnamediv>
 
38
    <refname>lxc-create</refname>
 
39
 
 
40
    <refpurpose>
 
41
      creates a container
 
42
    </refpurpose>
 
43
  </refnamediv>
 
44
 
 
45
  <refsynopsisdiv>
 
46
    <cmdsynopsis>
 
47
      <command>lxc-create <replaceable>-n name</replaceable>
 
48
       <optional>-f config_file</optional></command>
 
49
    </cmdsynopsis>
 
50
  </refsynopsisdiv>
 
51
 
 
52
  <refsect1>
 
53
    <title>Description</title>
 
54
 
 
55
    <para>
 
56
      <command>lxc-create</command> creates a system object where is
 
57
      stored the configuration informations and where will be stored
 
58
      runtime information. The
 
59
      identifier <replaceable>name</replaceable> is used to
 
60
      specify the container to be used with the different lxc
 
61
      commands.
 
62
    </para>
 
63
 
 
64
    <para>
 
65
      This object is the definition of the different resources an
 
66
      application can use or can see. The more the configuration file
 
67
      contains informations, the more the container is isolated and
 
68
      the more the application is jailed.
 
69
    </para>
 
70
 
 
71
    <para>
 
72
      If the configuration file <replaceable>config_file</replaceable>
 
73
      is not specified, the container will be created with the default
 
74
      isolation: processes, sysv ipc and mount points.
 
75
    </para>
 
76
  </refsect1>
 
77
 
 
78
  <refsect1>
 
79
    <title>Options</title>
 
80
    <variablelist>
 
81
 
 
82
      <varlistentry>
 
83
        <term>
 
84
          <option>-n <replaceable>name</replaceable></option>
 
85
        </term>
 
86
        <listitem>
 
87
          <para>
 
88
            Specify the container name to be created.
 
89
          </para>
 
90
        </listitem>
 
91
      </varlistentry>
 
92
 
 
93
      <varlistentry>
 
94
        <term>
 
95
          <option>-f <replaceable>config_file</replaceable></option>
 
96
        </term>
 
97
        <listitem>
 
98
          <para>
 
99
            Specify the configuration file to configure the virtualization
 
100
            and isolation functionalities for the container.
 
101
          </para>
 
102
        </listitem>
 
103
      </varlistentry>
 
104
 
 
105
    </variablelist>
 
106
 
 
107
  </refsect1>
 
108
 
 
109
  <refsect1>
 
110
    <title>Diagnostic</title>
 
111
 
 
112
    <variablelist>
 
113
 
 
114
      <varlistentry>
 
115
        <term>The container already exists</term>
 
116
        <listitem>
 
117
          <para>
 
118
            As the message mention it, you try to create a container
 
119
            but there is a container with the same name. You can use
 
120
            the <command>lxc-ls -l</command> command to list the
 
121
            available containers on the system.
 
122
          </para>
 
123
        </listitem>
 
124
      </varlistentry>    
 
125
 
 
126
    </variablelist>
 
127
 
 
128
  </refsect1>
 
129
 
 
130
  <refsect1>
 
131
    <title>See Also</title>
 
132
 
 
133
    <simpara>    
 
134
      <citerefentry>
 
135
        <refentrytitle><command>lxc-destroy</command></refentrytitle>
 
136
        <manvolnum>1</manvolnum>
 
137
      </citerefentry>,
 
138
 
 
139
      <citerefentry>
 
140
        <refentrytitle><command>lxc-execute</command></refentrytitle>
 
141
        <manvolnum>1</manvolnum>
 
142
      </citerefentry>,
 
143
 
 
144
      <citerefentry>
 
145
        <refentrytitle><command>lxc.conf</command></refentrytitle>
 
146
        <manvolnum>5</manvolnum>
 
147
      </citerefentry>
 
148
    </simpara>
 
149
 
 
150
 
 
151
  </refsect1>
 
152
 
 
153
  <refsect1>
 
154
    <title>Author</title>
 
155
    <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
 
156
  </refsect1>
 
157
 
 
158
</refentry>
 
159
 
 
160
<!-- Keep this comment at the end of the file
 
161
Local variables:
 
162
mode: sgml
 
163
sgml-omittag:t
 
164
sgml-shorttag:t
 
165
sgml-minimize-attributes:nil
 
166
sgml-always-quote-attributes:t
 
167
sgml-indent-step:2
 
168
sgml-indent-data:t
 
169
sgml-parent-document:nil
 
170
sgml-default-dtd-file:nil
 
171
sgml-exposed-tags:nil
 
172
sgml-local-catalogs:nil
 
173
sgml-local-ecat-files:nil
 
174
End:
 
175
-->