.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-execute 1 2024-09-16 "" ""
.SH NAME
lxc-execute \- run an application inside a container. 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-execute\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} [-d] [-f \fIconfig_file\fR] [-s KEY=VAL] [-u, --uid \fIuid\fR] [-g, --gid \fIgid\fR] [-- \fIcommand\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBlxc-execute\fR runs the specified
\fIcommand\fR inside the container
specified by \fIname\fR.
.PP
It will setup the container
according to the configuration previously defined with the
lxc-create command or with the configuration file parameter.
If no configuration is
defined, the default isolation is used.
.PP
This command is mainly used when you want to quickly launch an
application in an isolated environment.
.PP
\fBlxc-execute\fR command will run the
specified command into the container via an intermediate
process, \fBlxc-init\fR.
This lxc-init after launching the specified command,
will wait for its end and all other reparented processes.
(to support daemons in the container).
In other words, in the
container, \fBlxc-init\fR has the pid 1 and the
first process of the application has the pid 2.
.PP
The above \fBlxc-init\fR is designed to forward received
signals to the started command.
.SH OPTIONS
.TP 
\*(T<\fB\-f, \-\-rcfile \fR\*(T>\fIconfig_file\fR 
Specify the configuration file to configure the virtualization
and isolation functionalities for the container.

This configuration file if present will be used even if there is
already a configuration file present in the previously created
container (via lxc-create).
.TP 
\*(T<\fB\-s, \-\-define \fR\*(T>\fIKEY=VAL\fR 
Assign value \fIVAL\fR to configuration
variable \fIKEY\fR. This overrides any
assignment done in \fIconfig_file\fR.
.TP 
\*(T<\fB\-d, \-\-daemon\fR\*(T> 
Run the container as a daemon. As the container has no
more tty, if an error occurs nothing will be displayed,
the log file can be used to check the error.
.TP 
\*(T<\fB\-u, \-\-uid \fR\*(T>\fIuid\fR 
Executes the \fIcommand\fR with user ID (use numerical value)
\fIuid\fR inside the container.
.TP 
\*(T<\fB\-\-g, \-\-gid \fR\*(T>\fIgid\fR 
Executes the \fIcommand\fR with group ID (use numerical value)
\fIgid\fR inside the container.
.TP 
\*(T<\fB\-\-\fR\*(T>
Signal the end of options and disables further option
processing. Any arguments after the -- are treated as
arguments to \fIcommand\fR.

This option is useful when you want specify options
to \fIcommand\fR and don't want
\fBlxc-execute\fR to interpret them.
.SH "COMMON OPTIONS"
These options are common to most of lxc commands.
.TP 
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
Print a longer usage message than normal.
.TP 
\*(T<\fB\-\-usage\fR\*(T>
Give the usage message
.TP 
\*(T<\fB\-q, \-\-quiet\fR\*(T>
mute on
.TP 
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
Use an alternate container path. The default is /var/lib/lxc.
.TP 
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
Output to an alternate log
\fIFILE\fR. The default is no log.
.TP 
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
Set log priority to
\fILEVEL\fR. The default log
priority is \*(T<ERROR\*(T>. Possible values are :
\*(T<FATAL\*(T>, \*(T<ALERT\*(T>,
\*(T<CRIT\*(T>,
\*(T<WARN\*(T>, \*(T<ERROR\*(T>,
\*(T<NOTICE\*(T>, \*(T<INFO\*(T>,
\*(T<DEBUG\*(T>, \*(T<TRACE\*(T>.

Note that this option is setting the priority of the events
log in the alternate log file. It do not have effect on the
ERROR events log on stderr.
.TP 
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
Use container identifier \fINAME\fR.
The container identifier format is an alphanumeric string.
.TP 
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
Specify the configuration file to configure the virtualization
and isolation functionalities for the container.

This configuration file if present will be used even if there is
already a configuration file present in the previously created
container (via lxc-create).
.TP 
\*(T<\fB\-\-version\fR\*(T>
Show the version number.
.SH DIAGNOSTIC
.TP 
The container is busy
The specified container is already running an
application. You should stop it before reuse this
container or create a new one.
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)