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://lists.gnu.org/archive/html/qemu-devel/2025-05/msg03027.html it was suggested that the ioapic version property should be deprecated. A patch to deprecate the property was proposed at https://patchew.org/QEMU/[email protected]/[email protected]/ but was never merged. In the context of Khushit's patch at https://patchew.org/QEMU/[email protected]/ 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) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- 2.43.0
