Scroll to navigation

lxc-execute(1) lxc-execute(1)

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

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

Assign value VAL to configuration variable KEY. This overrides any assignment done in config_file.
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.
Executes the command with user ID uid inside the container.
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.
Give the usage message
mute on
Use an alternate container path. The default is /var/lib/lxc.
Output to an alternate log FILE. The default is no log.
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.

Use container identifier NAME. The container identifier format is an alphanumeric string.
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).

Show the version number.

DIAGNOSTIC

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>

2022-08-01