~ubuntu-branches/ubuntu/oneiric/lxc/oneiric-201108112013

« back to all changes in this revision

Viewing changes to doc/lxc-create.1

  • Committer: Stéphane Graber
  • Date: 2011-08-11 18:43:59 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: stgraber@ubuntu.com-20110811184359-lkqgeuimw8n5efzj
Merge 0.7.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" This manpage has been automatically generated by docbook2man 
2
 
.\" from a DocBook document.  This tool can be found at:
3
 
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
4
 
.\" Please send any bug reports, improvements, comments, patches, 
5
 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
 
.TH "LXC-CREATE" "1" "20 May 2011" "" ""
7
 
 
8
 
.SH NAME
9
 
lxc-create \- creates a container
10
 
.SH SYNOPSIS
11
 
 
12
 
\fBlxc-create \fI-n name\fB
13
 
[-f config_file]
14
 
[-t template]\fR
15
 
 
16
 
.SH "DESCRIPTION"
17
 
.PP
18
 
\fBlxc-create\fR creates a system object where is
19
 
stored the configuration informations and where can be stored
20
 
user information. The identifier \fIname\fR
21
 
is used to specify the container to be used with the different
22
 
lxc commands.
23
 
.PP
24
 
The object is a directory created in \fI/var/lib/lxc\fR
25
 
and identified by its name.
26
 
.PP
27
 
The object is the definition of the different resources an
28
 
application can use or can see. The more the configuration file
29
 
contains informations, the more the container is isolated and
30
 
the more the application is jailed.
31
 
.PP
32
 
If the configuration file \fIconfig_file\fR
33
 
is not specified, the container will be created with the default
34
 
isolation: processes, sysv ipc and mount points.
35
 
.SH "OPTIONS"
36
 
.TP
37
 
\fB   -f \fIconfig_file\fB \fR
38
 
Specify the configuration file to configure the virtualization
39
 
and isolation functionalities for the container.
40
 
.TP
41
 
\fB   -t \fItemplate\fB \fR
42
 
\&'template' is the short name of an existing 'lxc-template'
43
 
script that is called by lxc-create,
44
 
eg. busybox, debian, fedora, lucid, maverick, natty or sshd.
45
 
Refer to the examples in \fI/usr/lib64/lxc/templates\fR
46
 
for details of the expected script structure.
47
 
.SH "DIAGNOSTIC"
48
 
.TP
49
 
\fBThe container already exists\fR
50
 
As the message mention it, you try to create a container
51
 
but there is a container with the same name. You can use
52
 
the \fBlxc-ls -l\fR command to list the
53
 
available containers on the system.
54
 
.SH "SEE ALSO"
55
 
.PP
56
 
\fBlxc\fR(1),
57
 
\fBlxc-create\fR(1),
58
 
\fBlxc-destroy\fR(1),
59
 
\fBlxc-start\fR(1),
60
 
\fBlxc-stop\fR(1),
61
 
\fBlxc-execute\fR(1),
62
 
\fBlxc-kill\fR(1),
63
 
\fBlxc-console\fR(1),
64
 
\fBlxc-monitor\fR(1),
65
 
\fBlxc-wait\fR(1),
66
 
\fBlxc-cgroup\fR(1),
67
 
\fBlxc-ls\fR(1),
68
 
\fBlxc-ps\fR(1),
69
 
\fBlxc-info\fR(1),
70
 
\fBlxc-freeze\fR(1),
71
 
\fBlxc-unfreeze\fR(1),
72
 
\fBlxc.conf\fR(5)
73
 
.SH "AUTHOR"
74
 
.PP
75
 
Daniel Lezcano <daniel.lezcano@free.fr>