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 any links to
49 separate dwarf object files (dwo), if they are 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 linked, separate debug info file(s). This can result in multiple
57 versions of the same debug section being displayed if it exists in
60 In addition, when displaying DWARF attributes, if a form is found that
61 references the separate debug info file, then the referenced contents
62 will also be displayed.
66 Displays the contents of the @samp{.debug_line} section in a raw
71 Displays the interpreted contents of the @samp{.debug_line} section.
75 Displays the contents of the @samp{.debug_macro} and/or
76 @samp{.debug_macinfo} sections.
80 Displays the contents of the @samp{.debug_loc} and/or
81 @samp{.debug_loclists} sections.
85 Displays the contents of the @samp{.debug_pubnames} and/or
86 @samp{.debug_gnu_pubnames} sections.
90 Displays the contents of the @samp{.debug_aranges} section.
94 Displays the contents of the @samp{.debug_ranges} and/or
95 @samp{.debug_rnglists} sections.
99 Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str}
100 and/or @samp{.debug_str_offsets} sections.
104 Displays the contents of the @samp{.debug_pubtypes} and/or
105 @samp{.debug_gnu_pubtypes} sections.
108 @itemx =trace_aranges
109 Displays the contents of the @samp{.trace_aranges} section.
113 Displays the contents of the @samp{.trace_abbrev} section.
117 Displays the contents of the @samp{.trace_info} section.
121 Note: displaying the contents of @samp{.debug_static_funcs},
122 @samp{.debug_static_vars} and @samp{debug_weaknames} sections is not
125 @item --dwarf-depth=@var{n}
126 Limit the dump of the @code{.debug_info} section to @var{n} children.
127 This is only useful with @option{--debug-dump=info}. The default is
128 to print all DIEs; the special value 0 for @var{n} will also have this
131 With a non-zero value for @var{n}, DIEs at or deeper than @var{n}
132 levels will not be printed. The range for @var{n} is zero-based.
134 @item --dwarf-start=@var{n}
135 Print only DIEs beginning with the DIE numbered @var{n}. This is only
136 useful with @option{--debug-dump=info}.
138 If specified, this option will suppress printing of any header
139 information and all DIEs before the DIE numbered @var{n}. Only
140 siblings and children of the specified DIE will be printed.
142 This can be used in conjunction with @option{--dwarf-depth}.