Allows to bundle LLVM inside ClickHouse repository. This is intended for reproducible builds, that continue to work regardless to changes of compile options and ABI changes.
The usage of this repository is not necessarily. Instead you can simply install packages libllvm5.0 liblld-5.0-dev libclang-5.0-dev from your Ubuntu repository and use them for build.
But when using packages from the system, a few downsides exist:
- it requires to use fresh enough version of Ubuntu for builds;
- the packages are usually outdated;
- the packages may lack static libraries;
- the packages may change in uncontrolled way and your build becomes irreproducible;
- different OS have their own combinations of packages - it's very difficult to follow;
- the packages was compiled with fixed compile flags and fixed ABI, you cannot change it;
- for example, you may want to rebuild packages with or without RTTI, with libc++ or libstdc++, with sanitizer, etc.
Downsides of bundled library:
- increased build time.
A brief sketch on how this repository was created:
clone https://github.com/llvm/llvm-project, commit e4b4f994d2f6a090694276b40d433dc1a58beb24 leave only clang, llvm, lld rm -rf {llvm,clang,lld}/{INPUTS,bindings,test,unittests,www,docs,examples} remove them from llvm/LLVMBuild.txt remove examples from clang/CMakeLists.txt remove docs from lld/CMakeLists.txt remove llvm/lib/Target/ all but X86 AArch64 PowerPC remove them from llvm/lib/Target/LLVMBuild.txt In llvm/CMakeLists.txt change options according to -D LLVM_ENABLE_PROJECTS='clang;lld' -D LLVM_TARGETS_TO_BUILD='Native' -D LLVM_ENABLE_BACKTRACES=0 -D LLVM_ENABLE_CRASH_OVERRIDES=0 -D LLVM_ENABLE_FFI=0 -D LLVM_ENABLE_TERMINFO=0 -D LLVM_ENABLE_LIBXML2=0 -D LLVM_ENABLE_LIBEDIT=0 -D LLVM_ENABLE_LIBPFM=0 -D LLVM_ENABLE_OCAMLDOC=0 -D LLVM_INCLUDE_UTILS=0 -D LLVM_BUILD_UTILS=0 -D LLVM_INCLUDE_RUNTIMES=0 -D LLVM_BUILD_RUNTIMES=0 -D LLVM_BUILD_RUNTIME=0 -D LLVM_BUILD_EXAMPLES=0 -D LLVM_INCLUDE_EXAMPLES=0 -D LLVM_BUILD_TESTS=0 -D LLVM_INCLUDE_TESTS=0 -D LLVM_INCLUDE_GO_TESTS=0 -D LLVM_INCLUDE_DOCS=0 remove llvm/tools but leave clang and lld in CMakeLists.txt remove lld/tools, clang/tools remove llvm/lib/Testing