On 21/08/2026 15:49, Mark Cave-Ayland wrote:
The version property used to specify the IOAPIC version was originally set to
0x11 when it was first introduced, but has been set to 0x20 since v2.8. Since
all machines before to v4.2 have now been removed, this parameter is no longer
required so mark it as deprecated pending future removal.
Signed-off-by: Mark Cave-Ayland <[email protected]>
---
docs/about/deprecated.rst | 10 ++++++++++
1 file changed, 10 insertions(+)
Following on from the discussion at
https://urldefense.proofpoint.com/v2/url?u=https-3A__lists.gnu.org_archive_html_qemu-2Ddevel_2025-2D05_msg03027.html&d=DwIDAg&c=s883GpUCOChKOHiocYtGcg&r=c23RpsaH4D2MKyD3EPJTDa0BAxz6tV8aUJqVSoytEiY&m=VQIG-iu-1g3JyKdn64SEj6Y6dVqbYfE1Qg5Y_tIeWrwR2OCa24MKUVV00MIY_5Pz&s=zH9Je8Y209R_2E3w533VXDqbRP-uhhuILVcvmoCkXdM&e=
it was suggested that the ioapic version property should be deprecated. A patch
to deprecate the
property was proposed at
https://urldefense.proofpoint.com/v2/url?u=https-3A__patchew.org_QEMU_20260210032348.987549-2D1-2Dzhao1.liu-40intel.com_20260210032348.987549-2D18-2Dzhao1.liu-40intel.com_&d=DwIDAg&c=s883GpUCOChKOHiocYtGcg&r=c23RpsaH4D2MKyD3EPJTDa0BAxz6tV8aUJqVSoytEiY&m=VQIG-iu-1g3JyKdn64SEj6Y6dVqbYfE1Qg5Y_tIeWrwR2OCa24MKUVV00MIY_5Pz&s=yWQKfxQqB_u6jU-CM9IYW1HqfEV6C3rUvz1pWzavjTc&e=
but was never merged.
In the context of Khushit's patch at
https://urldefense.proofpoint.com/v2/url?u=https-3A__patchew.org_QEMU_20260804091827.3203086-2D1-2Dkhushit.shah-40nutanix.com_&d=DwIDAg&c=s883GpUCOChKOHiocYtGcg&r=c23RpsaH4D2MKyD3EPJTDa0BAxz6tV8aUJqVSoytEiY&m=VQIG-iu-1g3JyKdn64SEj6Y6dVqbYfE1Qg5Y_tIeWrwR2OCa24MKUVV00MIY_5Pz&s=rM6OQKsZNIdWJwPgdGzV6Y5ngrZQIxJecIlXXX8Wr9k&e=
it makes sense to formally deprecate the ioapic version property.
diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst
index 0c656a968f..bfe7240040 100644
--- a/docs/about/deprecated.rst
+++ b/docs/about/deprecated.rst
@@ -305,6 +305,16 @@ the addition of volatile memory support, it is now
necessary to distinguish
between persistent and volatile memory backends. As such, memdev is
deprecated
in favor of persistent-memdev.
+``ioapic.version=xxxx`` (since 11.2)
+''''''''''''''''''''''''''''''''''''
+
+The ``ioapic`` device ``version`` property configures the IOAPIC version for
x86
+machines and is typically set from the command line using
+``-global`` as it is an in-built device. It was originally set to 0x11 but
since
+version 2.8 all x86 machines have defaulted to using 0x20. As all machines
prior
+to v4.2 have now been removed, this property is no longer required. Deprecate
the
+``ioapic`` device ``version`` property so that it can be removed in a future
QEMU
+release.
RISC-V CPU properties which start with capital 'Z' (since 8.2)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Ping?
ATB,
Mark.
