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-EXECUTE" "1" "20 May 2011" "" ""
9
lxc-execute \- run an application inside a container.
12
\fBlxc-execute \fI-n name\fB
13
[-f config_file] [-s KEY=VAL
19
\fBlxc-execute\fR runs the specified
20
\fIcommand\fR inside the container
21
specified by \fIname\fR\&.
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.
29
This command is mainly used when you want to quickly launch an
30
application in an isolated environment.
32
\fBlxc-execute\fR command will run the
33
specified command into the container via an intermediate
34
process, \fBlxc-init\fR\&.
35
This lxc-init after launching the specified command,
36
will wait for its end and all other reparented processes.
37
(that allows to support daemons in the container).
38
In other words, in the
39
container, \fBlxc-init\fR has the pid 1 and the
40
first process of the application has the pid 2.
42
The above \fBlxc-init\fR is designed to forward received
43
signals to the started command.
44
So \fBlxc-kill\fR (1) sent signal is received
45
by the user specified command (pid 2 in the container).
48
\fB -f, --rcfile \fIconfig_file\fB \fR
49
Specify the configuration file to configure the virtualization
50
and isolation functionalities for the container.
52
This configuration file if present will be used even if there is
53
already a configuration file present in the previously created
54
container (via lxc-create).
56
\fB -s, --define \fIKEY=VAL\fB \fR
57
Assign value \fIVAL\fR to configuration
58
variable \fIKEY\fR\&. This overrides any
59
assignment done in \fIconfig_file\fR\&.
62
These options are common to most of lxc commands.
65
Print a longer usage message than normal.
68
Give the usage message
73
\fB-o, --logfile=\fIFILE\fB\fR
74
Output to an alternate log
75
\fIFILE\fR\&. The default is no log.
77
\fB-l, --logpriority=\fILEVEL\fB\fR
79
\fILEVEL\fR\&. The default log
80
priority is ERROR\&. Possible values are :
86
Note that this option is setting the priority of the events
87
log in the alternate log file. It do not have effect on the
88
ERROR events log on stderr.
90
\fB-n, --name=\fINAME\fB\fR
91
Use container identifier \fINAME\fR\&.
92
The container identifier format is an alphanumeric string.
95
\fBThe container is busy\fR
96
The specified container is already running an
97
application. You should stop it before reuse this
98
container or create a new one.
103
\fBlxc-destroy\fR(1),
106
\fBlxc-execute\fR(1),
108
\fBlxc-console\fR(1),
109
\fBlxc-monitor\fR(1),
116
\fBlxc-unfreeze\fR(1),
120
Daniel Lezcano <daniel.lezcano@free.fr>
added
removed
doc/lxc-execute.1
