From a70f34c01c7f250858bd62df245c241263200f63 Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Mon, 10 Apr 2017 15:56:55 +0100 Subject: [PATCH] Document undocumented linker command line options. ld * ld.texinfo (--strip-discarded): Document. (--embedded-relocs): Document. (--spare-dynamic-tags): Document. (--task-link): Document. --- ld/ChangeLog | 7 +++++++ ld/ld.texinfo | 25 +++++++++++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/ld/ChangeLog b/ld/ChangeLog index 4dcfd8136c1..bc3120252d2 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,3 +1,10 @@ +2017-04-10 Nick Clifton + + * ld.texinfo (--strip-discarded): Document. + (--embedded-relocs): Document. + (--spare-dynamic-tags): Document. + (--task-link): Document. + 2017-04-10 Alan Modra PR 21287 diff --git a/ld/ld.texinfo b/ld/ld.texinfo index 769725d28ed..909342c7d1c 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -943,6 +943,13 @@ Omit all symbol information from the output file. @itemx --strip-debug Omit debugger symbol information (but not all symbols) from the output file. +@kindex --strip-discarded +@kindex --no-strip-discarded +@item --strip-discarded +@itemx --no-strip-discarded +Omit (or do not omit) global symbols defined in discarded sections. +Enabled by default. + @kindex -t @kindex --trace @cindex input files, displaying @@ -1518,6 +1525,13 @@ linker to be used at load-time. This is only meaningful for ELF executables that contain dynamic relocations, and usually requires entry point code that is capable of processing these relocations. +@kindex --embedded-relocs +@item --embedded-relocs +This option is similar to the @option{--emit-relocs} option except +that the relocs are stored in a target specific section. This option +is only supported by the @samp{BFIN}, @samp{CR16} and @emph{M68K} +targets. + @kindex --fatal-warnings @kindex --no-fatal-warnings @item --fatal-warnings @@ -1979,6 +1993,12 @@ patterns in the linker script. This option will apply @code{SORT_BY_ALIGNMENT} to all wildcard section patterns in the linker script. +@kindex --spare-dynamic-tags +@item --spare-dynamic-tags=@var{count} +This option specifies the number of empty slots to leave in the +.dynamic section of ELF shared objects. Empty slots may be needed by +post processing tools, such as the prelinker. The default is 5. + @kindex --split-by-file @item --split-by-file[=@var{size}] Similar to @option{--split-by-reloc} but creates a new output section for @@ -2009,6 +2029,11 @@ Use @var{directory} as the location of the sysroot, overriding the configure-time default. This option is only supported by linkers that were configured using @option{--with-sysroot}. +@kindex --task-link +@item --task-link +This is used by COFF/PE based targets to create a task-linked object +file where all of the global symbols have been converted to statics. + @kindex --traditional-format @cindex traditional format @item --traditional-format -- 2.30.2