зеркало из https://github.com/mozilla/gecko-dev.git
55896c33ae
As much as it's tempting to use LLD for LTO, it still causes some subtle problems with the build, and it's still better to keep using BFD ld for the time being. Doing so requires the gold plugin, which only requires to pass cmake the directory where the binutils headers are, and they are part of the gcc toolchain headers. Differential Revision: https://phabricator.services.mozilla.com/D4896 |
||
|---|---|---|
| .. | ||
| README | ||
| build-clang.py | ||
| clang-3.9-linux64.json | ||
| clang-6-linux64.json | ||
| clang-6-macosx64.json | ||
| clang-7-pre-linux64.json | ||
| clang-7-pre-mingw.json | ||
| clang-tidy-linux64.json | ||
| clang-tidy-macosx64.json | ||
| clang-tidy-win32.json | ||
| clang-tidy-win64.json | ||
| clang-win32-st-an.json | ||
| clang-win64-st-an.json | ||
| clang-win64.json | ||
| compiler-rt-cross-compile.patch | ||
| compiler-rt-no-codesign.patch | ||
| fflush-before-unlocking.patch | ||
| find_symbolizer_linux.patch | ||
| llvm-debug-frame.patch | ||
| loosen-msvc-detection.patch | ||
| msvc-host-x64.patch | ||
| r277806.patch | ||
| r285657.patch | ||
| r289565-for-3.9.patch | ||
| r313872.patch | ||
| r318309.patch | ||
| r320462.patch | ||
| r322325.patch | ||
| r322401.patch | ||
| r325356.patch | ||
| r327876.patch | ||
| r339636.patch | ||
| rename_gcov_flush.patch | ||
| workaround-issue38586.patch | ||
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.
* Subversion
* CMake
* Ninja
* Python 2.7
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:
* llvm_revision: The LLVM SVN revision to build.
* stages: Use 1, 2, or 3 to select different compiler stages. The default is 3.
* llvm_repo: SVN path to the LLVM repo.
* clang_repo: SVN path to the Clang repo.
* extra_repo: SVN path to the clang-tools-extra repo.
* lld_repo: SVN path to the lld repo.
* compiler_repo: SVN path to the compiler-rt repo.
* libcxx_repo: SVN path to the libcxx repo.
* libcxxabi_repo: SVN path to the libcxxabi repo.
* 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.
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.