binutils/doc/debug.options.texi

   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
  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.
  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
  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.
  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