Getting Started with the LLVM System

Overview

欢迎到LLVM！为了开始，你首先需要知道一些基本的信息。

首先，LLVM有三部分。第一部分是LLVM套件。这部分包含了使用LLVM所包含的所有工具，库和头文件。它包含汇编，反汇编，位码分析器和位码优化器。他也包含了基本的回归测试，可以用来测试LLVM工具和Clang前端。

第二部分是Clang前端。此组件是把C,C++,C.obj，C++.obj编译成LLVM位码。一旦被编译成LLVM位码，程序就可以呗LLVM套件中的工具熟练控制。

第三部分是一个可选的部分叫做测试套件。这是一套测试用的，可以用来进一步验证LLVM的功能和性能的程序。

Getting Started Quickly (A Summary)

LLVM Getting Started 文档可能已经过时了，所以Clang Getting Started 也是一个开始的好地方。

下面是快速搭建和运行LLVM的方法：

1.阅读文档

2.阅读文档

3.记住，我警告过你了两次阅读文档

4.检验LLVM:

• cd where-you-want-llvm-to-live

• svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm

5.检验Clang：

• cd where-you-want-llvm-to-live

• cd llvm/tools

• svn co http://llvm.org/svn/llvm-project/cfe/trunk clang

6.检验 Compiler-RT：

• cd where-you-want-llvm-to-live

• cd llvm/projects

• svn co http://llvm.org/svn/llvm-project/compiler-rt/trunk compiler-rt

7.获得测试套件源码包（可选） 

• cd where-you-want-llvm-to-live

• cd llvm/projects

• svn co http://llvm.org/svn/llvm-project/test-suite/trunk test-suite

8.配置和编译LLVM和Clang

1. mkdir创建编译目录（不污染源目录）
2. cd到编译目录
3. ../ LLVM /配置[选项]一些常用选项：
   --prefix=目录——指定目录的完整路径名你想要的LLVM工具和库（默认的要安装在/usr/local）。
   --enable-optimized—— 使优化编译器优化选项（默认是不启用）。
   --enable-assertions——启用断言检查编译断言启用（默认是的是的）。
4. make[-j]——-J 指定数量的工作（命令）同时运行。这建立两个LLVM和Clang调试+资产模式。--enable-optimized——使优化配置选项用于指定一个发布版本。
5. make check-all 这使检查所有运行回归测试，以确保一切正常。
6. make update要更新此命令是用来更新

它也可以使用CMake代替Makefiles。使用CMake有可能产生几个IDE项目文件：Xcode, Eclipse CDT4, CodeBlocks, Qt-Creator （用codeblocks发生器）KDevelop3  

如果你得到一个“内部编译器错误（ICE）”或测试失败，见下文。

在配置和编译LLVM之前，应该翻阅 Getting Started with LLVM中的详细信息。

查看 Setting Up Your Environment的一些提示，可是使你更简单的运用Clang前端和LLVM工具

去  Program Layout 了解源代码树的布局。

Requirements

在您开始使用LLVM系统，综述如下要求。提前知道你需要什么硬件和软件可以减少遇到的麻烦。

硬件：

软件：GNU Make 、GCC、TeXinfo、SVN、python、perl、GNU M4、GNU Autoconf、GNU Automake、libtool 、zlib