← Back to branch summary

~ubuntu-branches/ubuntu/quantal/lxc/quantal-201206191543

« back to all changes in this revision

Viewing changes to doc/lxc-start.1

  • Committer: Bazaar Package Importer
  • Author(s): Guido Trotter
  • Date: 2010-06-28 10:15:48 UTC
  • mfrom: (1.2.4 upstream)
  • mto: (3.1.15 sid)
  • mto: This revision was merged to the branch mainline in revision 7.
  • Revision ID: james.westby@ubuntu.com-20100628101548-lmqvw55ypaxtbhhh
Tags: upstream-0.7.1
Import upstream version 0.7.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/lxc-start.1
3
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
4
4
.\" Please send any bug reports, improvements, comments, patches, 
5
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
 
.TH "LXC-START" "1" "22 January 2010" "" ""
 
6
.TH "LXC-START" "1" "24 June 2010" "" ""
7
7
 
8
8
.SH NAME
9
9
lxc-start \- run an application inside a container.
16
16
 
17
17
.SH "DESCRIPTION"
18
18
.PP
19
 
\fBlxc-start\fR runs the specified command inside
20
 
the container specified by name. It will setup the container
21
 
according the configuration previously defined with the
22
 
lxc-create command or with the configuration file parameter and
23
 
execute the command inside the container. If no configuration is
24
 
defined, the default isolation is used. The orphan process group
 
19
\fBlxc-start\fR runs the specified
 
20
\fIcommand\fR inside the container
 
21
specified by \fIname\fR\&.
 
22
.PP
 
23
It will setup the container
 
24
according to the configuration previously defined with the
 
25
lxc-create command or with the configuration file parameter.
 
26
If no configuration is
 
27
defined, the default isolation is used.
 
28
.PP
 
29
The orphan process group
25
30
and daemon are not supported by this command, use
26
31
the \fBlxc-execute\fR command instead.
 
32
.PP
27
33
If no command is specified, \fBlxc-start\fR will
28
34
use the default
29
35
\fB"/sbin/init"\fR command to run a system
35
41
more tty, if an error occurs nothing will be displayed,
36
42
the log file can be used to check the error.
37
43
.TP
38
 
\fB   -f \fIconfig_file\fB \fR
 
44
\fB   -f, --rcfile \fIconfig_file\fB \fR
39
45
Specify the configuration file to configure the virtualization
40
46
and isolation functionalities for the container.
 
47
 
 
48
This configuration file if present will be used even if there is
 
49
already a configuration file present in the previously created
 
50
container (via lxc-create).
41
51
.TP
42
 
\fB   -s \fIKEY=VAL\fB \fR
 
52
\fB   -s, --define \fIKEY=VAL\fB \fR
43
53
Assign value \fIVAL\fR to configuration
44
54
variable \fIKEY\fR\&. This overrides any
45
55
assignment done in \fIconfig_file\fR\&.
68
78
WARN, ERROR,
69
79
NOTICE, INFO,
70
80
DEBUG\&.
 
81
 
 
82
Note that this option is setting the priority of the events
 
83
log in the alternate log file. It do not have effect on the
 
84
ERROR events log on stderr.
71
85
.TP
72
86
\fB-n, --name=\fINAME\fB\fR
73
87
Use container identifier \fINAME\fR\&.
78
92
The specified container is already running an
79
93
application. You should stop it before reuse this
80
94
container or create a new one.
81
 
.TP
82
 
\fBThe container was not found\fR
83
 
The specified container was not created before with
84
 
the \fBlxc-create\fR
85
95
.SH "SEE ALSO"
86
96
.PP
87
97
\fBlxc\fR(1),
90
100
\fBlxc-start\fR(1),
91
101
\fBlxc-stop\fR(1),
92
102
\fBlxc-execute\fR(1),
 
103
\fBlxc-kill\fR(1),
93
104
\fBlxc-console\fR(1),
94
105
\fBlxc-monitor\fR(1),
95
106
\fBlxc-wait\fR(1),