ia64/xen-unstable

changeset 9603:2a127b1f13b5

Update the user manual appendix to describe bow to get a mouse working
properly in a VNC window. Also add 'pae' configuration introduction for
HVM guests.

Signed-off-by: You, Yongkang <yongkang.you@intel.com>
Signed-off-by: Dugger, Donald D <donald.d.dugger@intel.com>
author kaf24@firebug.cl.cam.ac.uk
date Thu Apr 06 09:36:54 2006 +0100 (2006-04-06)
parents ea12fbe91f39
children ebbe237bd9e4
files docs/src/user.tex
line diff
     1.1 --- a/docs/src/user.tex	Thu Apr 06 09:34:30 2006 +0100
     1.2 +++ b/docs/src/user.tex	Thu Apr 06 09:36:54 2006 +0100
     1.3 @@ -2052,7 +2052,7 @@ dev86 & The dev86 package provides an as
     1.4  
     1.5  If the dev86 package is not available on the x86\_64 distribution, you can install the i386 version of it. The dev86 rpm package for various distributions can be found at {\scriptsize {\tt http://www.rpmfind.net/linux/rpm2html/search.php?query=dev86\&submit=Search}} \\
     1.6  
     1.7 -LibVNCServer & The unmodified guest's VGA display, keyboard, and mouse are virtualized using the vncserver library provided by this package. You can get the sources of libvncserver from {\small {\tt http://sourceforge.net/projects/libvncserver}}. Build and install the sources on the build system to get the libvncserver library. The 0.8pre version of libvncserver is currently working well with Xen.\\
     1.8 +LibVNCServer & The unmodified guest's VGA display, keyboard, and mouse can be virtualized by the vncserver library. You can get the sources of libvncserver from {\small {\tt http://sourceforge.net/projects/libvncserver}}. Build and install the sources on the build system to get the libvncserver library. There is a significant performance degradation in 0.8 version. The current sources in the CVS tree have fixed this degradation. So it is highly recommended to download the latest CVS sources and install them.\\
     1.9  
    1.10  SDL-devel, SDL & Simple DirectMedia Layer (SDL) is another way of virtualizing the unmodified guest console. It provides an X window for the guest console. 
    1.11  
    1.12 @@ -2077,6 +2077,8 @@ acpi & Enable VMX guest ACPI, default=0 
    1.13  
    1.14  apic & Enable VMX guest APIC, default=0 (disabled)\\
    1.15  
    1.16 +pae & Enable VMX guest PAE, default=0 (disabled)\\
    1.17 +
    1.18  vif     & Optionally defines MAC address and/or bridge for the network interfaces. Random MACs are assigned if not given. {\small {\tt type=ioemu}} means ioemu is used to virtualize the VMX NIC. If no type is specified, vbd is used, as with paravirtualized guests.\\
    1.19  
    1.20  disk & Defines the disk devices you want the domain to have access to, and what you want them accessible as. If using a physical device as the VMX guest's disk, each disk entry is of the form 
    1.21 @@ -2229,6 +2231,30 @@ Simply follow the usual method of creati
    1.22  
    1.23  In the default configuration, VNC is on and SDL is off. Therefore VNC windows will open when VMX guests are created. If you want to use SDL to create VMX guests, set {\small {\tt sdl=1}} in your VMX configuration file. You can also turn off VNC by setting {\small {\tt vnc=0}}.
    1.24   
    1.25 +\subsection{Use mouse in VNC window}
    1.26 +The default PS/2 mouse will not work properly in VMX by a VNC window. Summagraphics mouse emulation does work in this environment. A Summagraphics mouse can be enabled by reconfiguring 2 services:
    1.27 +
    1.28 +{\small {\tt 1. General Purpose Mouse (GPM). The GPM daemon is configured in different ways in different Linux distributions. On a Redhat distribution, this is accomplished by changing the file `/etc/sysconfig/mouse' to have the following:\\
    1.29 +MOUSETYPE="summa"\\
    1.30 +XMOUSETYPE="SUMMA"\\
    1.31 +DEVICE=/dev/ttyS0\\
    1.32 +\\
    1.33 +2. X11. For all Linux distributions, change the Mouse0 stanza in `/etc/X11/xorg.conf' to:\\
    1.34 +Section "InputDevice"\\
    1.35 +Identifier "Mouse0"\\
    1.36 +Driver "summa"\\
    1.37 +Option "Device" "/dev/ttyS0"\\
    1.38 +Option "InputFashion" "Tablet"\\
    1.39 +Option "Mode" "Absolute"\\
    1.40 +Option "Name" "EasyPen"\\
    1.41 +Option "Compatible" "True"\\
    1.42 +Option "Protocol" "Auto"\\
    1.43 +Option "SendCoreEvents" "on"\\
    1.44 +Option "Vendor" "GENIUS"\\
    1.45 +EndSection}}
    1.46 +
    1.47 +If the Summagraphics mouse isn't the default mouse, you can manually kill 'gpm' and restart it with the command "gpm -m /dev/ttyS0 -t summa". Note that Summagraphics mouse makes no sense in an SDL window and is therefore not available in this environment.
    1.48 +
    1.49  \subsection{Destroy VMX guests}
    1.50  VMX guests can be destroyed in the same way as can paravirtualized guests. We recommend that you type the command 
    1.51