From: Nick Clifton <nickc@redhat.com>
Date: Mon, 27 Oct 2025 15:21:04 +0000 (+0000)
Subject: Add more details to the linker documentation for the --hash-size and --max-cache... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a408215722e78583c29b958ce3bae53c21b20137;p=thirdparty%2Fbinutils-gdb.git

Add more details to the linker documentation for the --hash-size and --max-cache-size options
---

diff --git a/ld/ld.texi b/ld/ld.texi
index cf750d15259..f76887f1b1d 100644
--- a/ld/ld.texi
+++ b/ld/ld.texi
@@ -3270,6 +3270,8 @@ close to @var{number}.  Increasing this value can reduce the length of
 time it takes the linker to perform its tasks, at the expense of
 increasing the linker's memory requirements.  Similarly reducing this
 value can reduce the memory requirements at the expense of speed.
+The default value is 4051 under normal circumstances and 1021 if the
+@option{--reduce-memory-overheads} command line option is used.
 
 @kindex --hash-style=@var{style}
 @item --hash-style=@var{style}
@@ -3335,7 +3337,10 @@ enable other tradeoffs in future versions of the linker.
 @item --max-cache-size=@var{size}
 @command{ld} normally caches the relocation information and symbol tables
 of input files in memory with the unlimited size.  This option sets the
-maximum cache size to @var{size}.
+maximum cache size to @var{size}.  Note - if the
+@option{--no-keep-memory} command line option has been used then the
+linker acts as if the maximum cache size has been set to 0 - ie
+nothing is retained.
 
 @kindex --build-id
 @kindex --build-id=@var{style}