Commit | Line | Data |
---|---|---|
dda8d76d NC |
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 | ||
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 | |
9 | information: | |
10 | ||
11 | @c Please Keep This Table Alpha Sorted. | |
12 | @table @code | |
13 | @item a | |
14 | @itemx =abbrev | |
15 | Displays the contents of the @samp{.debug_abbrev} section. | |
16 | ||
17 | @item A | |
18 | @itemx =addr | |
19 | Displays the contents of the @samp{.debug_addr} section. | |
20 | ||
21 | @item c | |
22 | @itemx =cu_index | |
23 | Displays the contents of the @samp{.debug_cu_index} and/or | |
24 | @samp{.debug_tu_index} sections. | |
25 | ||
26 | @item f | |
27 | @itemx =frames | |
28 | Display the raw contents of a @samp{.debug_frame} section. | |
29 | ||
30 | @item F | |
31 | @item =frame-interp | |
32 | Display the interpreted contents of a @samp{.debug_frame} section. | |
33 | ||
34 | @item g | |
35 | @itemx =gdb_index | |
36 | Displays the contents of the @samp{.gdb_index} and/or | |
37 | @samp{.debug_names} sections. | |
38 | ||
39 | @item i | |
40 | @itemx =info | |
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. | |
44 | ||
45 | @item k | |
46 | @itemx =links | |
47 | Displays the contents of the @samp{.gnu_debuglink} and/or | |
24841daa NC |
48 | @samp{.gnu_debugaltlink} sections. Also displays any links to |
49 | separate dwarf object files (dwo), if they are specified by the | |
d85bf2ba NC |
50 | DW_AT_GNU_dwo_name or DW_AT_dwo_name attributes in the |
51 | @samp{.debug_info} section. | |
dda8d76d NC |
52 | |
53 | @item K | |
54 | @itemx =follow-links | |
55 | Display the contents of any selected debug sections that are found in | |
24841daa NC |
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 | |
58 | more than one file. | |
dda8d76d | 59 | |
d85bf2ba NC |
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. | |
dda8d76d NC |
63 | |
64 | @item l | |
65 | @itemx =rawline | |
66 | Displays the contents of the @samp{.debug_line} section in a raw | |
67 | format. | |
68 | ||
69 | @item L | |
70 | @item =decodedline | |
71 | Displays the interpreted contents of the @samp{.debug_line} section. | |
72 | ||
73 | @item m | |
74 | @itemx =macro | |
75 | Displays the contents of the @samp{.debug_macro} and/or | |
76 | @samp{.debug_macinfo} sections. | |
77 | ||
78 | @item o | |
79 | @itemx =loc | |
80 | Displays the contents of the @samp{.debug_loc} and/or | |
81 | @samp{.debug_loclists} sections. | |
82 | ||
e4b7104b NC |
83 | @item O |
84 | @itemx =str-offsets | |
85 | Displays the contents of the @samp{.debug_str_offsets} section. | |
86 | ||
dda8d76d NC |
87 | @item p |
88 | @itemx =pubnames | |
89 | Displays the contents of the @samp{.debug_pubnames} and/or | |
90 | @samp{.debug_gnu_pubnames} sections. | |
91 | ||
92 | @item r | |
93 | @itemx =aranges | |
94 | Displays the contents of the @samp{.debug_aranges} section. | |
95 | ||
96 | @item R | |
97 | @itemx =Ranges | |
98 | Displays the contents of the @samp{.debug_ranges} and/or | |
99 | @samp{.debug_rnglists} sections. | |
100 | ||
101 | @item s | |
102 | @itemx =str | |
103 | Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str} | |
104 | and/or @samp{.debug_str_offsets} sections. | |
105 | ||
106 | @item t | |
107 | @itemx =pubtype | |
108 | Displays the contents of the @samp{.debug_pubtypes} and/or | |
109 | @samp{.debug_gnu_pubtypes} sections. | |
110 | ||
111 | @item T | |
112 | @itemx =trace_aranges | |
113 | Displays the contents of the @samp{.trace_aranges} section. | |
114 | ||
115 | @item u | |
116 | @itemx =trace_abbrev | |
117 | Displays the contents of the @samp{.trace_abbrev} section. | |
118 | ||
119 | @item U | |
120 | @itemx =trace_info | |
121 | Displays the contents of the @samp{.trace_info} section. | |
122 | ||
123 | @end table | |
124 | ||
125 | Note: displaying the contents of @samp{.debug_static_funcs}, | |
126 | @samp{.debug_static_vars} and @samp{debug_weaknames} sections is not | |
127 | currently supported. | |
128 | ||
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 | |
133 | effect. | |
134 | ||
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. | |
137 | ||
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}. | |
141 | ||
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. | |
145 | ||
146 | This can be used in conjunction with @option{--dwarf-depth}. | |
147 |