From: Peter Collingbourne Date: Fri, 23 Jun 2017 17:05:03 +0000 (+0000) Subject: Add a ThinLTO cache policy for controlling the maximum cache size in bytes. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=99621ffe51bf9d86beef725bbbadfaf1507ecff1;p=clang Add a ThinLTO cache policy for controlling the maximum cache size in bytes. This is useful when an upper limit on the cache size needs to be controlled independently of the amount of the amount of free space. One use case is a machine with a large number of cache directories (e.g. a buildbot slave hosting a large number of independent build jobs). By imposing an upper size limit on each cache directory, users can more easily estimate the server's capacity. Differential Revision: https://reviews.llvm.org/D34547 git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@306126 91177308-0d34-0410-b5e6-96231b3b80d8 --- diff --git a/docs/ThinLTO.rst b/docs/ThinLTO.rst index 71a23380ef..31fff51a61 100644 --- a/docs/ThinLTO.rst +++ b/docs/ThinLTO.rst @@ -146,6 +146,18 @@ Possible key-value pairs are: disk space. A value over 100 is invalid. A value of 0 disables the percentage size-based pruning. The default is 75%. +- ``cache_size_bytes=X``, ``cache_size_bytes=Xk``, ``cache_size_bytes=Xm``, + ``cache_size_bytes=Xg``: + Sets the maximum size for the cache directory to ``X`` bytes (or KB, MB, + GB respectively). A value over the amount of available space on the disk + will be reduced to the amount of available space. A value of 0 disables + the byte size-based pruning. The default is no byte size-based pruning. + + Note that ThinLTO will apply both size-based pruning policies simultaneously, + and changing one does not affect the other. For example, a policy of + ``cache_size_bytes=1g`` on its own will cause both the 1GB and default 75% + policies to be applied unless the default ``cache_size`` is overridden. + - ``prune_after=Xs``, ``prune_after=Xm``, ``prune_after=Xh``: Sets the expiration time for cache files to ``X`` seconds (or minutes, hours respectively). When a file hasn't been accessed for ``prune_after`` seconds,