LLVM-6.0.1

LLVM の概要

The LLVM package contains a collection of modular and reusable compiler and toolchain technologies. The Low Level Virtual Machine (LLVM) Core libraries provide a modern source and target-independent optimizer, along with code generation support for many popular CPUs (as well as some less common ones!). These libraries are built around a well specified code representation known as the LLVM intermediate representation ("LLVM IR").

The optional Clang and Compiler RT packages provide new C, C++, Objective C and Objective C++ front-ends and runtime libraries for the LLVM and are required by some packages which use Rust, for example firefox.

本パッケージは LFS-8.3 において正しくビルドでき動作することが確認されています。

パッケージ情報

  • ダウンロード (HTTP): http://llvm.org/releases/6.0.1/llvm-6.0.1.src.tar.xz

  • ダウンロード MD5 sum: c88c98709300ce2c285391f387fecce0

  • ダウンロードサイズ: 24.1 MB

  • 必要ディスク容量: 2.8 GB (Clang 込み、テスト実施時はさらに 10.8 GB)

  • 概算ビルド時間: 29 SBU (Clang 込み、 parallelism=4、テスト実施時はさらに 10 SBU)

オプションパッケージのダウンロード

Clang

Compiler RT

LLVM の依存パッケージ

推奨

CMake-3.12.1, Python-2.7.15

任意

Doxygen-1.8.14, Graphviz-2.40.1, libxml2-2.9.8, texlive-20180414 (または install-tl-unx), Valgrind-3.13.0, Zip-3.0, OCaml, Sphinx

ユーザー情報: http://wiki.linuxfromscratch.org/blfs/wiki/llvm

LLVM のインストール

オプションパッケージをダウンロードしている場合は、以下のコマンドを実行してそれらをソースツリー内に含めます。

tar -xf ../cfe-6.0.1.src.tar.xz -C tools &&
tar -xf ../compiler-rt-6.0.1.src.tar.xz -C projects &&

mv tools/cfe-6.0.1.src tools/clang &&
mv projects/compiler-rt-6.0.1.src projects/compiler-rt

以下のコマンドを実行して llvm をビルドします。

mkdir -v build &&
cd       build &&

CC=gcc CXX=g++                              \
cmake -DCMAKE_INSTALL_PREFIX=/usr           \
      -DLLVM_ENABLE_FFI=ON                  \
      -DCMAKE_BUILD_TYPE=Release            \
      -DLLVM_BUILD_LLVM_DYLIB=ON            \
      -DLLVM_LINK_LLVM_DYLIB=ON             \
      -DLLVM_TARGETS_TO_BUILD="host;AMDGPU" \
      -DLLVM_BUILD_TESTS=ON                 \
      -Wno-dev -G Ninja ..                           &&
ninja

ビルド結果をテストする場合は ninja check-all を実行します。 テストはシングルスレッドとしてビルドされていますが、プロセッサー数/スレッド数の最大を使って実行することができます。 Sanitizer テストの数個(26479 のうち 9 個)は失敗します。

root ユーザーになって以下を実行します。

ninja install

If you have installed Sphinx and wish to generate the html documentation and manual pages, double check that you are still in the build directory and issue the following commands:

rm -rf ./*
cmake -DLLVM_ENABLE_SPHINX=ON         \
      -DSPHINX_WARNINGS_AS_ERRORS=OFF \
      -Wno-dev ..                     &&
make docs-llvm-html  docs-llvm-man

If you have downloaded the optional packages, the clang documentation can be built too:

make docs-clang-html docs-clang-man

Install the llvm documentation by running the following command as the root user:

install -v -m644 docs/man/* /usr/share/man/man1             &&
install -v -d -m755 /usr/share/doc/llvm-6.0.1/llvm-html     &&
cp -Rv docs/html/* /usr/share/doc/llvm-6.0.1/llvm-html

The clang documentation can be installed in the same way (again as the root user):

install -v -m644 tools/clang/docs/man/* /usr/share/man/man1 &&
install -v -d -m755 /usr/share/doc/llvm-6.0.1/clang-html    &&
cp -Rv tools/clang/docs/html/* /usr/share/doc/llvm-6.0.1/clang-html

コマンド説明

-DLLVM_ENABLE_FFI=ON: This switch enables LLVM to use libffi.

-DLLVM_BUILD_LLVM_DYLIB=ON: builds libraries as static and links all of them into an unique shared one. This is the recommended way of building a shared library.

-DCMAKE_BUILD_TYPE=Release: This switch enables compiler optimizations in order to speed up the code and reduce its size. It also disables some compile checks, not necessary on a production system.

-DLLVM_TARGETS_TO_BUILD="host;AMDGPU": This switch enables building for the same target as the host, and also for the r600 AMD GPU used by the Mesa r600 and radeonsi drivers. Default is all. You can use a semicolon separated list. Valid targets are: host, X86, Sparc, PowerPC, ARM, AArch64, Mips, Hexagon, Xcore, MSP430, NVPTX, SystemZ, AMDGPU, BPF, CppBackend, or all.

-DLLVM_LINK_LLVM_DYLIB=ON: Used in conjunction with -DLLVM_BUILD_LLVM_DYLIB=ON, this switch enables linking the tools against the shared library instead of the static ones. It also slightly reduces their size and also ensures that llvm-config will correctly use libLLVM-6.0.so.

-DBUILD_SHARED_LIBS=ON: if used instead of -DLLVM_BUILD_LLVM_DYLIB=ON and -DLLVM_LINK_LLVM_DYLIB=ON, builds all the LLVM libraries (about 60) as shared libraries instead of static.

-DLLVM_ENABLE_DOXYGEN: Enables the generation of browsable HTML documentation if you have installed Doxygen-1.8.14. You should run make doxygen-html afterwards, and install the generated documentation manually.

パッケージ構成

インストールプログラム: bugpoint, c-index-test, clang, clang++ (symlinks to clang-<version>), clang-<version>, clang-check, clang-cl, clang-cppi (last two symlinks to clang), clang-format, clang-import-test, clang-offload-bundler, clang-rename, git-clang-format, llc, lli, llvm-ar, llvm-as, llvm-bcanalyzer, llvm-cat, llvm-config, llvm-cov, llvm-c-test, llvm-cvtres, llvm-cxxdump, llvm-cxxfilt, llvm-diff, llvm-dis, llvm-dlltool (symlink to llvm-ar), llvm-dsymutil, llvm-dwarfdump, llvm-dwp, llvm-extract, llvm-lib (symlink to llvm-ar), llvm-link, llvm-lto, llvm-lto2, llvm-mc, llvm-mcmarkup, llvm-modextract, llvm-mt, llvm-nm, llvm-objdump, llvm-opt-report, llvm-pdbutil, llvm-profdata, llvm-ranlib (symlink to llvm-ar), llvm-readelf (symlink to llvm-readobj), llvm-readobj, llvm-rtdyld, llvm-size, llvm-split, llvm-stress, llvm-strings, llvm-symbolizer, llvm-tblgen, llvm-xray, obj2yaml, opt, sancov, sanstats, scan-build, scan-view, verify-uselistorder, yaml2obj
インストールライブラリ: BugpointPasses.so, LLVMHello.so, libLLVM.so, libLLVM*.a (63 libraries), libLTO.so, libclang.so, libclang*.a (25 libraries)
インストールディレクトリ: /usr/include/{clang,clang-c,llvm,llvm-c}, /usr/lib/{clang,cmake/{clang,llvm}}, /usr/share/{clang,opt-viewer,scan-build,scan-view}, /usr/share/doc/llvm-6.0.1}

概略説明

bugpoint

is the automatic test case reduction tool.

c-index-test

is used to test the libclang API and demonstrate its usage.

clang

is the Clang C, C++, and Objective-C compiler.

clang-check

is a tool to perform static code analysis and display Abstract Syntax Trees (AST).

clang-format

is a tool to format C/C++/Java/JavaScript/Objective-C/Protobuf code.

clang-offload-bundler

is a tool to bundle/unbundle openMP offloaded files associated with a common source file.

clang-rename

is a tool to rename symbols in C/C++ programs.

git-clang-format

runs clang-format on git generated patches (requires git-2.18.0)

llc

is the LLVM static compiler.

lli

is used to directly execute programs from LLVM bitcode.

llvm-ar

is the LLVM archiver.

llvm-as

is the LLVM assembler.

llvm-bcanalyzer

is the LLVM bitcode analyzer.

llvm-cat

is a tool to concatenate llvm modules.

llvm-config

Prints LLVM compilation options.

llvm-cov

is used to emit coverage information.

llvm-c-test

is a bytecode disassembler.

llvm-cvtres

is a tool to convert Microsoft resource files to COFF.

llvm-cxxdump

is used as a C++ ABI Data Dumper.

llvm-cxxfilt

is used to demangle C++ symbols in llvm code.

llvm-diff

is the LLVM structural 'diff'.

llvm-dis

is the LLVM disassembler.

llvm-dsymutil

is a tool used to manipulate archived DWARF debug symbol files, compatible with the Darwin command dsymutil.

llvm-dwarfdump

prints the content of DWARF sections in object files.

llvm-dwp

merges split DWARF files.

llvm-extract

is used to extract a function from an LLVM module.

llvm-link

is the LLVM linker.

llvm-lto

is the LLVM LTO (link time optimization) linker.

llvm-lto2

is a test harness for the resolution based LTO interface.

llvm-mc

is a standalone machine code assembler/disassembler.

llvm-mcmarkup

is a parser for machine code markup.

llvm-modextract

is a tool to extract one module from multimodule bitcode files.

llvm-mt

is a tool to generate signed files and catalogs from a side-by-side assembly manifest (used for Microsoft SDK).

llvm-nm

is used to list LLVM bitcode and object file's symbol table.

llvm-objdump

is an LLVM object file dumper.

llvm-opt-report

is a tool to generate an optimization report from YAML optimization record files.

llvm-pdbutil

is a PDB (Program Database) dumper. PDB is a Microsoft format.

llvm-profdata

is a small tool to manipulate and print profile data files.

llvm-ranlib

is used to generate an index for a LLVM archive.

llvm-readobj

displays low-level format-specific information about object files.

llvm-rtdyld

is the LLVM MC-JIT tool.

llvm-size

is the LLVM object size dumper.

llvm-split

is the LLVM module splitter.

llvm-stress

is used to generate random .ll files.

llvm-strings

print strings found in a binary (object file, executable, or archive library).

llvm-symbolizer

converts adresses into source code locations.

llvm-tblgen

is the LLVM Target Description To C++ Code Generator.

llvm-xray

is an implementation of Google's XRay function call tracing system.

obj2yaml

takes an object file, and produces a YAML representation of the file.

opt

is the LLVM optimizer.

sancov

is the sanitizer coverage processing tool.

sanstats

is the sanitizer statistics processing tool.

scan-build

is a Perl script that invokes the Clang static analyzer.

scan-view

is a viewer for Clang static analyzer results.

verify-uselistorder

is the LLVM tool to verify use-list order.

yaml2obj

takes a YAML representation of an object file and converts it to a binary file.

最終更新日: 2018-08-19 06:53:19 +0900