1LXC-EXECUTE(1)                                                  LXC-EXECUTE(1)
2
3
4

NAME

6       lxc-execute - run an application inside a container.
7

SYNOPSIS

9       lxc-execute -n name [-f config_file] [-s KEY=VAL ] command
10

DESCRIPTION

12       lxc-execute  runs  the specified command inside the container specified
13       by name.
14
15       It will setup the container according to the  configuration  previously
16       defined  with  the  lxc-create  command  or with the configuration file
17       parameter.  If no configuration is defined, the  default  isolation  is
18       used.
19
20       This command is mainly used when you want to quickly launch an applica‐
21       tion in an isolated environment.
22
23       lxc-execute command will run the specified command into  the  container
24       via  an  intermediate process, lxc-init.  This lxc-init after launching
25       the specified command, will wait for its end and all  other  reparented
26       processes.   (that  allows  to  support  daemons in the container).  In
27       other words, in the container, lxc-init has the pid  1  and  the  first
28       process of the application has the pid 2.
29
30       The  above  lxc-init  is  designed  to  forward received signals to the
31       started command.  So lxc-kill (1) sent signal is received by  the  user
32       specified command (pid 2 in the container).
33

OPTIONS

35       -f, --rcfile config_file
36              Specify  the  configuration file to configure the virtualization
37              and isolation functionalities for the container.
38
39              This configuration file if present will be used even if there is
40              already  a  configuration file present in the previously created
41              container (via lxc-create).
42
43       -s, --define KEY=VAL
44              Assign value VAL to configuration variable KEY.  This  overrides
45              any assignment done in config_file.
46

COMMON OPTIONS

48       These options are common to most of lxc commands.
49
50       -?, -h, --help
51              Print a longer usage message than normal.
52
53       --usage
54              Give the usage message
55
56       -q, --quiet
57              mute on
58
59       -o, --logfile=FILE
60              Output to an alternate log FILE. The default is no log.
61
62       -l, --logpriority=LEVEL
63              Set  log  priority  to LEVEL. The default log priority is ERROR.
64              Possible values are : FATAL, CRIT, WARN,  ERROR,  NOTICE,  INFO,
65              DEBUG.
66
67              Note  that this option is setting the priority of the events log
68              in the alternate log file. It do not have effect  on  the  ERROR
69              events log on stderr.
70
71       -n, --name=NAME
72              Use  container identifier NAME.  The container identifier format
73              is an alphanumeric string.
74

DIAGNOSTIC

76       The container is busy
77              The specified container is already running an  application.  You
78              should stop it before reuse this container or create a new one.
79

SEE ALSO

81       lxc(1),  lxc-create(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-
82       execute(1), lxc-kill(1), lxc-console(1),  lxc-monitor(1),  lxc-wait(1),
83       lxc-cgroup(1),  lxc-ls(1),  lxc-ps(1), lxc-info(1), lxc-freeze(1), lxc-
84       unfreeze(1), lxc.conf(5)
85

AUTHOR

87       Daniel Lezcano <daniel.lezcano@free.fr>
88
89
90
91                         Mon Jul 26 17:09:32 UTC 2010           LXC-EXECUTE(1)