From 9a2aa6bfebd63a768304daa0bc9da7cd7c131b6f Mon Sep 17 00:00:00 2001 From: Mark Cave-Ayland Date: Thu, 23 Oct 2025 15:28:10 +0100 Subject: [PATCH] docs/about/deprecated.rst: document isapc deprecation for modern x86 CPU models MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Add a new paragraph in the "Backwards compatibility" section documenting that using modern x86 CPU models with the isapc machine is deprecated, and will be rejected in a future release. Signed-off-by: Mark Cave-Ayland Reviewed-by: Philippe Mathieu-Daudé Link: https://lore.kernel.org/r/20251023142926.964718-3-mark.caveayland@nutanix.com Signed-off-by: Paolo Bonzini --- docs/about/deprecated.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst index dacf2882e4..020610132f 100644 --- a/docs/about/deprecated.rst +++ b/docs/about/deprecated.rst @@ -544,6 +544,20 @@ available firmwares that are using the current (wrong) name. The property is kept as is in 9.1, together with "riscv,delegation", to give more time for firmware developers to change their code. +x86 "isapc" board use of modern x86 CPUs (since 10.2) +''''''''''''''''''''''''''''''''''''''''''''''''''''' + +The "isapc" board represents a historical x86 ISA PC and is intended for +older 32-bit x86 CPU models, defaulting to a 486 CPU model. Previously it +was possible (but non-sensical) to specify a more modern x86 CPU, including +``-cpu host`` or ``-cpu max`` even if the features were incompatible with many +of the intended guest OSs. + +If the user requests a modern x86 CPU model (i.e. not one of ``486``, +``athlon``, ``kvm32``, ``pentium``, ``pentium2``, ``pentium3``or ``qemu32``) +a warning will be displayed until a future QEMU version when such CPUs will +be rejected. + Migration --------- -- 2.47.3