Linx Toolchain Build

This repository contains the top-level build flow for the Linx LLVM + musl toolchain.

Components

make init-src creates src/ and checks out the required component repositories:

Directory	Repository	Branch
src/llvm-project	https://github.com/LinxISA/llvm-project.git	dev-llvm15_56
src/musl	https://github.com/LinxISA/linx-musl.git	linx
src/jemalloc	https://github.com/LinxISA/jemalloc.git	linx
src/linux-linxisa	https://github.com/LinxISA/linux.git	main
src/Linx-TileOP-API	https://github.com/LinxISA/Linx-TileOP-API.git	linx

Quick Start

Install the host build tools first:

sudo apt-get install -y git make cmake ninja-build gcc g++ python3 autoconf m4

Initialize component sources:

make init-src

Build the linx64v5-linux-musl toolchain:

make WITH_TARGET=linx64v5-linux-musl

Package the build output:

make package

The default install tree is output/linx_blockisa_llvm_musl, and the package is written to:

output/linx_blockisa_llvm_musl.tar.gz

Only WITH_TARGET=linx64v5-linux-musl is supported by the top-level Makefile.

Releases

Pushing a tag v* triggers the GitHub Actions workflows in .github/workflows/:

• build-toolchain-linux.yml — builds for x86_64 and aarch64 Linux hosts
• build-toolchain-mac.yml — builds for macOS (Apple Silicon, experimental)

Each host produces a host-qualified package and attaches it to the GitHub Release for the pushed tag:

linx_blockisa_llvm_musl-x86_64-linux.tar.gz
linx_blockisa_llvm_musl-aarch64-linux.tar.gz
linx_blockisa_llvm_musl-arm64-macos.tar.gz   (experimental)

The LLVM build tree is cached by the LLVM source SHA (see LLVM_REF), so a re-run with unchanged LLVM skips the most expensive step. Tag and release runs consume the cache; the default branch and nightly runs warm it.

To cut a release:

git tag v2026.06.25
git push origin v2026.06.25