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