Xen devel - Apr 2008 - [Patch] [docs]: Fix HVM user documentation

Hi,

while browsing through user.pdf I realized that the section dealing with 
hardware virtualized machines is totally outdated (referring to VMX 
instead of HVM for instance). This patch changes this and also fixes 
other issues (like abandoned config file options).
Since due to line-breaking issues the diff is hard to read, here a 
summary of the changes:

- replaced VMX with HVM
- added AMD as a vendor of HVM capable processors
- removed LibVNCServer as a requirement for HVM builds
- fixed name of HVM example file
- changed default value of acpi, apic and pae options
- added hap option
- removed reference to cdrom option and integrated it into "disk"
- improved examples for disk option
- replaced vncviewer option with vncconsole
- removed obsolete ne2000 option
- replaced enable-audio with soundhw
- fixed dd usage for creating sparse files (count=0)
- remove acpi=0 hint for Windows guests
- removed reference to (obsolete?) -f option for xm create
- made shutdown advice less Linux centric
- removed comment about save/restore and migration not yet ready

Signed-off-by: Andre Przywara <andre.przywara@amd.com>

Please review and apply to 3.3-unstable as well as 3.2-testing.


Regards,
Andre.

-- 
Andre Przywara
AMD-Operating System Research Center (OSRC), Dresden, Germany
Tel: +49 351 277-84917
----to satisfy European Law for business letters:
AMD Saxony Limited Liability Company & Co. KG,
Wilschdorfer Landstr. 101, 01109 Dresden, Germany
Register Court Dresden: HRA 4896, General Partner authorized
to represent: AMD Saxony LLC (Wilmington, Delaware, US)
General Manager of AMD Saxony LLC: Dr. Hans-R. Deppe, Thomas McCoy


_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel

Hi there,

Thanks for doing this.  Any attention to the user manual is appreciated, since 
it''s got somewhat out of date since it was originally created!
> For example, to create a 2GB sparse file-backed virtual block device
>-(actually only consumes 1KB of disk):
>+(actually only consumes no disk space at all):
s/only consumes/ consumes/

I guess strictly it doesn''t consume *no* disk space but it''s
near enough none!
>+kernel &        The HVM firmware loader, {\small 
>{\tt /usr/lib/xen/boot/hvmloader}}\\
I seem to remember Daniel Berrange making a patch to enable direct kernel boot 
(without a bootloader) which changed this option''s meaning, added a
similar
option, or something like that.  I don''t know if it''s in
mainline yet.  It''s
probably not that important for the user manual at this stage (not as 
important as getting the manual more up to date!), just thought I''d
mention
it.
>+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 HVM 
>guest''s disk, each disk entry is of the form 
> 
> {\small {\tt phy:UNAME,ioemu:DEV,MODE,}}
 
I don''t *think* you need to put ioemu in there anymore since, for an
HVM
guest, I believe Xen creates both PV and emulated versions of a disk device 
simultaneously these days.
>-in the VMX guest''s console first to prevent data loss. Then
execute the
>command 
>+in the HVM guest''s console, for Windows use Start -> Shutdown
first to
>prevent
>+data loss. Depending on the configuration the guest will be automatically
>+destroyed, otherwise execute the command 
Perhaps we should s/will/may/ here?
 
>+{\bfseries Ctrl+Alt+2} switches from guest VGA window to the control
window.
>Typing {\small {\tt help }} shows the control commands help. For example,
''q''
>is the command to destroy the HVM guest.\\ 
I think this is disabled for security on some distributions.  Again, may not 
matter, but worth noting.
> Signed-off-by: Andre Przywara <andre.przywara@amd.com>
>
> Please review and apply to 3.3-unstable as well as 3.2-testing.
Sorry to make so many nitpicks :-)  Your changes are good and can quite 
happily go in as-is.  If you fancy refining them any more or cooking up a 
follow-up patch, then I hope these comments are useful to you.

Cheers,
Mark

-- 
Push Me Pull You - Distributed SCM tool (http://www.cl.cam.ac.uk/~maw48/pmpu/)

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xensource.com
http://lists.xensource.com/xen-devel