This is an archive of the discontinued LLVM Phabricator instance.

Differential D37995

[Docs] Document cache pruning support for gold
ClosedPublic

Authored by kongyi on Sep 18 2017, 1:43 PM.

Details

Reviewers
tejohnson
Commits
rGa026eb5f503d: [Docs] Document cache pruning support for gold
rC313591: [Docs] Document cache pruning support for gold
rL313591: [Docs] Document cache pruning support for gold
Summary

Feature implemented in https://reviews.llvm.org/D37993

Diff Detail

Repository
rL LLVM

Event Timeline

kongyi created this revision.Sep 18 2017, 1:43 PM
Herald added subscribers: eraman, mehdi_amini. · View Herald TranscriptSep 18 2017, 1:43 PM
tejohnson accepted this revision.Sep 18 2017, 4:21 PM

LGTM with one fix noted.

docs/ThinLTO.rst
144 ↗(On Diff #115710)

add gold to this list too.

This revision is now accepted and ready to land.Sep 18 2017, 4:21 PM
Closed by commit rL313591: [Docs] Document cache pruning support for gold (authored by kongyi). · Explain WhySep 18 2017, 4:25 PM
This revision was automatically updated to reflect the committed changes.

Revision Contents

PathSize
cfe/
trunk/
docs/
6 lines

Diff 115745

cfe/trunk/docs/ThinLTO.rst

Show First 20 Lines • Show All 135 Lines • ▼ Show 20 Lines- ELF lld (as of LLVM 5.0):
``-Wl,--thinlto-cache-dir=/path/to/cache`` ``-Wl,--thinlto-cache-dir=/path/to/cache``
- COFF lld-link (as of LLVM 6.0): - COFF lld-link (as of LLVM 6.0):
``/lldltocache:/path/to/cache`` ``/lldltocache:/path/to/cache``
Cache Pruning Cache Pruning
------------- -------------
To help keep the size of the cache under control, ThinLTO supports cache To help keep the size of the cache under control, ThinLTO supports cache
pruning. Cache pruning is supported with ld64 and ELF and COFF lld, but pruning. Cache pruning is supported with gold, ld64 and ELF and COFF lld, but
currently only ELF and COFF lld allow you to control the policy with a 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. 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): - ELF lld (as of LLVM 5.0):
``-Wl,--thinlto-cache-policy,POLICY`` ``-Wl,--thinlto-cache-policy,POLICY``
- COFF lld-link (as of LLVM 6.0): - COFF lld-link (as of LLVM 6.0):
``/lldltocachepolicy:POLICY`` ``/lldltocachepolicy:POLICY``
A policy string is a series of key-value pairs separated by ``:`` characters. A policy string is a series of key-value pairs separated by ``:`` characters.
Possible key-value pairs are: Possible key-value pairs are:
▲ Show 20 Lines • Show All 70 Lines • Show Last 20 Lines