From: Roland Pesch <pesch@cygnus>
Date: Thu, 3 Feb 1994 04:18:11 +0000 (+0000)
Subject: Describe -retain-symbols-file.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=7c8fab26c8aa8bb1ddda9b245371379177e6769e;p=binutils-gdb.git

Describe -retain-symbols-file.
---

diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index 78d4580a3a3..f096c78ea17 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