[clang] b0bf3e6 - [clang][docs] Document ThinLTO options for ld64.lld
Jez Ng via cfe-commits
cfe-commits at lists.llvm.org
Tue Feb 21 09:09:37 PST 2023
Author: Jez Ng
Date: 2023-02-21T12:09:27-05:00
New Revision: b0bf3e66d0878099ceebd916645c4cee320116cb
URL: https://github.com/llvm/llvm-project/commit/b0bf3e66d0878099ceebd916645c4cee320116cb
DIFF: https://github.com/llvm/llvm-project/commit/b0bf3e66d0878099ceebd916645c4cee320116cb.diff
LOG: [clang][docs] Document ThinLTO options for ld64.lld
The LTO-cache-related flags were added here: {D105922}
Reviewed By: tejohnson
Differential Revision: https://reviews.llvm.org/D144482
Added:
Modified:
clang/docs/ThinLTO.rst
Removed:
################################################################################
diff --git a/clang/docs/ThinLTO.rst b/clang/docs/ThinLTO.rst
index 579a513f952b2..c042547678919 100644
--- a/clang/docs/ThinLTO.rst
+++ b/clang/docs/ThinLTO.rst
@@ -118,7 +118,7 @@ be reduced to ``N`` via:
``-Wl,-plugin-opt,jobs=N``
- ld64:
``-Wl,-mllvm,-threads=N``
-- lld:
+- ld.lld, ld64.lld:
``-Wl,--thinlto-jobs=N``
- lld-link:
``/opt:lldltojobs=N``
@@ -141,9 +141,10 @@ which currently must be enabled through a linker option.
- gold (as of LLVM 4.0):
``-Wl,-plugin-opt,cache-dir=/path/to/cache``
-- ld64 (support in clang 3.9 and Xcode 8):
+- ld64 (supported since clang 3.9 and Xcode 8) and Mach-O ld64.lld (as of LLVM
+ 15.0):
``-Wl,-cache_path_lto,/path/to/cache``
-- ELF lld (as of LLVM 5.0):
+- ELF ld.lld (as of LLVM 5.0):
``-Wl,--thinlto-cache-dir=/path/to/cache``
- COFF lld-link (as of LLVM 6.0):
``/lldltocache:/path/to/cache``
@@ -152,14 +153,14 @@ Cache Pruning
-------------
To help keep the size of the cache under control, ThinLTO supports cache
-pruning. Cache pruning is supported with gold, ld64 and ELF and COFF lld, but
-currently only gold, ELF and COFF lld allow you to control the policy with a
-policy string. The cache policy must be specified with a linker option.
+pruning. Cache pruning is supported with gold, ld64, and lld, but currently only
+gold and lld allow you to control the policy with a policy string. The cache
+policy must be specified with a linker option.
- gold (as of LLVM 6.0):
``-Wl,-plugin-opt,cache-policy=POLICY``
-- ELF lld (as of LLVM 5.0):
- ``-Wl,--thinlto-cache-policy,POLICY``
+- ELF ld.lld (as of LLVM 5.0), Mach-O ld64.lld (as of LLVM 15.0):
+ ``-Wl,--thinlto-cache-policy=POLICY``
- COFF lld-link (as of LLVM 6.0):
``/lldltocachepolicy:POLICY``
More information about the cfe-commits
mailing list