system/i386/xen.rst

6 -----------
8 KVM has support for hosting Xen guests, intercepting Xen hypercalls and event
10 run under Xen to be hosted in QEMU under Linux/KVM instead.
15 -----
17 Xen mode is enabled by setting the ``xen-version`` property of the KVM
20 .. parsed-literal::
22   |qemu_system| --accel kvm,xen-version=0x40011,kernel-irqchip=split
25 ``xen-vapic`` CPU flag:
27 .. parsed-literal::
29   |qemu_system| --accel kvm,xen-version=0x40011,kernel-irqchip=split --cpu host,+xen-vapic
32 0x40000000..0x4000000A) to Xen. The KVM identification and features are not
33 advertised to a Xen guest. If Hyper-V is also enabled, the Xen identification
37 ----------
39 The following properties exist on the KVM accelerator object:
41 ``xen-version``
49 ``xen-evtchn-max-pirq``
53   compatibility with 32-bit MSI where the higher bits of the PIRQ# would need
55   of PCI devices (and none which are limited to 32-bit addressing) it may be
58 ``xen-gnttab-max-frames``
68 -----------------------
75 through the command line, and/or hot-plugged.
78 of type ``xen-console`` to connect to it. For the Xen console equivalent of
79 the handy ``-serial mon:stdio`` option, for example:
81 .. parsed-literal::
82    -chardev stdio,mux=on,id=char0,signal=off -mon char0 \\
83    -device xen-console,chardev=char0
85 The Xen network device is ``xen-net-device``, which becomes the default NIC
90 Disks can be configured with '``-drive file=${GUEST_IMAGE},if=xen``' and will
99 .. parsed-literal::
101   |qemu_system| --accel kvm,xen-version=0x40011,kernel-irqchip=split \\
102        -drive file=${GUEST_IMAGE},if=xen \\
103        -drive file=${GUEST_IMAGE},file.locking=off,if=ide
109 ---------------------
115 The Xen binary is provided as the ``-kernel`` and the guest kernel itself (or
116 PV Grub image) as the ``-initrd`` image, which actually just means the first
119 .. parsed-literal::
121   |qemu_system| --accel kvm,xen-version=0x40011,kernel-irqchip=split \\
122        -chardev stdio,id=char0 -device xen-console,chardev=char0 \\
123        -display none  -m 1G  -kernel xen -initrd bzImage \\
124        -append "pv-shim console=xen,pv -- console=hvc0 root=/dev/xvda1" \\
125        -drive file=${GUEST_IMAGE},if=xen
132 (" ``--`` ") on the Xen command line, and does not provide the guest kernel
135 :ref:`documentation <system/invocation-qemu-options-initrd>` for the
136 ``-initrd`` option.
139 --------------------
141 The minimal Xen support in the KVM accelerator requires the host to be running
144 accelerated Xen PV timers and inter-processor interrupts (IPIs).