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_str_offsets} section.
89 Displays the contents of the @samp{.debug_pubnames} and/or
90 @samp{.debug_gnu_pubnames} sections.
94 Displays the contents of the @samp{.debug_aranges} section.
98 Displays the contents of the @samp{.debug_ranges} and/or
99 @samp{.debug_rnglists} sections.
103 Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str}
104 and/or @samp{.debug_str_offsets} sections.
108 Displays the contents of the @samp{.debug_pubtypes} and/or
109 @samp{.debug_gnu_pubtypes} sections.
112 @itemx =trace_aranges
113 Displays the contents of the @samp{.trace_aranges} section.
117 Displays the contents of the @samp{.trace_abbrev} section.
121 Displays the contents of the @samp{.trace_info} section.
125 Note: displaying the contents of @samp{.debug_static_funcs},
126 @samp{.debug_static_vars} and @samp{debug_weaknames} sections is not
129 @item --dwarf-depth=@var{n}
130 Limit the dump of the @code{.debug_info} section to @var{n} children.
131 This is only useful with @option{--debug-dump=info}. The default is
132 to print all DIEs; the special value 0 for @var{n} will also have this
135 With a non-zero value for @var{n}, DIEs at or deeper than @var{n}
136 levels will not be printed. The range for @var{n} is zero-based.
138 @item --dwarf-start=@var{n}
139 Print only DIEs beginning with the DIE numbered @var{n}. This is only
140 useful with @option{--debug-dump=info}.
142 If specified, this option will suppress printing of any header
143 information and all DIEs before the DIE numbered @var{n}. Only
144 siblings and children of the specified DIE will be printed.
146 This can be used in conjunction with @option{--dwarf-depth}.