* ld.texinfo (--gc-sections): Describe linker behaviour.

This commit is contained in:
Alan Modra 2008-01-10 01:12:56 +00:00
parent 77a580f9ba
commit d5465ba2e1
2 changed files with 14 additions and 0 deletions

View File

@ -1,3 +1,7 @@
2008-01-10 Alan Modra <amodra@bigpond.net.au>
* ld.texinfo (--gc-sections): Describe linker behaviour.
For older changes see ChangeLog-2007
Local Variables:

View File

@ -1285,6 +1285,16 @@ with @samp{-r} or @samp{--emit-relocs}. The default behaviour (of not
performing this garbage collection) can be restored by specifying
@samp{--no-gc-sections} on the command line.
@samp{--gc-sections} decides which input sections are used by
examining symbols and relocations. The section containing the entry
symbol and all sections containing symbols undefined on the
command-line will be kept, as will sections containing symbols
referenced by dynamic objects. Note that when building shared
libraries, the linker must assume that any visible symbol is
referenced. Once this initial set of sections has been determined,
the linker recursively marks as used any section referenced by their
relocations. See @samp{--entry} and @samp{--undefined}.
@kindex --print-gc-sections
@kindex --no-print-gc-sections
@cindex garbage collection