debug.options.texi revision 1.1.1.2
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 p 84@itemx =pubnames 85Displays the contents of the @samp{.debug_pubnames} and/or 86@samp{.debug_gnu_pubnames} sections. 87 88@item r 89@itemx =aranges 90Displays the contents of the @samp{.debug_aranges} section. 91 92@item R 93@itemx =Ranges 94Displays the contents of the @samp{.debug_ranges} and/or 95@samp{.debug_rnglists} sections. 96 97@item s 98@itemx =str 99Displays the contents of the @samp{.debug_str}, @samp{.debug_line_str} 100and/or @samp{.debug_str_offsets} sections. 101 102@item t 103@itemx =pubtype 104Displays the contents of the @samp{.debug_pubtypes} and/or 105@samp{.debug_gnu_pubtypes} sections. 106 107@item T 108@itemx =trace_aranges 109Displays the contents of the @samp{.trace_aranges} section. 110 111@item u 112@itemx =trace_abbrev 113Displays the contents of the @samp{.trace_abbrev} section. 114 115@item U 116@itemx =trace_info 117Displays the contents of the @samp{.trace_info} section. 118 119@end table 120 121Note: displaying the contents of @samp{.debug_static_funcs}, 122@samp{.debug_static_vars} and @samp{debug_weaknames} sections is not 123currently supported. 124 125@item --dwarf-depth=@var{n} 126Limit the dump of the @code{.debug_info} section to @var{n} children. 127This is only useful with @option{--debug-dump=info}. The default is 128to print all DIEs; the special value 0 for @var{n} will also have this 129effect. 130 131With a non-zero value for @var{n}, DIEs at or deeper than @var{n} 132levels will not be printed. The range for @var{n} is zero-based. 133 134@item --dwarf-start=@var{n} 135Print only DIEs beginning with the DIE numbered @var{n}. This is only 136useful with @option{--debug-dump=info}. 137 138If specified, this option will suppress printing of any header 139information and all DIEs before the DIE numbered @var{n}. Only 140siblings and children of the specified DIE will be printed. 141 142This can be used in conjunction with @option{--dwarf-depth}. 143 144