diff mbox series

migration-guides/release-notes-5.3.rst: add x86 qemu micro-arch level bump

Message ID 20250829-qemu-level-5-3-v1-1-d2cac1e1bce1@bootlin.com
State Under Review
Headers show
Series migration-guides/release-notes-5.3.rst: add x86 qemu micro-arch level bump | expand

Commit Message

Antonin Godard Aug. 29, 2025, 9:04 a.m. UTC 
After commit c9585bb8689b ("Revert "qemux86-64: Reduce tuning to
core2-64"") in OE-Core, document the QEMU x86 micro-architecture level
bump in the release notes for 5.3.

Co-authored-by: Alexander Kanavin <alex.kanavin@gmail.com>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/migration-guides/release-notes-5.3.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)


---
base-commit: dbc6137cd13f982a7fd4d1b2df79dccb177db0fc
change-id: 20250829-qemu-level-5-3-4b9f91b0289a

Best regards,
--  
Antonin Godard <antonin.godard@bootlin.com>
diff mbox series

Patch

diff --git a/documentation/migration-guides/release-notes-5.3.rst b/documentation/migration-guides/release-notes-5.3.rst
index f32c6162d..4782c2436 100644
--- a/documentation/migration-guides/release-notes-5.3.rst
+++ b/documentation/migration-guides/release-notes-5.3.rst
@@ -311,6 +311,25 @@  New Features / Enhancements in |yocto-ver|
    -  Refactor :ref:`ref-classes-qemu` functions into library functions (in
       :oe_git:`lib/oe/qemu.py </openembedded-core/tree/meta/lib/oe/qemu.py>`).
 
+   -  The ``qemux86-64`` :term:`MACHINE` now defaults to the ``x86-64-v3``
+      micro-architecture level.
+
+      The previous default was Core 2 era processors. This change means that the
+      toolchain is configured to build for that level, and QEMU is configured to
+      emulate it.
+
+      The v3 level adds support for AVX/AVX2/BMI/BMI2/F16C and other newer
+      instructions which are seeing increasing usage in modern software and add
+      performance benefits. Please see :wikipedia:`X86-64 Microarchitecture
+      levels <X86-64#Microarchitecture_levels>` for definition of the levels and
+      lists of Intel/AMD CPUs where support for the instructions was first
+      added.
+
+      Note that if QEMU system emulation is used on an x86 build machine with
+      :wikipedia:`KVM <Kernel-based_Virtual_Machine>` enabled, then the build
+      machine's CPU must also be recent enough to support these instructions
+      natively.
+
 -  Documentation changes:
 
    -  Part of :term:`BitBake` internals are now documented at