LLVM 3.9/4.0 安装笔记 (Debian / Ubuntu)

目录

  • 安装/升级cmake
  • 安装Ninja
  • 安装libffi和Python2.7.13
  • 安装Clang和LLVM (源码编译)
  • 安装plugin

安装/升级cmake

根据LLVM官网,编译LLVM和Clang需要CMake 3.4.3以上 (2017年2月):

LLVM requires CMake 3.4.3 to build. It is generally recommended to use a recent CMake, especially if you’re generating Ninja build files. This is because the CMake project is constantly improving the quality of the generators, and the Ninja generator gets a lot of attention.

这段话告诉我们两件事情:一是用新版的cmake是一个比较稳妥的选择,二是用于编译LLVM的cmake的generator的选择上,可能Ninja是一个比较好的选择。

在Ubuntu 14.04.5上如果用apt-get来安装cmake的话,会得到一个版本为2.8的cmake,这不是我们想要的版本,所以这里使用源码安装。

cmake的版本可以使用cmake --version来检查。如果要卸载apt-get安装的cmake,我们可以sudo apt-get remove cmake

cmake.org/download/提供了源码文件,也提供了一个安装脚本(cmake-3.7.2-Linux-x86_64.sh)。这里我直接使用这个脚本了。运行前,还是需要改一下权限 chmod +x /path/to/cmake-3.7.2-Linux-x86_64.sh。然后运行即可。进入了more以后直接按q可以结束阅读用户协议。

最后一步就是将生成的cmake的binary文件引入系统path里了。比如你的cmake-3.7.2-Linux-x86_64文件夹位于/path/to/cmake-3.7.2-Linux-x86_64,直接做一个link就可以了:sudo ln -s /path/to/cmake-3.7.2-Linux-x86_64/bin/* /usr/local/bin。 (这里你可能也要检查一下/usr/localbin在不在系统的$PATH环境变量里)

安装Ninja

Ninja是一个build工具,跟unix的make是统一范畴。参照Ninja的文档,在Debian/Ubuntu里执行

apt-get install ninja-build

就可以了。使用Ninja与否是Optional的,不过我个人觉得在安装LLVM时,Ninja的确是比Make要快一点的。

安装libffi和Python2.7.13

libffi和Python2.7.13在安装LLVM时也是可选的。libffi是什么呢?参看一下它的介绍:

The libffi library provides a portable, high level programming interface to various calling conventions. This allows a programmer to call any function specified by a call interface description at run time.

安装了libffi,则可以在使用cmake时开启DLLVM_ENABLE_FFI选项了,也就是-DLLVM_ENABLE_FFI=ON

从ftp://sourceware.org/pub/libffi/libffi-3.2.1.tar.gz下载libffi的源码,然后执行

sed -e '/^includesdir/ s/$(libdir).*$/$(includedir)/' \
    -i include/Makefile.in &&

sed -e '/^includedir/ s/=.*$/=@includedir@/' \
    -e 's/^Cflags: -I${includedir}/Cflags:/' \
    -i libffi.pc.in        &&

./configure --prefix=/usr --disable-static &&
make

最后sudo su以后make install安装好就可以了。

至于Python2.7.13, 安装便十分直白,先下载源码

wget https://www.python.org/ftp/python/2.7.13/Python-2.7.13.tgz

然后解压,编译和安装即可

tar xzf Python-2.7.13.tgz
cd Python-2.7.13
sudo ./configure
sudo make install

安装Clang和LLVM (源码编译)

LLVM和Clang等的源码可以从releases.llvm.org获得。如果要获得最新的代码,则需要使用svn来下载。

如果使用svn,则参照LLVM官网操作即可,假设你打算安装LLVM在/path/to/llvm-src

LLVM:

cd /path/to/llvm-src
svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm

Clang:

cd /path/to/llvm-src
cd llvm/tools
svn co http://llvm.org/svn/llvm-project/cfe/trunk clang

LLD linker [可选]:

cd /path/to/llvm-src
cd llvm/tools
svn co http://llvm.org/svn/llvm-project/lld/trunk lld

Compiler-RT (required to build the sanitizers) [可选]:

cd /path/to/llvm-src
cd llvm/projects
svn co http://llvm.org/svn/llvm-project/compiler-rt/trunk compiler-rt

如果我们下载源码(例如最新版已经是4.0.0,而我们仍想安装3.9.1),则可以直接下载:

  • http://llvm.org/releases/3.9.1/llvm-3.9.1.src.tar.xz LLVM
  • http://llvm.org/releases/3.9.1/cfe-3.9.1.src.tar.xz Clang
  • http://llvm.org/releases/3.9.1/compiler-rt-3.9.1.src.tar.xz Compiler RT

假设llvm解压出的文件夹叫做llvm-3.9.1.src,则:

cd /path/to/llvm-3.9.1.src    

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

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

LLVM3.7.0以后就不再允许源码内编译了(build inside source-tree),所以我们需要在llvm-3.9.1.src外面另外建一个文件夹,比如叫做llvm-build

mkdir llvm-build
cd llvm-build

接下来则要使用cmake来进行编译,如果安装了Ninja,llvm源码文件夹是llvm-3.9.1.src。一个实例是:

cmake -G Ninja  \
  -DCMAKE_INSTALL_PREFIX=/usr  \
  -DCMAKE_BUILD_TYPE=Release \
  -DLLVM_ENABLE_FFI=ON \
  -DLLVM_BUILD_LLVM_DYLIB=ON \
  -DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
  -DLLVM_TARGETS_TO_BUILD="host" 
  -Wno-dev
  ../llvm-3.9.1.src

这里要注意一下一些主要的参数,-G是选择generator,如果安装了Ninja则会生成Ninja的build文件。-DCMAKE_INSTALL_PREFIX是表明了最后要安装到了目录,-DCMAKE_BUILD_TYPE则是表明build类型,如果选择Debug则会安装很多不需要的文件,-DLLVM_ENABLE_FFI则是开启FFI,-DLLVM_TARGETS_TO_BUILD是指明build的target,如果只选host,则只build针对当前平台的内容,免去了不少多余文件。最后一行的../llvm-3.9.1.src则是告诉cmake源码文件的位置。

在这之后,直接进行ninja的操作即可。Ninja的使用方式类似于make,比如开4核使用ninja -j4,清除build的文件则ninja clean

如果不使用Ninja,还是使用make来build,则cmake选择cmake -G "Unix Makefiles"即可。

在虚拟机中编译LLVM 3.9.1,需要开足够的内存(比如我个人建议6个G)和足够的硬盘(用动态分配吧)。如果用了ninja -j2以上,有可能会在编译一些文件时崩掉,这时候只是使用ninja即可。(make也是一样)

最后运行ninja install或者make install即完成安装。之后可以用clang --versionllc --version检查安装成功的版本。llc是LLVM static compiler,当然我们也可以通过其它的LLVM组件来检查,比如用dissembler: llvm-dis --version

安装plugin

这里我以LLVM Gold Plugin为例。因为我这次安装LLVM的最终目的,是需要运行和编辑这个instrumentation工具Contech,它是需要Gold Plugin的。

它的安装本身,只需要执行以下操作即可:

git clone --depth 1 git://sourceware.org/git/binutils-gdb.git binutils
mkdir build # 源码树外build
cd build
../binutils/configure --enable-gold --enable-plugins --disable-werror
make all-gold

接下来build LLVM,我使用的cmake指令:

CC=gcc CXX=g++                              \
cmake -G Ninja \
      -DCMAKE_INSTALL_PREFIX=/usr           \
      -DLLVM_ENABLE_FFI=ON                  \
      -DCMAKE_BUILD_TYPE=RelWithDebInfo -DLLVM_ENABLE_CXX1Y=ON          \
      -DLLVM_BUILD_LLVM_DYLIB=ON            \
      -DLLVM_TARGETS_TO_BUILD="host" \
      -DLLVM_BINUTILS_INCDIR=/path/to/gold/binutils/include \
      -Wno-dev --enable-optimized --enable-targets=host-only \
      ../llvm-3.9.1.src

这里要注意的是-DLLVM_BINUTILS_INCDIR=/path/to/gold/binutils/include,这里是指明了binutils (gold plugin)提供的include文件的位置。

你可能感兴趣的:(LLVM 3.9/4.0 安装笔记 (Debian / Ubuntu))