LLDB调试器

`mkdir build` cd build

$`cmake -DCMAKE_BUILD_TYPE=Debug ../llvm
\end{shell}

该命令需要指定构建类型（例如，Debug）以及指向包含构建配置文件文件夹的主参数。配置文件存储为CMakeLists.txt，位于llvm文件夹中，这解释了为什么使用../llvm参数。该命令在构建文件夹中生成了Makefile，因此可以使用的make命令来启动构建过程。

本书中，我们将使用更高级的配置命令：

\begin{shell}
cmake -G Ninja
-DCMAKE_BUILD_TYPE=Debug
-DCMAKE_INSTALL_PREFIX=../install
-DLLVM_TARGETS_TO_BUILD="X86"
-DLLVM_ENABLE_PROJECTS="lldb;clang;clang-tools-extra"
-DLLVM_USE_SPLIT_DWARF=ON
../llvm
\end{shell}

\begin{center}
图 1.4: 基本CMake配置
\end{center}

该命令中指定了一些LLVM/cmake选项：

\begin{itemize}
\item
\textbf{-G Ninja}指定了Ninja作为构建生成器，否则将使用make（这会较慢）。

\item
\textbf{-DCMAKE_BUILD_TYPE=Debug} 置了构建模式，将创建带有调试信息的构建。这是对Clang内部调查的主要构建配置。

\item
\textbf{-DCMAKE_INSTALL_PREFIX=../install} 指定了安装文件夹。

\item
\textbf{-DLLVM_TARGETS_TO_BUILD="X86"} 设置了要构建的确切目标，将避免构建不必要的目标。

\item
\textbf{-DLLVM_ENABLE_PROJECTS="lldb;clang;clang-tools-extra"} 指定了想要构建的LLVM项目。

\item
\textbf{-DLLVM_USE_SPLIT_DWARF=ON} 将调试信息分割成单独的文件。这个选项可以节省磁盘空间，以及LLVM构建过程中的内存消耗。
\end{itemize}

我们使用了-DLLVM_USE_SPLIT_DWARF=ON来节省一些磁盘空间。例如，启用该选项的Clang构建（ninja clang build命令）占用了20 GB的空间，但禁用该选项时则占用了27 GB的空间，该选项需要编译器支持。我们为特定架构创建了构建：X86。这个选项也节省了一些空间；否则，所有支持的架构都将构建，所需的磁盘空间也将从20GB增加到27GB。

\begin{myNotic}{重要提示}
如果您的主平台与X86不同，例如ARM，可能希望避免使用-DLLVM_TARGETS_TO_BUILD="X86"设置。对于ARM，可以使用以下配置：-DLLVM_TARGETS_TO_BUILD="ARM;X86;AArch64" \footnote{LLVM社区. 在ARM上构建. 2024. URL \url{https://llvm.org/docs/HowToBuildOnARM.html}}。截至2023年3月，支持的完整平台列表可以在\footnote{LLVM社区. 使用CMake构建LLVM. 2023. URL \url{https://llvm.org/docs/CMake.html}}中找到，包括19个不同的目标。
\end{myNotic}

也可以使用默认设置，而不指定LLVM_TARGETS_TO_BUILD配置设置。准备好应对构建时间和使用空间的增长。

如果使用动态库，可以节省更多空间。配置设置-DBUILD_SHARED_LIBS=ON将每个LLVM组件构建为动态库。空间使用将减少到14 GB。

\begin{shell}
cmake -G Ninja
-DCMAKE_BUILD_TYPE=Debug
-DCMAKE_INSTALL_PREFIX=../install
-DLLVM_TARGETS_TO_BUILD="X86"
-DLLVM_ENABLE_PROJECTS="lldb;clang;clang-tools-extra"
-DLLVM_USE_SPLIT_DWARF=ON
-DBUILD_SHARED_LIBS=ON
../llvm
\end{shell}

\begin{center}
图 1.5: 启用动态库的CMake配置
\end{center}

出于性能考虑，在Linux上，可能希望使用gold链接器而不是默认链接器。gold链接器是GNU二进制工具包（binutils）的一部分，是一种GNU链接器的替代品。它设计得比GNU链接器更快、更高效，尤其是在链接大型项目时。通过使用更有效的符号解析算法，使的执行文件格式更紧凑。可以使用-DLLVM_USE_LINKER=gold选项启用：

\begin{shell}
cmake -G Ninja
-DCMAKE_BUILD_TYPE=Debug
-DCMAKE_INSTALL_PREFIX=../install
-DLLVM_TARGETS_TO_BUILD="X86"
-DLLVM_ENABLE_PROJECTS="lldb;clang;clang-tools-extra"
-DLLVM_USE_LINKER=gold
-DLLVM_USE_SPLIT_DWARF=ON
-DBUILD_SHARED_LIBS=ON
../llvm
\end{shell}

\begin{center}
图 1.6: 使用gold链接器的CMake配置
\end{center}

调试构建可能会非常慢，因此需要考虑其他替代方案。在可调试性和性能之间取得良好平衡的折衷方案是带有调试信息的发布构建。要获得这种构建，可以将CMAKE_BUILD_TYPE标志更改为整体配置命令中的RelWithDebInfo：

\begin{shell}
cmake -G Ninja
-DCMAKE_BUILD_TYPE=RelWithDebInfo
-DCMAKE_INSTALL_PREFIX=../install
-DLLVM_TARGETS_TO_BUILD="X86"
-DLLVM_ENABLE_PROJECTS="lldb;clang;clang-tools-extra"
-DLLVM_USE_SPLIT_DWARF=ON
../llvm
\end{shell}

\begin{center}
图 1.7: 使用RelWithDebInfo构建类型的CMake配置
\end{center}

以下表格列出了一些主要的选项(\url{https://llvm.org/docs/CMake.html})。

% Please add the following required packages to your document preamble:
% \usepackage{longtable}
% Note: It may be necessary to compile the document several times to get a multi-page table to line up properly
\begin{longtable}{|l|l|}
\hline
\textbf{选项} & \textbf{描述} \ \hline
\endfirsthead
%
\endhead
%
CMAKE_BUILD_TYPE &
\begin{tabular}[c]{@{}l@{}}指定构建配置。\ 可能的值是Release|Debug|RelWithDebInfo|MinSizeRel。\ Release和RelWithDebInfo针对性能进行了优化，而\MinSizeRel针对大小进行了优化。
\end{tabular} \ \hline
CMAKE_INSTALL_PREFIX & 安装文件夹 \ \hline
CMAKE_C,CXX_FLAGS & 编译时使用的C/C++标志 \ \hline
CMAKE_C,CXX_COMPILER &
\begin{tabular}[c]{@{}l@{}}用于编译的C/C++编译器。\ 可能需要指定一个非默认编译器，以便使用默认编译器不可用或\不支持的一些选项。
\end{tabular} \ \hline
LLVM_ENABLE_PROJECTS & 要启用的项目。(我们将使用clang;clang-tools-extra)
\ \hline
LLVM_USE_LINKER &
\begin{tabular}[c]{@{}l@{}}指定要使用的链接器。 有几种选项，包括gold和lld。
\end{tabular} \ \hline
\end{longtable}

\begin{center}
表1.1: 配置选项
\end{center}

\mySubsubsection{1.3.2.}{构建}

需要调用Ninja来构建项目。如果想要构建所有指定的项目，可以不带参数运行Ninja：

\begin{shell}`$ ninja

$`ninja clang
\end{shell}

还可以使用以下命令运行编译器的单元测试和端到端测试：

\begin{shell}`$ ninja check-clang

$`ninja install
\end{shell}

../install文件夹（图1.4中作为安装文件夹指定）将具有以下结构：

\begin{shell}`$ ls ../install bin include lib libexec share

`cd llvm-project` mkdir release $`cd release
\end{shell}

\begin{center}
图 1.8: LLVM的发布构建
\end{center}

在发布模式下配置项目，并只指定lldb和clang项目：

\begin{shell}
cmake -G Ninja
-DCMAKE_BUILD_TYPE=Release
-DCMAKE_INSTALL_PREFIX=../install
-DLLVM_TARGETS_TO_BUILD="X86"
-DLLVM_ENABLE_PROJECTS="lldb;clang"
../llvm
\end{shell}

\begin{center}
图 1.9: 使用发布构建类型的CMake配置
\end{center}

使用系统中可用的最大线程数来构建Clang和LLDB：

\begin{shell}$ ninja clang lldb -j $(nproc)
\end{shell}

可以使用以下命令安装创建的可执行文件：

\begin{shell}`$ ninja install-clang install-lldb