[PATCH] stubdom documentation update

[PATCH] stubdom documentation update

[Stefano Stabellini]

Update the stubdom documentation to reflect the new way of
configuring stubdom based domains.

Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> 

---

diff -r 2656ab6fa828 stubdom/README
--- a/stubdom/README	Fri May 08 11:50:12 2009 +0100
+++ b/stubdom/README	Mon May 11 12:23:58 2009 +0100
@@ -11,68 +11,12 @@
 by using the hypervisor dom0_mem= option for instance.
 
 
-There is a sample configuration set in xmexample.hvm-stubdom and
-xmexample.hvm-dm
+There is a sample configuration set in xmexample.hvm-stubdom
 
-In your HVM config "hvmconfig",
-
-- use /usr/lib/xen/bin/stubdom-dm as dm script:
+In your HVM config "hvmconfig" use /usr/lib/xen/bin/stubdom-dm as dm script:
 
 device_model = '/usr/lib/xen/bin/stubdom-dm'
 
-- comment the disk statement:
-
-#disk = [  'file:/tmp/install.iso,hdc:cdrom,r', 'phy:/dev/sda6,hda,w', 'file:/tmp/test,hdb,r' ]
-
-- disable anything related to dom0, like pty serial assignments
-
-
-Create /etc/xen/hvmconfig-dm (where "hvmconfig" is the name of your HVM
-guest) with
-
-kernel = "/usr/lib/xen/boot/ioemu-stubdom.gz"
-vif = ['ip=10.0.1.1,mac=aa:00:00:12:23:34']
-disk = [  'file:/tmp/install.iso,hdc:cdrom,r', 'phy:/dev/sda6,hda,w', 'file:/tmp/test,hdb,r' ]
-
-where
-- 'ip=10.0.1.1,mac= etc...' is the same net configuration as in the hvmconfig
-script,
-- and disk = is the same block configuration as in the hvmconfig script.
-
-Display Configuration
-=====================
-
-There are two possibilities
-
-* Using SDL
-
-  - In hvmconfig, disable vnc and sdl:
-
-vnc = 0
-sdl = 0
-
-  - In hvmconfig-dm, set an sdl vfb:
-
-vfb = [ 'type=sdl' ]
-
-    by default qemu will use sdl together with opengl for rendering, if
-    you do not want qemu to use opengl then also pass opengl=0:
-
-vfb = [ 'type=sdl, opengl=0' ]
-
-
-* Using a VNC server in dom0
-
-  - In hvmconfig, disable vnc and sdl:
-
-vnc = 0
-sdl = 0
-
-  - In hvmconfig-dm, set a vnc vfb:
-
-vfb = [ 'type=vnc' ]
-
-and any other parameter as wished.
 
 To run
 ======
diff -r 2656ab6fa828 tools/examples/Makefile
--- a/tools/examples/Makefile	Fri May 08 11:50:12 2009 +0100
+++ b/tools/examples/Makefile	Mon May 11 12:23:58 2009 +0100
@@ -17,7 +17,6 @@
 XEN_CONFIGS += xmexample3
 XEN_CONFIGS += xmexample.hvm
 XEN_CONFIGS += xmexample.hvm-stubdom
-XEN_CONFIGS += xmexample.hvm-dm
 XEN_CONFIGS += xmexample.pv-grub
 XEN_CONFIGS += xmexample.nbd
 XEN_CONFIGS += xmexample.vti
diff -r 2656ab6fa828 tools/examples/xmexample.hvm-dm
--- a/tools/examples/xmexample.hvm-dm	Fri May 08 11:50:12 2009 +0100
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,14 +0,0 @@
-# Not to be started directly,
-# See xmexample.hvm-stubdom and stubdom/README for more details
-
-kernel = "/usr/lib/xen/boot/ioemu-stubdom.gz"
-
-# Must be the same as in xmexample.hvm-stubdom, with a prepended vif for TCP/IP
-# networking in the stubdomain itself, here just ''
-vif = [ '', 'type=ioemu, bridge=xenbr0' ]
-
-# Set here instead of in xmexample.hvm-stubdom
-disk = [ 'file:/var/images/min-el3-i386.img,hda,w', ',hdc:cdrom,r' ]
-
-# Actual output via PVFB
-vfb = [ 'sdl=1' ]
diff -r 2656ab6fa828 tools/examples/xmexample.hvm-stubdom
--- a/tools/examples/xmexample.hvm-stubdom	Fri May 08 11:50:12 2009 +0100
+++ b/tools/examples/xmexample.hvm-stubdom	Mon May 11 12:23:58 2009 +0100
@@ -6,8 +6,7 @@
 # you can set the parameters for the domain on the xm command line.
 #============================================================================
 #
-# This is a version using a stubdomain for device model, see
-# xmexample.hvm-dm and README.stubdom for more details
+# This is a version using a stubdomain for device model
 # The differences with xmexample.hvm are marked with "STUBDOM"
 
 #----------------------------------------------------------------------------
@@ -68,11 +67,8 @@
 # Each disk entry is of the form phy:UNAME,DEV,MODE
 # where UNAME is the device, DEV is the device name the domain will see,
 # and MODE is r for read-only, w for read-write.
-#
-# STUBDOM: do not put it here but in stubdom-ExampleHVMDomain
 
-#disk = [ 'phy:hda1,hda1,r' ]
-#disk = [ 'file:/var/images/min-el3-i386.img,hda,w', ',hdc:cdrom,r' ]
+disk = [ 'file:/var/images/min-el3-i386.img,hda,w', 'phy:/dev/cdrom,hdc:cdrom,r' ]
 
 #----------------------------------------------------------------------------
 # Configure the behaviour when a domain exits.  There are three 'reasons'
@@ -127,7 +123,7 @@
 #-----------------------------------------------------------------------------
 # boot on floppy (a), hard disk (c), Network (n) or CD-ROM (d) 
 # default: hard disk, cd-rom, floppy
-#boot="cda"
+boot="cda"
 
 #-----------------------------------------------------------------------------
 #  write to temporary files instead of disk image files
@@ -136,19 +132,17 @@
 #----------------------------------------------------------------------------
 # enable SDL library for graphics, default = 0
 # 
-# STUBDOM: always disable since the stub domain doesn't have direct X access
 sdl=0
 
 #----------------------------------------------------------------------------
 # enable OpenGL for texture rendering inside the SDL window, default = 1
 # valid only if sdl is enabled.
 # 
-# STUBDOM: always disable for the same reason
-opengl=0
+opengl=1
 
 #----------------------------------------------------------------------------
 # enable VNC library for graphics, default = 1
-vnc=0
+vnc=1
 
 #----------------------------------------------------------------------------
 # address that should be listened on for the VNC server if vnc is set.