NAME

lxc-execute - run an application inside a container.

SYNOPSIS

lxc-execute
{-n name} [-d] [-f config_file] [-s KEY=VAL] [-u, --uid uid] [-g, --gid gid] [-- command]

DESCRIPTION

lxc-execute runs the specified command inside the container specified by name.

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.

This command is mainly used when you want to quickly launch an application in an isolated environment.

lxc-execute command will run the specified command into the container via an intermediate process, lxc-init. 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, lxc-init has the pid 1 and the first process of the application has the pid 2.

The above lxc-init is designed to forward received signals to the started command.

OPTIONS

-f, --rcfile config_file

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).

-s, --define KEY=VAL

Assign value VAL to configuration variable KEY. This overrides any assignment done in config_file.

-d, --daemon

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.

-u, --uid uid

Executes the command with user ID uid inside the container.

--g, --gid gid

Executes the command with group ID gid inside the container.

--

Signal the end of options and disables further option processing. Any arguments after the -- are treated as arguments to command.

This option is useful when you want specify options to command and don't want lxc-execute to interpret them.

COMMON OPTIONS

These options are common to most of lxc commands.

-?, -h, --help

Print a longer usage message than normal.

--usage

Give the usage message

-q, --quiet

mute on

-P, --lxcpath=PATH

Use an alternate container path. The default is /var/lib/lxc.

-o, --logfile=FILE

Output to an alternate log FILE. The default is no log.

-l, --logpriority=LEVEL

Set log priority to LEVEL. The default log priority is ERROR. Possible values are : FATAL, ALERT, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG, TRACE.

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.

-n, --name=NAME

Use container identifier NAME. The container identifier format is an alphanumeric string.

--rcfile=FILE

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).

--version

Show the version number.

DIAGNOSTIC

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.

SEE ALSO

lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-attach(1), lxc.conf(5)

AUTHOR

Daniel Lezcano <daniel.lezcano@free.fr>