Repository files navigation

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

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

• LLVM, LLD, Clang 21.1.0
• zlib 1.3.1
• zstd 1.5.2
• zig 0.16.0-dev.1354+94e98bfe8

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

• all: Deleted unused files.
• LLVM: Support .lib extension for static zstd.
• LLVM: Portable handling of .def linker flag
• LLVM: Don't pass -static when building executables.
• Clang: Ignore the examples directory
• Clang: Disable building of libclang-cpp.so.
• Clang: removenvptx-arch andamdgpu-arch symlinks
• LLD: Added additional include directory to Zig's libunwind.
• LLD: RespectLLD_BUILD_TOOLS=OFF
• LLD: Skip building docs
• zlib: Delete the ability to build a shared library.

• 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 <arch>-<os>-<abi> <mcpu>

All parameters are required:

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

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

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

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

Bootstrapping on Windows with MSVC is also possible viabuild.bat, whichtakes the same arguments asbuild above.

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

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

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

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

If you try a "not tested" one and find a problem please file an issue,and a pull request linking to the issue in the table.

If you try a "not tested" one and find that it works, please file a pull requestchanging the status to "OK".

If you try an "OK" one and it does not work, please check if there is an existingissue, and if not, file an issue.

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