aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel P. Berrange <berrange@redhat.com>2011-10-03 18:37:47 +0100
committerDaniel P. Berrange <berrange@redhat.com>2011-10-04 14:15:09 +0100
commit652f88714454767a9c93bbb71740b897df8a795e (patch)
treed3d5a41385f69911be361341bc9abf6e47a3874a /docs/drvlxc.html.in
parentAdd support for bandwidth filtering on LXC guests (diff)
downloadlibvirt-652f88714454767a9c93bbb71740b897df8a795e.tar.gz
libvirt-652f88714454767a9c93bbb71740b897df8a795e.tar.bz2
libvirt-652f88714454767a9c93bbb71740b897df8a795e.zip
Allow passing of command line args to LXC container
When booting a virtual machine with a kernel/initrd it is possible to pass command line arguments using the <cmdline>...args...</cmdline> element in the guest XML. These appear to the kernel / init process in /proc/cmdline. When booting a container we do not have a custom /proc/cmdline, but we can easily set an environment variable for it. Ideally we could pass individual arguments to the init process as a regular set of 'char *argv[]' parameters, but that would involve libvirt parsing the <cmdline> XML text. This can easily be added later, even if we add the env variable now * docs/drvlxc.html.in: Document env variables passed to LXC * src/conf/domain_conf.c: Add <cmdline> to be parsed for guests of type='exe' * src/lxc/lxc_container.c: Set LIBVIRT_LXC_CMDLINE env var
Diffstat (limited to 'docs/drvlxc.html.in')
-rw-r--r--docs/drvlxc.html.in17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/drvlxc.html.in b/docs/drvlxc.html.in
index 5ce218d92..47837d1a8 100644
--- a/docs/drvlxc.html.in
+++ b/docs/drvlxc.html.in
@@ -39,6 +39,23 @@ driver. On such kernels, it may be neccessary to unmount the blkio controller.
</p>
+<h2>Environment setup for the container init</h2>
+
+<p>
+When the container "init" process is started, it will be given several useful
+environment variables.
+</p>
+
+<dl>
+<dt>LIBVIRT_LXC_NAME</dt>
+<dd>The name assigned to the container by libvirt</dd>
+<dt>LIBVIRT_LXC_UUID</dt>
+<dd>The UUID assigned to the container by libvirt</dd>
+<dt>LIBVIRT_LXC_CMDLINE</dt>
+<dd>The unparsed command line arguments specified in the container configuration</dd>
+</dl>
+
+
<h3>Example config version 1</h3>
<p></p>
<pre>