← Back to branch summary

~serge-hallyn/ubuntu/natty/lxc/fix-restart

« back to all changes in this revision

Viewing changes to doc/lxc-create.1

  • Committer: Bazaar Package Importer
  • Author(s): Serge Hallyn
  • Date: 2011-01-23 17:28:55 UTC
  • mfrom: (1.1.7 upstream)
  • Revision ID: james.westby@ubuntu.com-20110123172855-1vpaxel9kwocx7qz
Tags: 0.7.3.1-0ubuntu1
* Base on new upstream git tree with new maverick and natty templates,
  and able to run without ns cgroup.
* Send a 'container=lxc' variable to upstart.  The upstream git has
  the same patch, though this tree has it as a quilt patch.
* Add lxcguest package which converts a system into one which can
  boot upstart both as a container and a (kvm or bare-metal) host.
* Add a MIRROR default in /etc/default/lxc, and use that in the
  debootstrap command in the lucid, maverick and natty templates.
* Remove 0004-restore-lxc.mount-lxc.mount.entry-functionality.patch
  which prevents containers from starting.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/lxc-create.1
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" "26 October 2010" "" ""
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, ubuntu 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>