Toolchain build scripts
There are times where a tip of tree LLVM build will have some issue fixed and it isn't available to you, maybe because it isn't in a release or it isn't available through your distribution's package management system. At that point, to get that fix, LLVM needs to be compiled, which sounds scary but is rather simple. The
build-llvm.py script takes it a step farther by trying to optimize both LLVM's build time by:
- Trimming down a lot of things that kernel developers don't care about:
- LLVM tests
- Ocaml bindings
- Building with the faster tools available (in order of fastest to slowest):
- clang + lld
- clang/gcc + ld.gold
- clang/gcc + ld.bfd
These scripts have been tested in a Docker image of the following distributions, with the following packages installed:
apt install ca-certificates ccache clang cmake curl file gcc g++ git make ninja-build python3 texinfo zlib1g-dev
On Debian Buster or Ubuntu Bionic/Cosmic/Disco,
apt install lldshould be added as well for faster compiles.
dnf install ccache clang cmake gcc gcc-c++ git lld make ninja-build python3 zlib-devel
pacman -S base-devel ccache clang cmake git lld ninja python3
If you intend to compile with PGO, please ensure that you also have
libssl-dev (or equivalent) installed as you will be building some Linux kernels. If you are building for PowerPC (which the script does by default), make sure
mkimage is available as well; the package is
u-boot-tools on Debian/Ubuntu.
Python 3.5.3+ is recommended, as that is what the script has been tested against. These scripts should be distribution agnostic. Please feel free to add different distribution install commands here through a pull request.
./build-llvm.py will clone LLVM, grab the latest binutils tarball (for the LLVMgold.so plugin), and build LLVM, clang, and lld, and install them into
./build-llvm.py -h for more options.
This script builds a standalone copy of binutils. By default,
./build-binutils.py will download binutils 2.32, build for all architectures we currently care about (arm32, aarch64, powerpc32, powerpc64le, and x86_64), and install them into
./build-binutils.py -h for more options.
Building a standalone copy of binutils might be needed because certain distributions like Arch Linux (whose options the script uses) might symlink
/usr/lib/bfd-plugins (source), which can cause issues when using the system's linker for LTO (even with
bfd plugin: LLVM gold plugin has failed to create LTO module: Unknown attribute kind (60) (Producer: 'LLVM9.0.0svn' Reader: 'LLVM 7.0.1')
Having a standalone copy of binutils (ideally in the same folder at the LLVM toolchain so that only one
PATH modification is needed) works around this without any adverse side effects. Another workaround is bind mounting the new
Please open an issue on this repo and include your distribution, shell, the command you ran, and the error output.