diff options
Diffstat (limited to 'ld')
| -rw-r--r-- | ld/ld.texinfo | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/ld/ld.texinfo b/ld/ld.texinfo index 78d4580..f096c78 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -172,6 +172,7 @@ ld [ -o @var{output} ] @var{objfile}@dots{} [ -l@var{archive} ] [ -L@var{searchdir} ] [ -M ] [ -Map @var{mapfile} ] [ -m @var{emulation} ] [ -N | -n ] [ -noinhibit-exec ] [ -oformat @var{output-format} ] [ -R @var{filename} ] [ -relax ] + [ -retain-symbols-file @var{filename} ] [ -r | -Ur ] [ -S ] [ -s ] [ -sort-common ] [ -stats ] [ -T @var{commandfile} ] [ -Ttext @var{org} ] [ -Tdata @var{org} ] @@ -500,6 +501,25 @@ On platforms where this is not supported, @samp{-relax} is accepted, but ignored. @end ifset +@item -retain-symbols-file @var{filename} +@cindex retaining specified symbols +@cindex stripping all but some symbols +@cindex symbols, retaining selectively +Retain @emph{only} the symbols listed in the file @var{filename}, +discarding all others. @var{filename} is simply a flat file, with one +symbol name per line. This option is especially useful in environments +@ifset GENERIC +(such as VxWorks) +@end ifset +where a large global symbol table is accumulated gradually, to conserve +run-time memory. + +@samp{-retain-symbols-file} does @emph{not} discard undefined symbols, +or symbols needed for relocations. + +You may only specify @samp{-retain-symbols-file} once in the command +line. It overrides @samp{-s} and @samp{-S}. + @item -r @cindex partial link @cindex relocatable output |