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" "02 March 2012" "" ""
9
lxc-execute \- run an application inside a container.
12
\fBlxc-execute \fI-n name\fB
13
[-f config_file] [-s KEY=VAL
20
\fBlxc-execute\fR runs the specified
21
\fIcommand\fR inside the container
22
specified by \fIname\fR\&.
24
It will setup the container
25
according to the configuration previously defined with the
26
lxc-create command or with the configuration file parameter.
27
If no configuration is
28
defined, the default isolation is used.
30
This command is mainly used when you want to quickly launch an
31
application in an isolated environment.
33
\fBlxc-execute\fR command will run the
34
specified command into the container via an intermediate
35
process, \fBlxc-init\fR\&.
36
This lxc-init after launching the specified command,
37
will wait for its end and all other reparented processes.
38
(that allows to support daemons in the container).
39
In other words, in the
40
container, \fBlxc-init\fR has the pid 1 and the
41
first process of the application has the pid 2.
43
The above \fBlxc-init\fR is designed to forward received
44
signals to the started command.
45
So \fBlxc-kill\fR (1) sent signal is received
46
by the user specified command (pid 2 in the container).
49
\fB -f, --rcfile \fIconfig_file\fB \fR
50
Specify the configuration file to configure the virtualization
51
and isolation functionalities for the container.
53
This configuration file if present will be used even if there is
54
already a configuration file present in the previously created
55
container (via lxc-create).
57
\fB -s, --define \fIKEY=VAL\fB \fR
58
Assign value \fIVAL\fR to configuration
59
variable \fIKEY\fR\&. This overrides any
60
assignment done in \fIconfig_file\fR\&.
63
Signal the end of options and disables further option
64
processing. Any arguments after the -- are treated as
67
This option is useful when you want to execute, with the
68
command \fBlxc-execute\fR, a command line
72
These options are common to most of lxc commands.
75
Print a longer usage message than normal.
78
Give the usage message
83
\fB-o, --logfile=\fIFILE\fB\fR
84
Output to an alternate log
85
\fIFILE\fR\&. The default is no log.
87
\fB-l, --logpriority=\fILEVEL\fB\fR
89
\fILEVEL\fR\&. The default log
90
priority is ERROR\&. Possible values are :
96
Note that this option is setting the priority of the events
97
log in the alternate log file. It do not have effect on the
98
ERROR events log on stderr.
100
\fB-n, --name=\fINAME\fB\fR
101
Use container identifier \fINAME\fR\&.
102
The container identifier format is an alphanumeric string.
105
\fBThe container is busy\fR
106
The specified container is already running an
107
application. You should stop it before reuse this
108
container or create a new one.
113
\fBlxc-destroy\fR(1),
116
\fBlxc-execute\fR(1),
118
\fBlxc-console\fR(1),
119
\fBlxc-monitor\fR(1),
126
\fBlxc-unfreeze\fR(1),
131
Daniel Lezcano <daniel.lezcano@free.fr>
added
removed
doc/lxc-execute.1
