aboutsummaryrefslogtreecommitdiff
path: root/binutils/doc/debug.options.texi
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2019-02-22 10:36:24 +0000
committerNick Clifton <nickc@redhat.com>2019-02-22 10:36:24 +0000
commit24841daa74f092f7c5639ee8f1fb303c7694dee7 (patch)
treee1bc310ca5ad66731c0b21496c4c3a093c7b89b8 /binutils/doc/debug.options.texi
parent83f43c8344d752fb8266b4c4e2f42cf4e5a2f86e (diff)
downloadgdb-24841daa74f092f7c5639ee8f1fb303c7694dee7.zip
gdb-24841daa74f092f7c5639ee8f1fb303c7694dee7.tar.gz
gdb-24841daa74f092f7c5639ee8f1fb303c7694dee7.tar.bz2
Extend readelf and objdump so that they will display and follow multiple links to separate debug information files.
PR 23843 * dwarf.h (struct separate_info): New structure for containing information on separate debug info files. * dwarf.c (struct dwo_info): New structure for containing dwo links. (first_dwo_info): Chain of dwo_info structures. (first_separate_file): Chain of separate_info structures. (separate_debug_file, separate_debug_filename): Delete. (fetch_alt_indirect_string): Scan all separate debug info files for the requested string. (add_dwo_info): New function. (add_dwo_name): New function. (add_dwo_dir): New function. (add_dwo_id: New function. (free_dwo_info): New function. (read_and_display_attr_value): Store DWO data using the new functions. (load_debug_section_with_follow): If necessary, scan the list of separate debug info files for the requested section. (add_separate_debug_file): New function. (load_separate_debug_info): Call add_separate_debug_file to store the information on the newly loaded file. (load_dwo_file): Likewise. (load_separate_debif_file): Rename to load_separate_debug_files. Change return type to boolean. If following links then attempt to load all separate debug info files, not just the first one. (free_debug_memory): Release memory in dwo_info and separate_info chains. * objdump.c (dump_dwarf): Iterate over all loaded debg info files. * readelf.c (process_object): Likewise. * doc/debug.options.texi: Update descriptions of links and follow-links options. * testsuite/binutils-all/objdump.WK2: Update expected output. * testsuite/binutils-all/readelf.k2: Likewise. * NEWS: Announce the new feature.
Diffstat (limited to 'binutils/doc/debug.options.texi')
-rw-r--r--binutils/doc/debug.options.texi11
1 files changed, 5 insertions, 6 deletions
diff --git a/binutils/doc/debug.options.texi b/binutils/doc/debug.options.texi
index 5794565..7f07388 100644
--- a/binutils/doc/debug.options.texi
+++ b/binutils/doc/debug.options.texi
@@ -45,18 +45,17 @@ output from this option can also be restricted by the use of the
@item k
@itemx =links
Displays the contents of the @samp{.gnu_debuglink} and/or
-@samp{.gnu_debugaltlink} sections. Also displays the link to a
-separate dwarf object file (dwo), if one is specified by the
+@samp{.gnu_debugaltlink} sections. Also displays any links to
+separate dwarf object files (dwo), if they are specified by the
DW_AT_GNU_dwo_name or DW_AT_dwo_name attributes in the
@samp{.debug_info} section.
@item K
@itemx =follow-links
Display the contents of any selected debug sections that are found in
-a linked, separate debug info file. This can result in multiple
-versions of the same debug section being displayed if both the main
-file and the separate debug info file contain sections with the same
-name.
+linked, separate debug info file(s). This can result in multiple
+versions of the same debug section being displayed if it exists in
+more than one file.
In addition, when displaying DWARF attributes, if a form is found that
references the separate debug info file, then the referenced contents