Note that the linker's --compress-debug-sections option overrides the compression...
authorNick Clifton <nickc@redhat.com>
Mon, 7 Nov 2016 12:28:16 +0000 (12:28 +0000)
committerNick Clifton <nickc@redhat.com>
Mon, 7 Nov 2016 12:28:16 +0000 (12:28 +0000)
* ld.texinfo (--compress-debug-sections): Expand documentation of
this option.

ld/ChangeLog
ld/ld.texinfo

index 0513d2e1a60b237ce33298f730f561fa1658da4a..ae6d7320521b1bc5f218b585a5fa078d365e856e 100644 (file)
@@ -1,3 +1,8 @@
+2016-11-07  Nick Clifton  <nickc@redhat.com>
+
+       * ld.texinfo (--compress-debug-sections): Expand documentation of
+       this option.
+
 2016-11-04  Nick Clifton  <nickc@redhat.com>
 
        * emultempl/elf32.em (search_needed): Remove use of getauxval and
index 500fda6d7644d5d4d2038c7d5040411b157e0ab4..698d3664fef7a8f66765f5be2d860d57d219f273 100644 (file)
@@ -2319,17 +2319,28 @@ hash tables.  The default is @code{sysv}.
 @itemx --compress-debug-sections=zlib
 @itemx --compress-debug-sections=zlib-gnu
 @itemx --compress-debug-sections=zlib-gabi
-On ELF platforms , these options control how DWARF debug sections are
-compressed using zlib.  @option{--compress-debug-sections=none} doesn't
-compress DWARF debug sections.
-@option{--compress-debug-sections=zlib-gnu} compresses DWARF debug
-sections and rename debug section names to begin with @samp{.zdebug}
-instead of @samp{.debug}.  @option{--compress-debug-sections=zlib}
-and @option{--compress-debug-sections=zlib-gabi}
-compress DWARF debug sections with SHF_COMPRESSED from the ELF ABI.
-The default behaviour varies depending upon the target involved and
-the configure options used to build the toolchain.  The default can be
-determined by examing the output from the linker's @option{--help} option.
+On ELF platforms, these options control how DWARF debug sections are
+compressed using zlib.
+
+@option{--compress-debug-sections=none} doesn't compress DWARF debug
+sections.  @option{--compress-debug-sections=zlib-gnu} compresses
+DWARF debug sections and renames them to begin with @samp{.zdebug}
+instead of @samp{.debug}.  @option{--compress-debug-sections=zlib-gabi}
+also compresses DWARF debug sections, but rather than renaming them it
+sets the SHF_COMPRESSED flag in the sections' headers.
+
+The @option{--compress-debug-sections=zlib} option is an alias for
+@option{--compress-debug-sections=zlib-gabi}.
+
+Note that this option overrides any compression in input debug
+sections, so if a binary is linked with @option{--compress-debug-sections=none}
+for example, then any compressed debug sections in input files will be
+uncompressed before they are copied into the output binary.
+
+The default compression behaviour varies depending upon the target
+involved and the configure options used to build the toolchain.  The
+default can be determined by examining the output from the linker's
+@option{--help} option.
 
 @kindex --reduce-memory-overheads
 @item --reduce-memory-overheads