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.
3
4Displays the contents of the DWARF debug sections in the file, if any
5are present.  Compressed debug sections are automatically decompressed
6(temporarily) before they are displayed.  If one or more of the
7optional letters or words follows the switch then only those type(s)
8of data will be dumped.  The letters and words refer to the following
9information:
10
11@c Please Keep This Table Alpha Sorted.
12@table @code
13@item a
14@itemx =abbrev
15Displays the contents of the @samp{.debug_abbrev} section.
16
17@item A
18@itemx =addr
19Displays the contents of the @samp{.debug_addr} section.
20
21@item c
22@itemx =cu_index
23Displays the contents of the @samp{.debug_cu_index} and/or
24@samp{.debug_tu_index} sections.
25
26@item f
27@itemx =frames
28Display the raw contents of a @samp{.debug_frame} section.
29
30@item F
31@item =frame-interp
32Display the interpreted contents of a @samp{.debug_frame} section.
33
34@item g
35@itemx =gdb_index
36Displays the contents of the @samp{.gdb_index} and/or
37@samp{.debug_names} sections.
38
39@item i
40@itemx =info
41Displays the contents of the @samp{.debug_info} section.  Note: the
42output from this option can also be restricted by the use of the
43@option{--dwarf-depth} and @option{--dwarf-start} options.
44
45@item k
46@itemx =links
47Displays the contents of the @samp{.gnu_debuglink},
48@samp{.gnu_debugaltlink} and @samp{.debug_sup} sections, if any of
49them are present.  Also displays any links to separate dwarf object
50files (dwo), if they are specified by the DW_AT_GNU_dwo_name or
51DW_AT_dwo_name attributes in the @samp{.debug_info} section.
52
53@item K
54@itemx =follow-links
55Display the contents of any selected debug sections that are found in
56linked, separate debug info file(s).  This can result in multiple
57versions of the same debug section being displayed if it exists in
58more than one file.
59
60In addition, when displaying DWARF attributes, if a form is found that
61references the separate debug info file, then the referenced contents
62will also be displayed.
63
64Note - in some distributions this option is enabled by default.  It
65can be disabled via the @option{N} debug option.  The default can be
66chosen when configuring the binutils via the
67@option{--enable-follow-debug-links=yes} or
68@option{--enable-follow-debug-links=no} options.  If these are not
69used then the default is to enable the following of debug links.
70
71@item N
72@itemx =no-follow-links
73Disables the following of links to separate debug info files.
74
75@item l
76@itemx =rawline
77Displays the contents of the @samp{.debug_line} section in a raw
78format.
79
80@item L
81@item =decodedline
82Displays the interpreted contents of the @samp{.debug_line} section.
83
84@item m
85@itemx =macro
86Displays the contents of the @samp{.debug_macro} and/or
87@samp{.debug_macinfo} sections.
88
89@item o
90@itemx =loc
91Displays the contents of the @samp{.debug_loc} and/or
92@samp{.debug_loclists} sections.
93
94@item O
95@itemx =str-offsets
96Displays the contents of the @samp{.debug_str_offsets} section.
97
98@item p
99@itemx =pubnames
100Displays the contents of the @samp{.debug_pubnames} and/or
101@samp{.debug_gnu_pubnames} sections.
102
103@item r
104@itemx =aranges
105Displays the contents of the @samp{.debug_aranges} section.
106
107@item R
108@itemx =Ranges
109Displays the contents of the @samp{.debug_ranges} and/or
110@samp{.debug_rnglists} sections.
111
112@item s
113@itemx =str
114Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str}
115and/or @samp{.debug_str_offsets} sections.
116
117@item t
118@itemx =pubtype
119Displays the contents of the @samp{.debug_pubtypes} and/or
120@samp{.debug_gnu_pubtypes} sections.
121
122@item T
123@itemx =trace_aranges
124Displays the contents of the @samp{.trace_aranges} section.
125
126@item u
127@itemx =trace_abbrev
128Displays the contents of the @samp{.trace_abbrev} section.
129
130@item U
131@itemx =trace_info
132Displays the contents of the @samp{.trace_info} section.
133
134@end table
135
136Note: displaying the contents of @samp{.debug_static_funcs},
137@samp{.debug_static_vars} and @samp{debug_weaknames} sections is not
138currently supported.
139
140@item --dwarf-depth=@var{n}
141Limit the dump of the @code{.debug_info} section to @var{n} children.
142This is only useful with @option{--debug-dump=info}.  The default is
143to print all DIEs; the special value 0 for @var{n} will also have this
144effect.
145
146With a non-zero value for @var{n}, DIEs at or deeper than @var{n}
147levels will not be printed.  The range for @var{n} is zero-based.
148
149@item --dwarf-start=@var{n}
150Print only DIEs beginning with the DIE numbered @var{n}.  This is only
151useful with @option{--debug-dump=info}.
152
153If specified, this option will suppress printing of any header
154information and all DIEs before the DIE numbered @var{n}.  Only
155siblings and children of the specified DIE will be printed.
156
157This can be used in conjunction with @option{--dwarf-depth}.
158
159