[clang][docs] Document ThinLTO options for ld64.lld
authorJez Ng <jezng@fb.com>
Tue, 21 Feb 2023 15:32:07 +0000 (10:32 -0500)
committerJez Ng <jezng@fb.com>
Tue, 21 Feb 2023 17:09:27 +0000 (12:09 -0500)
The LTO-cache-related flags were added here: {D105922}

Reviewed By: tejohnson

Differential Revision: https://reviews.llvm.org/D144482

clang/docs/ThinLTO.rst

index 579a513..c042547 100644 (file)
@@ -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``