Document the dependencies between scalable mode, first-stage translation, PASID, and SVM, including the iommufd requirement for PCI device assignment when FSTS is enabled. Add a NEWS entry summarizing the new Intel IOMMU configuration options.
Suggested-by: Peter Krempa <[email protected]> Signed-off-by: Zhenzhong Duan <[email protected]> --- NEWS.rst | 7 +++++++ docs/formatdomain.rst | 13 ++++++++++--- 2 files changed, 17 insertions(+), 3 deletions(-) diff --git a/NEWS.rst b/NEWS.rst index 802f89190a..f640b9e72e 100644 --- a/NEWS.rst +++ b/NEWS.rst @@ -33,6 +33,13 @@ v12.10.0 (unreleased) width reported to the guest. This allows the apparent bandwidth of a passed-through device to match the host hardware. + * qemu: support advanced Intel IOMMU configuration options + + The QEMU driver can now configure scalable mode, first-stage + translation, PASID width, and Shared Virtual Memory (SVM) for the Intel + IOMMU model. This is controlled via the new ``scalable_mode``, ``fsts``, + ``pasid_bits``, and ``svm`` attributes of the ``<driver>`` element. + * **Improvements** * **Bug fixes** diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 11a4efb8d8..d3edb40335 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -9547,18 +9547,25 @@ Examples: :since:`Since 12.10.0` (QEMU/KVM and ``intel`` model only) ``fsts`` - Enable first stage translation. + Enable first-stage translation. + Requires ``scalable_mode='on'``. When ``fsts='on'`` is used with PCI + host device assignment (VFIO), the assigned devices must be configured + to use the ``iommufd`` backend. The legacy VFIO container-based backend + is not supported. :since:`Since 12.10.0` (QEMU/KVM and ``intel`` model only) ``pasid_bits`` - The ``pasid_bits`` attribute can be used to set the pasid bit width. - Max supported value is 20 according to PCI spec, pasid is disabled if 0. + The ``pasid_bits`` attribute can be used to set the PASID bit width. + The maximum supported value is 20 according to the PCI specification. + A value of zero (or omitting the attribute) disables PASID support. + Enabling PASID support requires ``scalable_mode='on'``. :since:`Since 12.10.0` (QEMU/KVM and ``intel`` model only) ``svm`` Enable shared virtual memory. It exposes the necessary hardware capabilities to the guest operating system so that devices can share the exact same virtual address space as user-space applications. + Requires ``iotlb='on'``, ``fsts='on'``, and a nonzero ``pasid_bits``. :since:`Since 12.10.0` (QEMU/KVM and ``intel`` model only) In case of ``virtio`` IOMMU device, the ``driver`` element can optionally -- 2.52.0
