AArch64 QEMU User Space Emulation

This page may be obsolete.
It contains historical information. For current information, please see AArch64 Emulation.

QEMU linux-user

There is a QEMU userspace emulator available to execute AArch64 applications on an x86_64 machine and kernel. This program interprets aarch64 binaries and translates operating system calls to the underlying x86_64 kernel, enabling many aarch64 binaries to be executed with good performance. However, because it does not emulate the full system, some capabilities are not available: in particular, debugging software such as gdb and strace will not work.

This system works by installing a binfmt (binary format) handler for aarch64 binaries. When the kernel attempts to execute a binary, it will analyze the binary's signature data, and if it matches the aarch64 elf signature, the qemu userspace system is invoked as an interpreter for the binary.

This approach works best when a directory tree of a complete aarch64 system is installed, and then chroot is used to make that the root of a new process; this allows the aarch64 binaries to easily use aarch64 shared object libraries (.so). The qemu binfmt handler/interpreter can be installed inside the aarch64 directory tree.

Therefore, the two pieces that need to be installed are the directory tree, containing the aarch64 userspace files and interpreter, and the binfmt configuration file.

Special Mounts

In the arm64 chroot, some commands such as mount and top will not work correctly because special filesystems such as /proc and /sys are not mounted. If you need those filesystems, explicitly mount them within your chroot environment, remembering to unmount them when you're done.

Superuser access - Danger!
While in the chroot environment, you are a superuser. Although the chroot provides partial protection, it is still possible to cause major damage. Take care not to delete entries in the special mounts or perform other actions that would affect the host or other users.

If you create a regular user within the chroot environment for safety, you can change to that user using the command su username

Setting Up Qemu User Space Emulation

Fedora 19
The tarball mentioned here contains the preliminary aarch64 version of Fedora 19. The library versions, etc. are very old -- some of the earliest Aarch64 ports. Please feel free to update the image and contribute an updated tarball!

On Xerxes

1. Unpack the archive in your home directory:

cd ; sudo tar xvf /public/qemu-linux-user-aarch64

2. To switch to arm64/aarch64 mode, type:

sudo chroot ~/arm64

Alias Recommended
It's a good idea to create an alias (and additional sudoers entry) to simplify the transition to the arm64 chroot. Doing so is left as an exercise for the reader.

On your home system

1. Obtain the files in the /public/qemu-linux-user-aarch64 directory on Xerxes: arm64.qemu-userspace.tgz and qemu-arm64.conf

2. Copy those files your machine.

3. In a suitable location with at least 1.1GB of storage available, unpack the arm64.qemu-userspace.tgz archive as root (use -p to preserve permissions and timestamps).

4. Put the qemu-arm64.conf file into /etc/binfmt.d/qemu-arm64.conf on your local machine.

4. Activate the new qemu-arm64 binformat configuration:

sudo systemctl restart systemd-binfmt

5. To switch to arm64/aarch64 mode, type:

sudo chroot ~/arm64 # or wherever you put your arm64 directory