From b2544fb9c5b38339572d50048563e8b6e72bf0ad Mon Sep 17 00:00:00 2001 From: Chris Bieneman Date: Mon, 25 Oct 2021 18:44:46 +0530 Subject: [PATCH] Document `LLVM_USE_SPLIT_DWARF` option This patch adds a documentation note about the LLVM_USE_SPLIT_DWARF CMake option which is useful to reduce linker memory usage. --- llvm/docs/CMake.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/llvm/docs/CMake.rst b/llvm/docs/CMake.rst index 08f6815..658484f 100644 --- a/llvm/docs/CMake.rst +++ b/llvm/docs/CMake.rst @@ -729,6 +729,12 @@ enabled sub-projects. Nearly all of these variable names begin with are ``Address``, ``Memory``, ``MemoryWithOrigins``, ``Undefined``, ``Thread``, ``DataFlow``, and ``Address;Undefined``. Defaults to empty string. +**LLVM_USE_SPLIT_DWARF**:BOOL + If enabled CMake will pass ``-gsplit-dwarf`` to the compiler. This option + reduces link-time memory usage by reducing the amount of debug information that + the linker needs to resolve. It is recommended for platforms using the ELF object + format, like Linux systems when linker memory usage is too high. + **SPHINX_EXECUTABLE**:STRING The path to the ``sphinx-build`` executable detected by CMake. For installation instructions, see -- 2.7.4