docs: update Xen-on-KVM documentation

Add notes about console and network support, and how to launch PV guests.
Clean up the disk configuration examples now that that's simpler, and
remove the comment about IDE unplug on q35/AHCI now that it's fixed.

Update the -initrd option documentation to explain how to quote commas
in module command lines, and reference it when documenting PV guests.

Also update stale avocado test filename in MAINTAINERS.

Signed-off-by: David Woodhouse <dwmw@amazon.co.uk>
Reviewed-by: Paul Durrant <paul@xen.org>
This commit is contained in:
David Woodhouse 2023-10-19 15:30:23 +01:00
parent a73049953b
commit cc9d10b9e8
3 changed files with 90 additions and 31 deletions

View file

@ -3986,14 +3986,22 @@ ERST
DEF("initrd", HAS_ARG, QEMU_OPTION_initrd, \
"-initrd file use 'file' as initial ram disk\n", QEMU_ARCH_ALL)
SRST
``-initrd file``
Use file as initial ram disk.
``-initrd "file1 arg=foo,file2"``
This syntax is only available with multiboot.
Use file1 and file2 as modules and pass arg=foo as parameter to the
first module.
Use file1 and file2 as modules and pass ``arg=foo`` as parameter to the
first module. Commas can be provided in module parameters by doubling
them on the command line to escape them:
``-initrd "bzImage earlyprintk=xen,,keep root=/dev/xvda1,initrd.img"``
Multiboot only. Use bzImage as the first module with
"``earlyprintk=xen,keep root=/dev/xvda1``" as its command line,
and initrd.img as the second module.
ERST
DEF("dtb", HAS_ARG, QEMU_OPTION_dtb, \