c46b706620
* configure.ac (follow-debug-links): Add option to enable or
disable the following of debug links by default. Set the
default for the option to be 'follow'.
* dwarf.c (do_follow_links): Initialise with DEFAULT_FOR_FOLLOW_LINKS.
(dwarf_select_sections_by_names): Add no-follow-links option.
(dwarf_select_sections_by_letter): Add 'N' option.
* objdump.c (usage): Add conditional text describing the
follow links option.
(slurp_symtab): Ensure that there is a NULL entry at the end
of the symbol table.
(slurp_dynamic_symtab): Likewise.
(dump_bfd): When extending the symbol table, ensure that there
is still a NULL entry at the end.
* readelf.c (usage): Add conditional text describing the
follow links option.
* doc/binutils.texi: Update documentation for objcopy and
readelf.
* doc/debug.options.texi: Update documentation of the
follow-links option.
* config.in: Regenerate.
* configure: Regenerate.
* testsuite/binutils-all/compress.exp: Add the -WN option to
objdump command lines that are not expecting to follow links.
* testsuite/binutils-all/readelf.exp: Add the
--debug-dump=no-follow-links option to tests that are not
expecting to follow debug links.
gas * testsuite/gas/mach-o/sections-1.d: Stop automatic debug link
following.
* testsuite/gas/xgate/insns-dwarf2.d: Likewise.
ld * testsuite/ld-elf/sec64k.exp: Stop readelf from automatically
following debug links.
159 lines
4.7 KiB
Plaintext
159 lines
4.7 KiB
Plaintext
@c This file contains the entry for the -w/--debug-dump (readelf) and
|
|
@c -W/--dwarf (objdump) option that is common to both readelf and objdump.
|
|
|
|
Displays the contents of the DWARF debug sections in the file, if any
|
|
are present. Compressed debug sections are automatically decompressed
|
|
(temporarily) before they are displayed. If one or more of the
|
|
optional letters or words follows the switch then only those type(s)
|
|
of data will be dumped. The letters and words refer to the following
|
|
information:
|
|
|
|
@c Please Keep This Table Alpha Sorted.
|
|
@table @code
|
|
@item a
|
|
@itemx =abbrev
|
|
Displays the contents of the @samp{.debug_abbrev} section.
|
|
|
|
@item A
|
|
@itemx =addr
|
|
Displays the contents of the @samp{.debug_addr} section.
|
|
|
|
@item c
|
|
@itemx =cu_index
|
|
Displays the contents of the @samp{.debug_cu_index} and/or
|
|
@samp{.debug_tu_index} sections.
|
|
|
|
@item f
|
|
@itemx =frames
|
|
Display the raw contents of a @samp{.debug_frame} section.
|
|
|
|
@item F
|
|
@item =frame-interp
|
|
Display the interpreted contents of a @samp{.debug_frame} section.
|
|
|
|
@item g
|
|
@itemx =gdb_index
|
|
Displays the contents of the @samp{.gdb_index} and/or
|
|
@samp{.debug_names} sections.
|
|
|
|
@item i
|
|
@itemx =info
|
|
Displays the contents of the @samp{.debug_info} section. Note: the
|
|
output from this option can also be restricted by the use of the
|
|
@option{--dwarf-depth} and @option{--dwarf-start} options.
|
|
|
|
@item k
|
|
@itemx =links
|
|
Displays the contents of the @samp{.gnu_debuglink} and/or
|
|
@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
|
|
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
|
|
will also be displayed.
|
|
|
|
Note - in some distributions this option is enabled by default. It
|
|
can be disabled via the @option{N} debug option. The default can be
|
|
chosen when configuring the binutils via the
|
|
@option{--enable-follow-debug-links=yes} or
|
|
@option{--enable-follow-debug-links=no} options. If these are not
|
|
used then the default is to enable the following of debug links.
|
|
|
|
@item N
|
|
@itemx =no-follow-links
|
|
Disables the following of links to separate debug info files.
|
|
|
|
@item l
|
|
@itemx =rawline
|
|
Displays the contents of the @samp{.debug_line} section in a raw
|
|
format.
|
|
|
|
@item L
|
|
@item =decodedline
|
|
Displays the interpreted contents of the @samp{.debug_line} section.
|
|
|
|
@item m
|
|
@itemx =macro
|
|
Displays the contents of the @samp{.debug_macro} and/or
|
|
@samp{.debug_macinfo} sections.
|
|
|
|
@item o
|
|
@itemx =loc
|
|
Displays the contents of the @samp{.debug_loc} and/or
|
|
@samp{.debug_loclists} sections.
|
|
|
|
@item O
|
|
@itemx =str-offsets
|
|
Displays the contents of the @samp{.debug_str_offsets} section.
|
|
|
|
@item p
|
|
@itemx =pubnames
|
|
Displays the contents of the @samp{.debug_pubnames} and/or
|
|
@samp{.debug_gnu_pubnames} sections.
|
|
|
|
@item r
|
|
@itemx =aranges
|
|
Displays the contents of the @samp{.debug_aranges} section.
|
|
|
|
@item R
|
|
@itemx =Ranges
|
|
Displays the contents of the @samp{.debug_ranges} and/or
|
|
@samp{.debug_rnglists} sections.
|
|
|
|
@item s
|
|
@itemx =str
|
|
Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str}
|
|
and/or @samp{.debug_str_offsets} sections.
|
|
|
|
@item t
|
|
@itemx =pubtype
|
|
Displays the contents of the @samp{.debug_pubtypes} and/or
|
|
@samp{.debug_gnu_pubtypes} sections.
|
|
|
|
@item T
|
|
@itemx =trace_aranges
|
|
Displays the contents of the @samp{.trace_aranges} section.
|
|
|
|
@item u
|
|
@itemx =trace_abbrev
|
|
Displays the contents of the @samp{.trace_abbrev} section.
|
|
|
|
@item U
|
|
@itemx =trace_info
|
|
Displays the contents of the @samp{.trace_info} section.
|
|
|
|
@end table
|
|
|
|
Note: displaying the contents of @samp{.debug_static_funcs},
|
|
@samp{.debug_static_vars} and @samp{debug_weaknames} sections is not
|
|
currently supported.
|
|
|
|
@item --dwarf-depth=@var{n}
|
|
Limit the dump of the @code{.debug_info} section to @var{n} children.
|
|
This is only useful with @option{--debug-dump=info}. The default is
|
|
to print all DIEs; the special value 0 for @var{n} will also have this
|
|
effect.
|
|
|
|
With a non-zero value for @var{n}, DIEs at or deeper than @var{n}
|
|
levels will not be printed. The range for @var{n} is zero-based.
|
|
|
|
@item --dwarf-start=@var{n}
|
|
Print only DIEs beginning with the DIE numbered @var{n}. This is only
|
|
useful with @option{--debug-dump=info}.
|
|
|
|
If specified, this option will suppress printing of any header
|
|
information and all DIEs before the DIE numbered @var{n}. Only
|
|
siblings and children of the specified DIE will be printed.
|
|
|
|
This can be used in conjunction with @option{--dwarf-depth}.
|
|
|