qemu/docs/system/i386/xenpvh.rst
Edgar E. Iglesias 0b57c8160a docs/system/i386: xenpvh: Add a basic description
Signed-off-by: Edgar E. Iglesias <edgar.iglesias@amd.com>
Reviewed-by: Stefano Stabellini <sstabellini@kernel.org>
2024-09-04 16:50:43 +02:00

50 lines
2.1 KiB
ReStructuredText

Xen PVH machine (``xenpvh``)
=========================================
Xen supports a spectrum of types of guests that vary in how they depend
on HW virtualization features, emulation models and paravirtualization.
PVH is a mode that uses HW virtualization features (like HVM) but tries
to avoid emulation models and instead use passthrough or
paravirtualized devices.
QEMU can be used to provide PV virtio devices on an emulated PCIe controller.
That is the purpose of this minimal machine.
Supported devices
-----------------
The x86 Xen PVH QEMU machine provide the following devices:
- RAM
- GPEX host bridge
- virtio-pci devices
The idea is to only connect virtio-pci devices but in theory any compatible
PCI device model will work depending on Xen and guest support.
Running
-------
The Xen tools will typically construct a command-line and launch QEMU
for you when needed. But here's an example of what it can look like in
case you need to construct one manually:
.. code-block:: console
qemu-system-i386 -xen-domid 3 -no-shutdown \
-chardev socket,id=libxl-cmd,path=/var/run/xen/qmp-libxl-3,server=on,wait=off \
-mon chardev=libxl-cmd,mode=control \
-chardev socket,id=libxenstat-cmd,path=/var/run/xen/qmp-libxenstat-3,server=on,wait=off \
-mon chardev=libxenstat-cmd,mode=control \
-nodefaults \
-no-user-config \
-xen-attach -name g0 \
-vnc none \
-display none \
-device virtio-net-pci,id=nic0,netdev=net0,mac=00:16:3e:5c:81:78 \
-netdev type=tap,id=net0,ifname=vif3.0-emu,br=xenbr0,script=no,downscript=no \
-smp 4,maxcpus=4 \
-nographic \
-machine xenpvh,ram-low-base=0,ram-low-size=2147483648,ram-high-base=4294967296,ram-high-size=2147483648,pci-ecam-base=824633720832,pci-ecam-size=268435456,pci-mmio-base=4026531840,pci-mmio-size=33554432,pci-mmio-high-base=824902156288,pci-mmio-high-size=68719476736 \
-m 4096