On 2026-11-12 15:03, Philippe Mathieu-Daudé wrote:
Enable runtime byte-order selection for aarch64-linux-user
and retain qemu-aarch64_be as a compatibility symlink.
Deprecate the symlink since 12.0 and recommend qemu-aarch64
for both ELF byte orders.
Remove the separate aarch64_be-linux-user build target and
obsolete CI exclusions.

Run the existing big-endian hello test through qemu-aarch64
while retaining its big-endian fixture toolchain. Document
that executable name compatibility does not preserve the
removed target-list spelling.

Signed-off-by: Philippe Mathieu-Daudé <[email protected]>
---
  docs/about/deprecated.rst                 | 13 +++++++++++++
  docs/user/main.rst                        |  7 +++++++
  configs/targets/aarch64-linux-user.mak    |  2 ++
  configs/targets/aarch64_be-linux-user.mak | 10 ----------
  .gitlab-ci.d/buildtest.yml                |  2 +-
  .gitlab-ci.d/crossbuild-template.yml      |  4 ++--
  tests/tcg/aarch64_be/meson.build          |  4 ++--
  7 files changed, 27 insertions(+), 15 deletions(-)
  delete mode 100644 configs/targets/aarch64_be-linux-user.mak

diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst
index 0891bbc44ded..20eb4268f640 100644
--- a/docs/about/deprecated.rst
+++ b/docs/about/deprecated.rst
@@ -438,6 +438,19 @@ It was implemented as a no-op instruction in TCG up to 
QEMU 9.0, but
  only with ``-cpu max`` (which does not guarantee migration compatibility
  across versions).
+linux-user mode executables
+---------------------------
+
+.. _deprecated-qemu-aarch64-be:
+
+``qemu-aarch64_be`` executable name (since 12.0)
+''''''''''''''''''''''''''''''''''''''''''''''''
+
+The ``qemu-aarch64_be`` compatibility symlink is deprecated.
+Use ``qemu-aarch64`` instead for both little- and big-endian
+Linux ELF executables. The emulator selects the byte order from
+the ELF header, regardless of the executable name used to invoke it.
+
  linux-user mode CPUs
  --------------------
diff --git a/docs/user/main.rst b/docs/user/main.rst
index a8ddf9142495..9dcea8dac4d0 100644
--- a/docs/user/main.rst
+++ b/docs/user/main.rst
@@ -65,6 +65,13 @@ emulator.
  Linux User space emulator
  -------------------------
+For AArch64, ``qemu-aarch64`` runs both little- and big-endian Linux ELF
+executables, selecting the byte order from the ELF header. ``qemu-aarch64_be``
+is a :ref:`deprecated compatibility symlink <deprecated-qemu-aarch64-be>`
+to the same emulator; its name does not override the ELF byte order.
+Build both names with ``--target-list=aarch64-linux-user``; the separate
+``aarch64_be-linux-user`` build target is no longer supported.
+

Squashing:

-- >8 --
diff --git a/configure b/configure
index af14a9c23e..821a887a31 100755
--- a/configure
+++ b/configure
@@ -1107,7 +1107,14 @@ else
             *" $target "*)
                 ;;
             *)
-                error_exit "Unknown target name '$target'"
+                case "$target" in
+                    aarch64_be-linux-user)
+ error_exit "Target '$target' is no longer supported; use 'aarch64-linux-user' instead"
+                        ;;
+                    *)
+                        error_exit "Unknown target name '$target'"
+                        ;;
+                esac
                 ;;
         esac
     done
---

Reply via email to