[PATCH 1/3] qemu: Introduce scalable_mode and first_stage capabilities

18 Dec 2025

They indicate if qemu supports a virtual vtd with scalable mode and
first stage translation.

Signed-off-by: Zhenzhong Duan <zhenzhong.duan@intel.com>
---
 src/qemu/qemu_capabilities.c                               | 4 ++++
 src/qemu/qemu_capabilities.h                               | 2 ++
 tests/qemucapabilitiesdata/caps_10.0.0_x86_64+amdsev.xml   | 2 ++
 tests/qemucapabilitiesdata/caps_10.0.0_x86_64.xml          | 2 ++
 tests/qemucapabilitiesdata/caps_10.1.0_x86_64+inteltdx.xml | 2 ++
 tests/qemucapabilitiesdata/caps_10.1.0_x86_64.xml          | 2 ++
 tests/qemucapabilitiesdata/caps_10.2.0_x86_64.xml          | 2 ++
 tests/qemucapabilitiesdata/caps_6.2.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_7.0.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_7.1.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_7.2.0_x86_64+hvf.xml       | 1 +
 tests/qemucapabilitiesdata/caps_7.2.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_8.0.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_8.1.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_8.2.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_9.0.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_9.1.0_x86_64.xml           | 1 +
 tests/qemucapabilitiesdata/caps_9.2.0_x86_64+amdsev.xml    | 1 +
 tests/qemucapabilitiesdata/caps_9.2.0_x86_64.xml           | 1 +
 19 files changed, 28 insertions(+)

diff --git a/src/qemu/qemu_capabilities.c b/src/qemu/qemu_capabilities.c
index cee7a0f5ef..6fae4a6ba7 100644
--- a/src/qemu/qemu_capabilities.c
+++ b/src/qemu/qemu_capabilities.c
@@ -748,6 +748,8 @@ VIR_ENUM_IMPL(virQEMUCaps,
               "acpi-generic-initiator", /* QEMU_CAPS_ACPI_GENERIC_INITIATOR */
               "disk-timed-stats", /* QEMU_CAPS_DISK_TIMED_STATS */
               "query-accelerators", /* QEMU_CAPS_QUERY_ACCELERATORS */
+              "intel-iommu.x-scalable-mode", /* QEMU_CAPS_INTEL_IOMMU_SCALABLE_MODE */
+              "intel-iommu.x-flts", /* QEMU_CAPS_INTEL_IOMMU_FIRST_STAGE */
     );
 
 
@@ -1565,6 +1567,8 @@ static struct virQEMUCapsDevicePropsFlags virQEMUCapsDevicePropsIntelIOMMU[] = {
     { "device-iotlb", QEMU_CAPS_INTEL_IOMMU_DEVICE_IOTLB, NULL },
     { "aw-bits", QEMU_CAPS_INTEL_IOMMU_AW_BITS, NULL },
     { "dma-translation", QEMU_CAPS_INTEL_IOMMU_DMA_TRANSLATION, NULL },
+    { "x-scalable-mode", QEMU_CAPS_INTEL_IOMMU_SCALABLE_MODE, NULL },
+    { "x-flts", QEMU_CAPS_INTEL_IOMMU_FIRST_STAGE, NULL },
 };
 
 static struct virQEMUCapsDevicePropsFlags virQEMUCapsDevicePropsMCH[] = {
diff --git a/src/qemu/qemu_capabilities.h b/src/qemu/qemu_capabilities.h
index efbef2acef..0c94b1f11d 100644
--- a/src/qemu/qemu_capabilities.h
+++ b/src/qemu/qemu_capabilities.h
@@ -729,6 +729,8 @@ typedef enum { /* virQEMUCapsFlags grouping marker for syntax-check */
     QEMU_CAPS_ACPI_GENERIC_INITIATOR, /* -object acpi-generic-initiator */
     QEMU_CAPS_DISK_TIMED_STATS, /* timed stats support ('stats-intervals' property of disk frontends) */
     QEMU_CAPS_QUERY_ACCELERATORS, /* query-accelerators command */
+    QEMU_CAPS_INTEL_IOMMU_SCALABLE_MODE, /* intel-iommu.x-scalable-mode */
+    QEMU_CAPS_INTEL_IOMMU_FIRST_STAGE, /* intel-iommu.x-flts */
 
     QEMU_CAPS_LAST /* this must always be the last item */
 } virQEMUCapsFlags;
diff --git a/tests/qemucapabilitiesdata/caps_10.0.0_x86_64+amdsev.xml b/tests/qemucapabilitiesdata/caps_10.0.0_x86_64+amdsev.xml
index cfce1c963d..692fb12a81 100644
--- a/tests/qemucapabilitiesdata/caps_10.0.0_x86_64+amdsev.xml
+++ b/tests/qemucapabilitiesdata/caps_10.0.0_x86_64+amdsev.xml
@@ -209,6 +209,8 @@
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
+  <flag name='intel-iommu.x-flts'/>
   <version>10000000</version>
   <microcodeVersion>43100285</microcodeVersion>
   <package>v10.0.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_10.0.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_10.0.0_x86_64.xml
index f94c8388d6..f3c1672d68 100644
--- a/tests/qemucapabilitiesdata/caps_10.0.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_10.0.0_x86_64.xml
@@ -209,6 +209,8 @@
   <flag name='amd-iommu.pci-id'/>
   <flag name='usb-bot'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
+  <flag name='intel-iommu.x-flts'/>
   <version>10000000</version>
   <microcodeVersion>43100285</microcodeVersion>
   <package>v10.0.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_10.1.0_x86_64+inteltdx.xml b/tests/qemucapabilitiesdata/caps_10.1.0_x86_64+inteltdx.xml
index 8e989a139f..786e48798e 100644
--- a/tests/qemucapabilitiesdata/caps_10.1.0_x86_64+inteltdx.xml
+++ b/tests/qemucapabilitiesdata/caps_10.1.0_x86_64+inteltdx.xml
@@ -191,6 +191,8 @@
   <flag name='usb-bot'/>
   <flag name='tdx-guest'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
+  <flag name='intel-iommu.x-flts'/>
   <version>10000050</version>
   <microcodeVersion>43100286</microcodeVersion>
   <package>v10.0.0-1724-gf9a3def17b</package>
diff --git a/tests/qemucapabilitiesdata/caps_10.1.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_10.1.0_x86_64.xml
index 520a3d8ee8..cc94f37561 100644
--- a/tests/qemucapabilitiesdata/caps_10.1.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_10.1.0_x86_64.xml
@@ -214,6 +214,8 @@
   <flag name='tdx-guest'/>
   <flag name='qom-list-get'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
+  <flag name='intel-iommu.x-flts'/>
   <version>10001000</version>
   <microcodeVersion>43100286</microcodeVersion>
   <package>v10.1.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_10.2.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_10.2.0_x86_64.xml
index 371680778c..f2aee23224 100644
--- a/tests/qemucapabilitiesdata/caps_10.2.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_10.2.0_x86_64.xml
@@ -215,6 +215,8 @@
   <flag name='acpi-generic-initiator'/>
   <flag name='disk-timed-stats'/>
   <flag name='query-accelerators'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
+  <flag name='intel-iommu.x-flts'/>
   <version>10001050</version>
   <microcodeVersion>43100287</microcodeVersion>
   <package>v10.1.0-1969-g53b41bb789</package>
diff --git a/tests/qemucapabilitiesdata/caps_6.2.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_6.2.0_x86_64.xml
index 108e75bee8..8a920d485d 100644
--- a/tests/qemucapabilitiesdata/caps_6.2.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_6.2.0_x86_64.xml
@@ -175,6 +175,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>6002000</version>
   <microcodeVersion>43100244</microcodeVersion>
   <package>v6.2.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_7.0.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_7.0.0_x86_64.xml
index 1723e65499..992ba9d5e5 100644
--- a/tests/qemucapabilitiesdata/caps_7.0.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_7.0.0_x86_64.xml
@@ -183,6 +183,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>7000000</version>
   <microcodeVersion>43100243</microcodeVersion>
   <package>v7.0.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_7.1.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_7.1.0_x86_64.xml
index 4deaf4fd1c..42a19bec5f 100644
--- a/tests/qemucapabilitiesdata/caps_7.1.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_7.1.0_x86_64.xml
@@ -188,6 +188,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>7001000</version>
   <microcodeVersion>43100244</microcodeVersion>
   <package>v7.1.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_7.2.0_x86_64+hvf.xml b/tests/qemucapabilitiesdata/caps_7.2.0_x86_64+hvf.xml
index cbfc830f2c..1373fca4cf 100644
--- a/tests/qemucapabilitiesdata/caps_7.2.0_x86_64+hvf.xml
+++ b/tests/qemucapabilitiesdata/caps_7.2.0_x86_64+hvf.xml
@@ -192,6 +192,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>7002000</version>
   <microcodeVersion>43100245</microcodeVersion>
   <package>v7.2.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_7.2.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_7.2.0_x86_64.xml
index 913f96e91a..1399dc45b7 100644
--- a/tests/qemucapabilitiesdata/caps_7.2.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_7.2.0_x86_64.xml
@@ -192,6 +192,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>7002000</version>
   <microcodeVersion>43100245</microcodeVersion>
   <package>v7.2.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_8.0.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_8.0.0_x86_64.xml
index 592df7049b..f328b0e24a 100644
--- a/tests/qemucapabilitiesdata/caps_8.0.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_8.0.0_x86_64.xml
@@ -196,6 +196,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>8000000</version>
   <microcodeVersion>43100244</microcodeVersion>
   <package>v8.0.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_8.1.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_8.1.0_x86_64.xml
index 9141faa7b9..eea93a76cc 100644
--- a/tests/qemucapabilitiesdata/caps_8.1.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_8.1.0_x86_64.xml
@@ -198,6 +198,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>8001000</version>
   <microcodeVersion>43100245</microcodeVersion>
   <package>v8.1.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_8.2.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_8.2.0_x86_64.xml
index 12aa9c23fd..28783a623e 100644
--- a/tests/qemucapabilitiesdata/caps_8.2.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_8.2.0_x86_64.xml
@@ -201,6 +201,7 @@
   <flag name='nvme-ns'/>
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>8002000</version>
   <microcodeVersion>43100246</microcodeVersion>
   <package>v8.2.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_9.0.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_9.0.0_x86_64.xml
index 1f2e27a218..c2c2353464 100644
--- a/tests/qemucapabilitiesdata/caps_9.0.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_9.0.0_x86_64.xml
@@ -204,6 +204,7 @@
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>9000000</version>
   <microcodeVersion>43100245</microcodeVersion>
   <package>v9.0.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_9.1.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_9.1.0_x86_64.xml
index 35ddf30736..f6a3b7ddf3 100644
--- a/tests/qemucapabilitiesdata/caps_9.1.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_9.1.0_x86_64.xml
@@ -203,6 +203,7 @@
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>9001000</version>
   <microcodeVersion>43100246</microcodeVersion>
   <package>v9.1.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_9.2.0_x86_64+amdsev.xml b/tests/qemucapabilitiesdata/caps_9.2.0_x86_64+amdsev.xml
index 0e52c3e23d..8f5ecc61a5 100644
--- a/tests/qemucapabilitiesdata/caps_9.2.0_x86_64+amdsev.xml
+++ b/tests/qemucapabilitiesdata/caps_9.2.0_x86_64+amdsev.xml
@@ -207,6 +207,7 @@
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>9002000</version>
   <microcodeVersion>43100247</microcodeVersion>
   <package>v9.2.0</package>
diff --git a/tests/qemucapabilitiesdata/caps_9.2.0_x86_64.xml b/tests/qemucapabilitiesdata/caps_9.2.0_x86_64.xml
index 95f8a4d878..c588199582 100644
--- a/tests/qemucapabilitiesdata/caps_9.2.0_x86_64.xml
+++ b/tests/qemucapabilitiesdata/caps_9.2.0_x86_64.xml
@@ -205,6 +205,7 @@
   <flag name='amd-iommu'/>
   <flag name='usb-bot'/>
   <flag name='acpi-generic-initiator'/>
+  <flag name='intel-iommu.x-scalable-mode'/>
   <version>9002000</version>
   <microcodeVersion>43100247</microcodeVersion>
   <package>v9.2.0</package>
-- 
2.47.3

    