gecko-dev/build/build-clang
Mike Hommey aa3b1da222 Bug 1450088 - Build clang with libxml2 support. r=froydnj
This is required for llvm-mt, which building winchecksec will require.
We do a dummy change to build-clang.sh so as to change the toolchain
index hash.

Differential Revision: https://phabricator.services.mozilla.com/D68153

--HG--
extra : moz-landing-system : lando
2020-03-26 21:53:00 +00:00
..
README Bug 1573769 - Update of the build-clang doc after the move to git r=glandium 2019-08-14 07:40:58 +00:00
android-mangling-error.patch
bug-1605181-isConstexpr.patch Bug 1605181 - 'if constexpr' wasn't supported in clang-tidy r=andi 2019-12-19 18:32:40 +00:00
bug-1606630-if_constexpr.patch Bug 1606630 - For clang-tidy fix checkers `readability-misleading-indentation` and `readability-braces-around-statements`. r=sylvestre 2020-01-06 21:42:58 +00:00
build-clang.py Bug 1450088 - Build clang with libxml2 support. r=froydnj 2020-03-26 21:53:00 +00:00
clang-5.0-linux64.json Bug 1579189 - raise the minimum clang version to 5; r=#build 2019-11-14 11:16:38 -04:00
clang-7-linux64.json Bug 1603436 - Rename clang patch (critical_section_on_gcov_flush.patch) to make easier the switch to LLVM 10 r=dmajor 2019-12-12 22:13:04 +00:00
clang-9-mingw.json Bug 1590624 - Update the mingw-clang compiler to clang 9 r=dmajor 2019-12-12 07:43:53 +00:00
clang-android.json Bug 1603436 - Rename clang patch (critical_section_on_gcov_flush.patch) to make easier the switch to LLVM 10 r=dmajor 2019-12-12 22:13:04 +00:00
clang-linux64-aarch64-cross.json Bug 1603436 - Rename clang patch (critical_section_on_gcov_flush.patch) to make easier the switch to LLVM 10 r=dmajor 2019-12-12 22:13:04 +00:00
clang-linux64-cross.json Bug 1608460 - Redefine MIDL names to be unique to work around a clang-cl bug r=froydnj 2020-01-10 17:53:29 +00:00
clang-linux64.json Bug 1624267 - Fix intermittent hangs with ThreadSanitizer. r=froydnj 2020-03-23 13:08:47 +00:00
clang-macosx64.json Bug 1603436 - Rename clang patch (critical_section_on_gcov_flush.patch) to make easier the switch to LLVM 10 r=dmajor 2019-12-12 22:13:04 +00:00
clang-tidy-ci.patch Bug 1589096 - add registerPPCallbacks to our version of clang-tidy due to a limitation in mozilla-must-override. r=sylvestre 2019-10-31 12:16:35 +00:00
clang-tidy-linux64.json Bug 1606630 - For clang-tidy fix checkers `readability-misleading-indentation` and `readability-braces-around-statements`. r=sylvestre 2020-01-06 21:42:58 +00:00
clang-tidy-macosx64.json Bug 1606630 - For clang-tidy fix checkers `readability-misleading-indentation` and `readability-braces-around-statements`. r=sylvestre 2020-01-06 21:42:58 +00:00
clang-tidy-no-errors.patch Bug 1600033 - for clang-tidy force the output diagnostic as warnings from errors.r=sylvestre 2019-11-28 21:15:01 +00:00
clang-tidy-win64.json Bug 1606630 - For clang-tidy fix checkers `readability-misleading-indentation` and `readability-braces-around-statements`. r=sylvestre 2020-01-06 21:42:58 +00:00
clang-win64.json Bug 1608460 - Redefine MIDL names to be unique to work around a clang-cl bug r=froydnj 2020-01-10 17:53:29 +00:00
compiler-rt-cross-compile.patch Bug 1551690 - be more specific about the LLVM target on OS X; r=nalexander 2019-05-21 17:53:44 +00:00
compiler-rt-no-codesign.patch Bug 1573211 - Update to clang 9.0.0 r=glandium 2019-09-21 16:26:53 +02:00
critical_section_on_gcov_flush-rG02ce9d8ef5a8.patch Bug 1603436 - Rename clang patch (critical_section_on_gcov_flush.patch) to make easier the switch to LLVM 10 r=dmajor 2019-12-12 22:13:04 +00:00
downgrade-mangling-error.patch Bug 1573211 - Update to clang 9.0.0 r=glandium 2019-09-21 16:26:53 +02:00
find_symbolizer_linux.patch
llvmorg-11-init-4265-g2dcbdba8540.patch Bug 1598342 - Import TSan fix D74828 from Clang upstream. r=froydnj 2020-02-26 21:19:47 +00:00
loosen-msvc-detection.patch
r350774.patch Bug 1541943 - Temporarily switch libFuzzer builds back to clang-7. r=froydnj 2019-04-04 16:47:57 +00:00
rG7e18aeba5062.patch Bug 1597901 - Fix some sources of non-determinism in clang. r=dmajor 2019-12-05 22:28:01 +00:00
rename_gcov_flush.patch Backed out changeset 870b38a3dc28 (bug 1602482) for as per dev's request. a=backout 2019-12-10 13:47:12 +02:00
rename_gcov_flush_7.patch Bug 1541943 - Temporarily switch libFuzzer builds back to clang-7. r=froydnj 2019-04-04 16:47:57 +00:00
revert-r362047-and-r362065.patch Bug 1573211 - Update to clang 9.0.0 r=glandium 2019-09-21 16:26:53 +02:00
static-llvm-symbolizer.patch
tsan-hang-be41a98ac222.patch Bug 1624267 - Fix intermittent hangs with ThreadSanitizer. r=froydnj 2020-03-23 13:08:47 +00:00
unpoison-thread-stacks.patch Bug 1573211 - Update to clang 9.0.0 r=glandium 2019-09-21 16:26:53 +02:00

README

build-clang.py
==============

A script to build clang from source.

```
usage: build-clang.py [-h] -c CONFIG [--clean]

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Clang configuration file
  --clean               Clean the build directory
```

Pre-requisites
--------------
* Working build toolchain.
* git
* CMake
* Ninja
* Python 2.7 and 3

Please use the latest available CMake for your platform to avoid surprises.

Config file format
------------------

build-clang.py accepts a JSON config format with the following fields:

* stages: Use 1, 2, or 3 to select different compiler stages.  The default is 3.
* python_path: Path to the Python 2.7 installation on the machine building clang.
* gcc_dir: Path to the gcc toolchain installation, only required on Linux.
* cc: Path to the bootsraping C Compiler.
* cxx: Path to the bootsraping C++ Compiler.
* as: Path to the assembler tool.
* ar: Path to the library archiver tool.
* ranlib: Path to the ranlib tool (optional).
* libtool: Path to the libtool tool (optional).
* ld: Path to the linker.
* patches: Optional list of patches to apply.
* build_type: The type of build to make.  Supported types: Release, Debug, RelWithDebInfo or MinSizeRel.
* build_libcxx: Whether to build with libcxx.  The default is false.
* build_clang_tidy: Whether to build clang-tidy with the Mozilla checks imported.  The default is false.
* osx_cross_compile: Whether to invoke CMake for OS X cross compile builds.
* assertions: Whether to enable LLVM assertions.  The default is false.

The revisions are defined in taskcluster/ci/fetch/toolchains.yml. They are usually commit sha1s corresponding to upstream tags.

Environment Variables
---------------------

The following environment variables are used for cross-compile builds targeting OS X on Linux.

* CROSS_CCTOOLS_PATH: Path to the cctools directory where the cross compiler toolchain is located.
* CROSS_SYSROOT: Path to the OS X SDK directory for cross compile builds.