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