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