Update the stubdom documentation to reflect the new way of
configuring stubdom based domains.
Signed-off-by: Stefano Stabellini <stefano.stabellini@xxxxxxxxxxxxx>
---
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.
_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel
|
Home