Skip to content

Release experimental aarch64 binaries and document Arm support - #31

Merged
yohanchatelain merged 1 commit into
verificarlo:mainfrom
yohanchatelain:arm-docs-release
Oct 8, 2026
Merged

yohanchatelain merged 1 commit into
verificarlo:mainfrom
yohanchatelain:arm-docs-release

Conversation

@yohanchatelain

Copy link
Copy Markdown
Collaborator

Phase 6 of the experimental Arm support: release binaries and documentation.

Release workflow

  • Adds linux-aarch64 archives for LLVM 17–20, built on ubuntu-22.04-arm runners (same Ubuntu release as the x86-64 archives). The x86-64 matrix is unchanged.
  • The aarch64 build targets the armv8-a baseline, so the archives run on any aarch64 CPU. They contain NEON code only: the static library is NEON_WITHOUT_AES, and the dynamic library also includes NEON and NEON_BF16 and selects the best one at runtime. SVE stays out of the releases while it is opt-in (Experimental Arm: opt-in SVE targets, target reporting and Arm CI #28).
  • On aarch64, LLVM and the build tools come from the existing arm-setup action, which now exports LLVM_PATH as install-llvm-action does on x86.
  • BUILD-INFO.txt now lists the Highway targets each library was built for, on both architectures, and marks the aarch64 archives as experimental. It leaves out the target that dispatch selects on the build machine, since that says nothing about the user's CPU.

README

  • The binary release table and install instructions now cover aarch64.
  • A new "Arm support (experimental)" section covers the NEON default, the SVE opt-in and its clang ≥ 22 requirement, --with-arch, make target-info, the NEON vs SVE performance on a Cortex-X925 (Make the performance tests robust to timer granularity #30), and how to run the tests with wider SVE vectors under QEMU.

Validation

  • I started the release workflow manually on the fork (run). All 20 build jobs passed (16 x86-64, 4 aarch64); the publish job only runs for a real release.
  • I downloaded the four aarch64 archives and checked them on a GB10 (Cortex-X925/A725):
    • BUILD-INFO.txt lists the expected targets.
    • The LLVM IR in each archive was built by the matching clang (17.0.6 to 20.1.8).
    • A small C program linked against libprism-dynamic.so and against libprism-static.a gives correct stochastic rounding: about 1/4 of 1 + 2^-25 rounds up, as expected.

🤖 Generated with Claude Code

Add a linux-aarch64 build to the release workflow for LLVM 17-20. It runs
on Ubuntu 22.04 arm64 runners, like the x86-64 archives, and targets the
armv8-a baseline: NEON only, with the dynamic library selecting newer NEON
targets at runtime. The archives record the built Highway targets in
BUILD-INFO.txt (and the experimental status on aarch64). arm-setup now
exports LLVM_PATH, as install-llvm-action does on x86.

The README documents the aarch64 archives, the Arm support status, the
NEON vs SVE performance on a Cortex-X925 and how to test wider SVE
vectors under QEMU.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@yohanchatelain
yohanchatelain merged commit 69b85eb into verificarlo:main Oct 8, 2026
10 checks passed
@yohanchatelain
yohanchatelain deleted the arm-docs-release branch October 8, 2026 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant