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 | ||
83 | @item p | |
84 | @itemx =pubnames | |
85 | Displays the contents of the @samp{.debug_pubnames} and/or | |
86 | @samp{.debug_gnu_pubnames} sections. | |
87 | ||
88 | @item r | |
89 | @itemx =aranges | |
90 | Displays the contents of the @samp{.debug_aranges} section. | |
91 | ||
92 | @item R | |
93 | @itemx =Ranges | |
94 | Displays the contents of the @samp{.debug_ranges} and/or | |
95 | @samp{.debug_rnglists} sections. | |
96 | ||
97 | @item s | |
98 | @itemx =str | |
99 | Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str} | |
100 | and/or @samp{.debug_str_offsets} sections. | |
101 | ||
102 | @item t | |
103 | @itemx =pubtype | |
104 | Displays the contents of the @samp{.debug_pubtypes} and/or | |
105 | @samp{.debug_gnu_pubtypes} sections. | |
106 | ||
107 | @item T | |
108 | @itemx =trace_aranges | |
109 | Displays the contents of the @samp{.trace_aranges} section. | |
110 | ||
111 | @item u | |
112 | @itemx =trace_abbrev | |
113 | Displays the contents of the @samp{.trace_abbrev} section. | |
114 | ||
115 | @item U | |
116 | @itemx =trace_info | |
117 | Displays the contents of the @samp{.trace_info} section. | |
118 | ||
119 | @end table | |
120 | ||
121 | Note: displaying the contents of @samp{.debug_static_funcs}, | |
122 | @samp{.debug_static_vars} and @samp{debug_weaknames} sections is not | |
123 | currently supported. | |
124 | ||
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 | |
129 | effect. | |
130 | ||
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. | |
133 | ||
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}. | |
137 | ||
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. | |
141 | ||
142 | This can be used in conjunction with @option{--dwarf-depth}. | |
143 |