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