aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2019-11-22 13:24:58 +0000
committerNick Clifton <nickc@redhat.com>2019-11-22 13:24:58 +0000
commita2e098c378a96e7d7760aa52c1b49680c67674be (patch)
tree34d27ed568f303842a44bfcb7a272393b7ef8532
parentb72636deaf8eaf4d31ab9e7cb1047c92fe458172 (diff)
downloadgdb-a2e098c378a96e7d7760aa52c1b49680c67674be.zip
gdb-a2e098c378a96e7d7760aa52c1b49680c67674be.tar.gz
gdb-a2e098c378a96e7d7760aa52c1b49680c67674be.tar.bz2
Update the linker documentation regarding the /DISCARD/ linker script section and its interaction with ELF section groups.
* ld.texi (Output Section Discarding): Add note indicating that /DISCARD/ed sections ignore ELF section grouping.
-rw-r--r--ld/ChangeLog5
-rw-r--r--ld/ld.texi5
2 files changed, 10 insertions, 0 deletions
diff --git a/ld/ChangeLog b/ld/ChangeLog
index 43d858b..6498fb0 100644
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,5 +1,10 @@
2019-11-22 Nick Clifton <nickc@redhat.com>
+ * ld.texi (Output Section Discarding): Add note indicating that
+ /DISCARD/ed sections ignore ELF section grouping.
+
+2019-11-22 Nick Clifton <nickc@redhat.com>
+
* ldlang.h (LANG_FOR_EACH_INPUT_STATEMENT): Use cast instead of
extra check.
diff --git a/ld/ld.texi b/ld/ld.texi
index 3b2d054..ed538fb 100644
--- a/ld/ld.texi
+++ b/ld/ld.texi
@@ -4994,6 +4994,11 @@ The special output section name @samp{/DISCARD/} may be used to discard
input sections. Any input sections which are assigned to an output
section named @samp{/DISCARD/} are not included in the output file.
+Note, sections that match the @samp{/DISCARD/} output section will be
+discarded even if they are in an ELF section group which has other
+members which are not being discarded. This is deliberate.
+Discarding takes precedence over grouping.
+
@node Output Section Attributes
@subsection Output Section Attributes
@cindex output section attributes