diff --git a/ChangeLog b/ChangeLog index f715d50a88..579f109bfb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Wed Apr 15 21:59:09 CEST 2009 Daniel Veillard + + * drvlxc.html.in drvlxc.html: some examples from Serge Hallyn + Wed Apr 15 11:52:15 CEST 2009 Daniel Veillard * src/xm_internal.c: fix a crash on vcpupin to inactive Xen domains, diff --git a/docs/drvlxc.html b/docs/drvlxc.html index c804b35fbf..e76a1e7274 100644 --- a/docs/drvlxc.html +++ b/docs/drvlxc.html @@ -126,6 +126,81 @@

LXC container driver

+

+The libvirt LXC driver manages "Linux Containers". Containers are sets of processes +with private namespaces which can (but don't always) look like separate machines, but +do not have their own OS. Here are two example configurations. The first is a very +light-weight "application container" which does not have it's own root image. You would +start it using +

+

Example config version 1

+

+ 
+<domain type='lxc'>
+	<name>vm1</name>
+	<memory>500000</memory>
+	<os>
+		<type>exe</type>
+		<init>/bin/sh</init>
+	</os>
+	<vcpu>1</vcpu>
+	<clock offset='utc'/>
+	<on_poweroff>destroy</on_poweroff>
+	<on_reboot>restart</on_reboot>
+	<on_crash>destroy</on_crash>
+	<devices>
+		<emulator>/usr/libexec/libvirt_lxc</emulator>
+		<interface type='network'>
+			<source network='default'/>
+		</interface>
+		<console type='pty' />
+	</devices>
+</domain>
+
+

+The next example assumes there is a private root filesystem +(perhaps hand-crafted using busybox, or installed from media, +debootstrap, whatever) under /opt/vm-1-root: +

+

+ 
+<domain type='lxc'>
+	<name>vm1</name>
+	<memory>32768</memory>
+	<os>
+		<type>exe</type>
+		<init>/init</init>
+	</os>
+	<vcpu>1</vcpu>
+	<clock offset='utc'/>
+	<on_poweroff>destroy</on_poweroff>
+	<on_reboot>restart</on_reboot>
+	<on_crash>destroy</on_crash>
+	<devices>
+		<emulator>/usr/libexec/libvirt_lxc</emulator>
+		<filesystem type='mount'>
+			<source dir='/opt/vm-1-root'/>
+			<target dir='/'/>
+		</filesystem>
+		<interface type='network'>
+			<source network='default'/>
+		</interface>
+		<console type='pty' />
+	</devices>
+</domain>
+
+

+In both cases, you can define and start a container using:

+ 
+lxc --connect lxc:/// define v1.xml
+lxc --connect lxc:/// start v1.xml
+
+ 
+lxc --connect lxc:/// console v1
+
+

Now doing 'ps -ef' will only show processes in the container, for +instance. +