1 @c This file contains the entry for the -w/--debug-dump (readelf) and
2 @c -W/--dwarf (objdump) option that is common to both readelf and objdump.
4 Displays the contents of the DWARF debug sections in the file, if any
5 are present. Compressed debug sections are automatically decompressed
6 (temporarily) before they are displayed. If one or more of the
7 optional letters or words follows the switch then only those type(s)
8 of data will be dumped. The letters and words refer to the following
11 @c Please Keep This Table Alpha Sorted.
15 Displays the contents of the @samp{.debug_abbrev} section.
19 Displays the contents of the @samp{.debug_addr} section.
23 Displays the contents of the @samp{.debug_cu_index} and/or
24 @samp{.debug_tu_index} sections.
28 Display the raw contents of a @samp{.debug_frame} section.
32 Display the interpreted contents of a @samp{.debug_frame} section.
36 Displays the contents of the @samp{.gdb_index} and/or
37 @samp{.debug_names} sections.
41 Displays the contents of the @samp{.debug_info} section. Note: the
42 output from this option can also be restricted by the use of the
43 @option{--dwarf-depth} and @option{--dwarf-start} options.
47 Displays the contents of the @samp{.gnu_debuglink} and/or
48 @samp{.gnu_debugaltlink} sections. Also displays the link to a
49 separate dwarf object file (dwo), if one is specified by the
50 DW_AT_GNU_dwo_name or DW_AT_dwo_name attributes in the
51 @samp{.debug_info} section.
55 Display the contents of any selected debug sections that are found in
56 a linked, separate debug info file. This can result in multiple
57 versions of the same debug section being displayed if both the main
58 file and the separate debug info file contain sections with the same
61 In addition, when displaying DWARF attributes, if a form is found that
62 references the separate debug info file, then the referenced contents
63 will also be displayed.
67 Displays the contents of the @samp{.debug_line} section in a raw
72 Displays the interpreted contents of the @samp{.debug_line} section.
76 Displays the contents of the @samp{.debug_macro} and/or
77 @samp{.debug_macinfo} sections.
81 Displays the contents of the @samp{.debug_loc} and/or
82 @samp{.debug_loclists} sections.
86 Displays the contents of the @samp{.debug_pubnames} and/or
87 @samp{.debug_gnu_pubnames} sections.
91 Displays the contents of the @samp{.debug_aranges} section.
95 Displays the contents of the @samp{.debug_ranges} and/or
96 @samp{.debug_rnglists} sections.
100 Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str}
101 and/or @samp{.debug_str_offsets} sections.
105 Displays the contents of the @samp{.debug_pubtypes} and/or
106 @samp{.debug_gnu_pubtypes} sections.
109 @itemx =trace_aranges
110 Displays the contents of the @samp{.trace_aranges} section.
114 Displays the contents of the @samp{.trace_abbrev} section.
118 Displays the contents of the @samp{.trace_info} section.
122 Note: displaying the contents of @samp{.debug_static_funcs},
123 @samp{.debug_static_vars} and @samp{debug_weaknames} sections is not
126 @item --dwarf-depth=@var{n}
127 Limit the dump of the @code{.debug_info} section to @var{n} children.
128 This is only useful with @option{--debug-dump=info}. The default is
129 to print all DIEs; the special value 0 for @var{n} will also have this
132 With a non-zero value for @var{n}, DIEs at or deeper than @var{n}
133 levels will not be printed. The range for @var{n} is zero-based.
135 @item --dwarf-start=@var{n}
136 Print only DIEs beginning with the DIE numbered @var{n}. This is only
137 useful with @option{--debug-dump=info}.
139 If specified, this option will suppress printing of any header
140 information and all DIEs before the DIE numbered @var{n}. Only
141 siblings and children of the specified DIE will be printed.
143 This can be used in conjunction with @option{--dwarf-depth}.