ziglang/zig-bootstrap
Watch
1
0
Fork
You've already forked zig-bootstrap
 0
mirror of https://codeberg.org/ziglang/zig-bootstrap.git synced 2026-11-04 02:36:09 +00:00
Code Issues Projects Packages Wiki Activity
Start with minimal system dependencies and build a fully operational Zig compiler for any target.
737 commits 13 branches 20 tags 448 MiB
  • Batchfile 58.3%
  • Shell 41.7%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
neoto ff41fc70bb
 llvm patch: Handle division by zero trap on MIPS1 
LLVM currently emits the `teq` instruction for every arch version, but
`teq` is unsupported on MIPS1.
This special cases MIPS1 so that `bne(z)` and `break` are emitted
instead.
Compared to https://github.com/llvm/llvm-project/pull/81311, this should
also handle liveness as far as I can tell.

I didn't want to add another bool to the argument list so I combined
`IsMicroMips` and what was supposed to be `IsMips1` into an enum, which
feels much nicer in this case.
Besides that and the main change, I also changed the `hasSideEffects`
bit for `PseudoSDIV` and `PseudoUDIV`,
which allows the delay slot to be usefully filled - well, at least with
`-O1`+. This seems to be in line with what GCC does:
https://godbolt.org/z/zqcG5ha35

Tested using clang directly and through Zig's LLVM backend.

Closes https://github.com/llvm/llvm-project/issues/80554
Supersedes https://github.com/llvm/llvm-project/pull/81311

(cherry picked from commit 8864a4bb996d6bb541b0974d34991da40a643c90)
2026-10-27 06:02:35 +01:00
clang clang patch: don't build perf-training 2026-10-27 05:58:00 +01:00
cmake/Modules update LLVM sources to 23.1.4 2026-10-27 05:50:05 +01:00
libc update LLVM sources to 23.1.4 2026-10-27 05:50:05 +01:00
lld lld patch: OpenBSD findMajMinShlib() logic 2026-10-27 05:58:19 +01:00
llvm llvm patch: Handle division by zero trap on MIPS1 2026-10-27 06:02:35 +01:00
third-party update LLVM sources to 23.1.2 2026-10-02 01:49:45 +02:00
zig update zig sources to 0.18.0-dev.410+4bf2fe2ed 2026-10-20 10:56:19 +02:00
zlib zlib patch: only build a static version, no examples 2024-05-09 01:58:05 -07:00
zstd add zstd v1.5.2 sources 2022-10-23 18:53:34 -07:00
.gitattributes update LLVM sources to 23.1.2 2026-10-02 01:49:45 +02:00
.gitignore local zig cache folder is .zig-cache now 2024-07-19 12:48:00 -07:00
build update zig sources to 0.18.0-dev.410+4bf2fe2ed 2026-10-20 10:56:19 +02:00
build.bat update zig sources to 0.18.0-dev.410+4bf2fe2ed 2026-10-20 10:56:19 +02:00
README.md llvm patch: Handle division by zero trap on MIPS1 2026-10-27 06:02:35 +01:00

README.md

zig-bootstrap

The purpose of this project is to start with minimum system dependencies and end with a fully operational Zig compiler for any target.

Version Information

This repository copies sources from upstream. Patches listed below. Use git to find and inspect the patch diffs.

  • LLVM, LLD, Clang 23.1.4
  • zlib 1.3.1
  • zstd 1.5.2
  • zig 0.18.0-dev.410+4bf2fe2ed

For other versions, check the git tags of this repository.

Patches

  • all: Deleted unused files.
  • LLVM: Support .lib extension for static zstd.
  • LLVM: Don't pass -static when building executables.
  • LLVM: OpenBSD llvm-config logic
  • LLVM: Handle division by zero trap on MIPS1
  • Clang: Ignore the examples directory
  • Clang: Disable building of libclang-cpp.so.
  • Clang: remove nvptx-arch and amdgpu-arch symlinks
  • Clang: remove broken scan-build manpage install logic
  • LLD: Added additional include directory to Zig's libunwind.
  • LLD: Respect LLD_BUILD_TOOLS=OFF
  • LLD: Skip building docs
  • LLD: OpenBSD findMajMinShlib() logic
  • zlib: Delete the ability to build a shared library.

Host System Dependencies

  • C++ compiler capable of building LLVM, Clang, and LLD from source (GCC 5.1+ or Clang)
    • On some systems, static libstdc++/libc++ may need to be installed
  • CMake 3.19 or later
  • make, ninja, or any other build system supported by CMake
  • POSIX system (bash, mkdir, cd)
  • Python 3

Build Instructions

./build <arch>-<os>-<abi> <mcpu>

All parameters are required:

  • <arch>-<os>-<abi>: Replace with one of the Supported Targets below, or use native for the <arch> value (e.g. native-linux-gnu) to use the native architecture.
  • <mcpu>: Replace with a -mcpu parameter of Zig. baseline is recommended and means it will target a generic CPU for the target. native means it will target the native CPU. See the Zig documentation for more details.

Please be aware of the following two CMake environment variables that can significantly affect how long it takes to build:

  • CMAKE_GENERATOR can be used to select a different generator instead of the default. For example, CMAKE_GENERATOR=Ninja.
  • CMAKE_BUILD_PARALLEL_LEVEL can be used to introduce parallelism to build systems (such as make) which do not default to parallel builds. This option is irrelevant when using Ninja.

When it succeeds, output can be found in out/zig-<target>-<cpu>/.

Windows Build Instructions

Bootstrapping on Windows with MSVC is also possible via build.bat, which takes the same arguments as build above.

This script requires that the "C++ CMake tools for Windows" component be installed via the Visual Studio installer.

The script must be run within the Developer Command Prompt for VS 2019 shell:

build.bat <arch>-<os>-<abi> <mcpu>

To build for x86 Windows, run the script within the x86 Native Tools Command Prompt for VS 2019.

Supported Targets

Note: Generally, for Linux targets, we prefer the musl libc builds over the glibc builds here, because musl builds end up producing a static binary, which is more portable across Linux distributions.

FreeBSD

Target Status
aarch64-freebsd-none OK
arm-freebsd-eabihf OK
powerpc64-freebsd-none OK
powerpc64le-freebsd-none OK
riscv64-freebsd-none OK
x86_64-freebsd-none OK

Linux

Target Status
aarch64-linux-gnu OK
aarch64-linux-musl OK
aarch64_be-linux-gnu OK
aarch64_be-linux-musl OK
arm-linux-gnueabi OK
arm-linux-gnueabihf OK
arm-linux-musleabi OK
arm-linux-musleabihf OK
armeb-linux-gnueabi OK
armeb-linux-gnueabihf OK
armeb-linux-musleabi OK
armeb-linux-musleabihf OK
hexagon-linux-musl OK
loongarch64-linux-gnu OK
loongarch64-linux-gnusf OK
loongarch64-linux-musl OK
loongarch64-linux-muslsf OK
mips-linux-gnueabi OK
mips-linux-gnueabihf OK
mips-linux-musleabi OK
mips-linux-musleabihf OK
mips64-linux-gnuabi64 OK
mips64-linux-gnuabin32 OK
mips64-linux-muslabi64 OK
mips64-linux-muslabin32 OK
mips64el-linux-gnuabi64 OK
mips64el-linux-gnuabin32 OK
mips64el-linux-muslabi64 OK
mips64el-linux-muslabin32 OK
mipsel-linux-gnueabi OK
mipsel-linux-gnueabihf OK
mipsel-linux-musleabi OK
mipsel-linux-musleabihf OK
powerpc-linux-musleabi OK
powerpc-linux-musleabihf OK
powerpc64-linux-musl OK
powerpc64le-linux-gnu OK
powerpc64le-linux-musl OK
riscv32-linux-gnu OK
riscv32-linux-musl OK
riscv64-linux-gnu OK
riscv64-linux-musl OK
s390x-linux-gnu OK
s390x-linux-musl OK
sparc-linux-gnu #117
sparc64-linux-gnu OK
thumb-linux-musleabi OK
thumb-linux-musleabihf OK
thumbeb-linux-musleabi OK
thumbeb-linux-musleabihf OK
x86-linux-gnu OK
x86-linux-musl OK
x86_64-linux-gnu OK
x86_64-linux-gnux32 OK
x86_64-linux-musl OK
x86_64-linux-muslx32 OK

macOS

Target Status
aarch64-macos-none OK
x86_64-macos-none OK

NetBSD

Target Status
aarch64-netbsd-none OK
aarch64_be-netbsd-none OK
arm-netbsd-eabi OK
arm-netbsd-eabihf OK
armeb-netbsd-eabi OK
armeb-netbsd-eabihf OK
mips-netbsd-eabi OK
mips-netbsd-eabihf OK
mipsel-netbsd-eabi OK
mipsel-netbsd-eabihf OK
powerpc-netbsd-eabi OK
powerpc-netbsd-eabihf OK
riscv32-netbsd-none OK
riscv64-netbsd-none OK
sparc-netbsd-none #230
sparc64-netbsd-none #231
x86-netbsd-none OK
x86_64-netbsd-none OK

OpenBSD

Target Status
aarch64-openbsd-none OK
arm-openbsd-eabi OK
mips64-openbsd-none OK
mips64el-openbsd-none OK
powerpc-openbsd-eabihf OK
powerpc64-openbsd-none OK
riscv64-openbsd-none OK
sparc64-openbsd-none OK
x86-openbsd-none OK
x86_64-openbsd-none OK

Windows

Target Status
aarch64-windows-gnu OK
thumb-windows-gnu OK
x86-windows-gnu OK
x86_64-windows-gnu OK