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