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
---