Update the documentation to match current QEMU.
Remove the mention of pre-2.7 machine models as those aren't provided
anymore.
Signed-off-by: Mohamed Mediouni <mohamed@unpredictable.fr>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
---
docs/system/arm/virt.rst | 24 +++++++++++++++++++-----
1 file changed, 19 insertions(+), 5 deletions(-)
diff --git a/docs/system/arm/virt.rst b/docs/system/arm/virt.rst
index e5570773ba..f8148b5dcf 100644
--- a/docs/system/arm/virt.rst
+++ b/docs/system/arm/virt.rst
@@ -41,9 +41,10 @@ The virt board supports:
- User-creatable SMMUv3 devices (see below for example)
- hotpluggable DIMMs
- hotpluggable NVDIMMs
-- An MSI controller (GICv2M or ITS). GICv2M is selected by default along
- with GICv2. ITS is selected by default with GICv3 (>= virt-2.7). Note
- that ITS is not modeled in TCG mode.
+- An MSI controller (GICv2m or ITS).
+ - When using GICv3, ITS is selected by default when available on the platform.
+ - If using GICv2, a GICv2m is provided by default instead.
+ - When ITS is not available on a GICv3 platform, a GICv2m is provided by default.
- 32 virtio-mmio transport devices
- running guests using the KVM accelerator on aarch64 hardware
- large amounts of RAM (at least 255GB, and more if using highmem)
@@ -167,9 +168,22 @@ gic-version
with TCG this is currently ``3`` if ``virtualization`` is ``off`` and
``4`` if ``virtualization`` is ``on``, but this may change in future)
+msi
+ Specify the MSI and MSI-X controller (GIC) to provide.
+ Valid values are:
+
+ ``auto``
+ Use the best available MSI-X controller option. ITS when supported, GICv2m otherwise.
+ ``gicv2m``
+ GICv2m. Typically used with a GICv2. Also available with a newer GIC.
+ ``its``
+ GICv3 ITS. This is the default option when using a GICv3 or GICv4 with a supported
+ accelerator.
+ ``off``
+ Disable support for MSI/MSI-X interrupts.
+
its
- Set ``on``/``off`` to enable/disable ITS instantiation. The default is ``on``
- for machine types later than ``virt-2.7``.
+ Set ``on``/``off`` to control ITS instantiation. This is a deprecated option, use ``msi`` instead.
iommu
Set the IOMMU type to create for the guest. Valid values are:
--
2.50.1 (Apple Git-155)