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

Reply via email to