From: Nick Clifton <nickc@redhat.com>
To: binutils@sourceware.org
Subject: Commit: Add missing linker command line options to linker documentation
Date: Mon, 10 Apr 2017 14:56:00 -0000 [thread overview]
Message-ID: <87fuhgz4yb.fsf@redhat.com> (raw)
Hi Guys,
I am applying the patch below to add some documentation for a few
linker command line options which appear to have slipped through the
gaps.
Cheers
Nick
2017-04-10 Nick Clifton <nickc@redhat.com>
* ld.texinfo (--strip-discarded): Document.
(--embedded-relocs): Document.
(--spare-dynamic-tags): Document.
(--task-link): Document.
diff --git a/ld/ld.texinfo b/ld/ld.texinfo
index 769725d..909342c 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
reply other threads:[~2017-04-10 14:56 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87fuhgz4yb.fsf@redhat.com \
--to=nickc@redhat.com \
--cc=binutils@sourceware.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).