aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc/gdbint.texinfo
diff options
context:
space:
mode:
authorCraig Silverstein <csilvers@google.com>2008-04-20 00:03:25 +0000
committerCraig Silverstein <csilvers@google.com>2008-04-20 00:03:25 +0000
commit31fffb02125a6c8a1182af5718e9fc49b23e0ed8 (patch)
tree135f0279f1c4b2cc28545c4ffb3f25e900fe6729 /gdb/doc/gdbint.texinfo
parent1386d68a62e9e5702cdfdac54878101d2aaa3d3a (diff)
downloadgdb-31fffb02125a6c8a1182af5718e9fc49b23e0ed8.zip
gdb-31fffb02125a6c8a1182af5718e9fc49b23e0ed8.tar.gz
gdb-31fffb02125a6c8a1182af5718e9fc49b23e0ed8.tar.bz2
* NEWS: Add information on compressed debug sections.
* doc/gdb.texinfo (Requirements): Add an optional requirement on zlib. * doc/gdbint.texinfo (Debugging File Formats): Add new subsection for Compressed DWARF 2.
Diffstat (limited to 'gdb/doc/gdbint.texinfo')
-rw-r--r--gdb/doc/gdbint.texinfo23
1 files changed, 23 insertions, 0 deletions
diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index 38e9b43..d578347 100644
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -2201,6 +2201,29 @@ DWARF 2 is an improved but incompatible version of DWARF 1.
The DWARF 2 reader is in @file{dwarf2read.c}.
+@subsection Compressed DWARF 2
+
+@cindex Compressed DWARF 2 debugging info
+Compressed DWARF 2 is not technically a separate debugging format, but
+merely DWARF 2 debug information that has been compressed. In this
+format, every object-file section holding DWARF 2 debugging
+information is compressed and prepended with a header. (The section
+is also typically renamed, so a section called @code{.debug_info} in a
+DWARF 2 binary would be called @code{.zdebug_info} in a compressed
+DWARF 2 binary.) The header is 12 bytes long:
+
+@itemize @bullet
+@item
+4 bytes: the literal string ``ZLIB''
+@item
+8 bytes: the uncompressed size of the section, in big-endian byte
+order.
+@end itemize
+
+The same reader is used for both compressed an normal DWARF 2 info.
+Section decompression is done in @code{zlib_decompress_section} in
+@file{dwarf2read.c}.
+
@subsection SOM
@cindex SOM debugging info