On 16/09/2026 14:45, Mark Cave-Ayland wrote:
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?
Ping again?
ATB,
Mark.
