diff --git a/doc/lxc-execute.sgml.in b/doc/lxc-execute.sgml.in index 46d0d1a5e..fe51b9bf3 100644 --- a/doc/lxc-execute.sgml.in +++ b/doc/lxc-execute.sgml.in @@ -60,20 +60,32 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Description - lxc-execute runs - the command inside the container - specified by name. This command - should be used to launch an application, eg. sshd or bash. + 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. It will create an - intermediate process allowing you application to daemonize in - the pid namespace and will mount the proc filesystem to complete - the pid isolation. + 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. + (that allows 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. + @@ -82,18 +94,23 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - + 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). + - + diff --git a/doc/lxc-start.sgml.in b/doc/lxc-start.sgml.in index 5bb34cdb3..24e467afe 100644 --- a/doc/lxc-start.sgml.in +++ b/doc/lxc-start.sgml.in @@ -57,20 +57,27 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Description - lxc-start runs the specified command inside - the container specified by name. It will setup the container - according the configuration previously defined with the - lxc-create command or with the configuration file parameter and - execute the command inside the container. If no configuration is - defined, the default isolation is used. The orphan process group + lxc-start 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. + + + The orphan process group and daemon are not supported by this command, use the lxc-execute command instead. - + + If no command is specified, lxc-start will use the default "/sbin/init" command to run a system container. - @@ -96,7 +103,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - + @@ -108,7 +115,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - + @@ -141,16 +148,6 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - - The container was not found - - - The specified container was not created before with - the lxc-create - - - -