diff options
Diffstat (limited to 'gdb/doc')
| -rw-r--r-- | gdb/doc/ChangeLog | 7 | ||||
| -rw-r--r-- | gdb/doc/gdb.texinfo | 12 | ||||
| -rw-r--r-- | gdb/doc/gdbint.texinfo | 23 |
3 files changed, 42 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index ad57779..d888281 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,10 @@ +2008-04-19 Craig Silverstein <csilvers@google.com> + + * gdb.texinfo (Requirements): Add an optional requirement on + zlib. + * gdbint.texinfo (Debugging File Formats): Add new subsection for + Compressed DWARF 2. + 2008-04-16 Aleksandar Ristovski <aristovski@qnx.com> * gdb.texinfo (GDB/MI Simple Examples): Added 'disp' field to the diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 0a7576c..d033530 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -22732,6 +22732,18 @@ Remote shared library lists (@pxref{Library List Format}) MS-Windows shared libraries (@pxref{Shared Libraries}) @end itemize +@item zlib +@cindex compressed debug sections +@value{GDBN} will use the @samp{zlib} library, if available, to read +compressed debug sections. Some linkers, such as GNU gold, are capable +of producing binaries with compressed debug sections. If @value{GDBN} +is compiled with @samp{zlib}, it will be able to read the debug +information in such binaries. + +The @samp{zlib} library is likely included with your operating system +distribution; if it is not, you can get the latest version from +@url{http://zlib.net}. + @end table @node Running Configure 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 |