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} and/or
48@samp{.gnu_debugaltlink} sections.  Also displays any links to
49separate dwarf object files (dwo), if they are specified by the 
50DW_AT_GNU_dwo_name or DW_AT_dwo_name attributes in the
51@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
64@item l
65@itemx =rawline
66Displays the contents of the @samp{.debug_line} section in a raw
67format.
68
69@item L
70@item =decodedline
71Displays the interpreted contents of the @samp{.debug_line} section.
72
73@item m
74@itemx =macro
75Displays the contents of the @samp{.debug_macro} and/or
76@samp{.debug_macinfo} sections.
77
78@item o
79@itemx =loc
80Displays the contents of the @samp{.debug_loc} and/or
81@samp{.debug_loclists} sections.
82
83@item O
84@itemx =str-offsets
85Displays the contents of the @samp{.debug_str_offsets} section.
86
87@item p
88@itemx =pubnames
89Displays the contents of the @samp{.debug_pubnames} and/or
90@samp{.debug_gnu_pubnames} sections.
91
92@item r
93@itemx =aranges
94Displays the contents of the @samp{.debug_aranges} section.
95
96@item R
97@itemx =Ranges
98Displays the contents of the @samp{.debug_ranges} and/or
99@samp{.debug_rnglists} sections.
100
101@item s
102@itemx =str
103Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str}
104and/or @samp{.debug_str_offsets} sections.
105
106@item t
107@itemx =pubtype
108Displays the contents of the @samp{.debug_pubtypes} and/or
109@samp{.debug_gnu_pubtypes} sections.
110
111@item T
112@itemx =trace_aranges
113Displays the contents of the @samp{.trace_aranges} section.
114
115@item u
116@itemx =trace_abbrev
117Displays the contents of the @samp{.trace_abbrev} section.
118
119@item U
120@itemx =trace_info
121Displays the contents of the @samp{.trace_info} section.
122
123@end table
124
125Note: displaying the contents of @samp{.debug_static_funcs},
126@samp{.debug_static_vars} and @samp{debug_weaknames} sections is not
127currently supported.
128
129@item --dwarf-depth=@var{n}
130Limit the dump of the @code{.debug_info} section to @var{n} children.
131This is only useful with @option{--debug-dump=info}.  The default is
132to print all DIEs; the special value 0 for @var{n} will also have this
133effect.
134
135With a non-zero value for @var{n}, DIEs at or deeper than @var{n}
136levels will not be printed.  The range for @var{n} is zero-based.
137
138@item --dwarf-start=@var{n}
139Print only DIEs beginning with the DIE numbered @var{n}.  This is only
140useful with @option{--debug-dump=info}.
141
142If specified, this option will suppress printing of any header
143information and all DIEs before the DIE numbered @var{n}.  Only
144siblings and children of the specified DIE will be printed.
145
146This can be used in conjunction with @option{--dwarf-depth}.
147
148