binutils/dwarf.h

   1 /* dwarf.h - DWARF support header file
   2    Copyright (C) 2005-2015 Free Software Foundation, Inc.
   3
   4    This file is part of GNU Binutils.
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
  19    MA 02110-1301, USA.  */
  20
  21 typedef unsigned HOST_WIDEST_INT  dwarf_vma;
  22 typedef HOST_WIDEST_INT           dwarf_signed_vma;
  23 typedef unsigned HOST_WIDEST_INT  dwarf_size_type;
  24
  25 /* Structure found in the .debug_line section.  */
  26 typedef struct
  27 {
  28   dwarf_vma      li_length;
  29   unsigned short li_version;
  30   dwarf_vma      li_prologue_length;
  31   unsigned char  li_min_insn_length;
  32   unsigned char  li_max_ops_per_insn;
  33   unsigned char  li_default_is_stmt;
  34   int            li_line_base;
  35   unsigned char  li_line_range;
  36   unsigned char  li_opcode_base;
  37 }
  38 DWARF2_Internal_LineInfo;
  39
  40 /* Structure found in .debug_pubnames section.  */
  41 typedef struct
  42 {
  43   dwarf_vma      pn_length;
  44   unsigned short pn_version;
  45   dwarf_vma      pn_offset;
  46   dwarf_vma      pn_size;
  47 }
  48 DWARF2_Internal_PubNames;
  49
  50 /* Structure found in .debug_info section.  */
  51 typedef struct
  52 {
  53   dwarf_vma      cu_length;
  54   unsigned short cu_version;
  55   dwarf_vma      cu_abbrev_offset;
  56   unsigned char  cu_pointer_size;
  57 }
  58 DWARF2_Internal_CompUnit;
  59
  60 /* Structure found in .debug_aranges section.  */
  61 typedef struct
  62 {
  63   dwarf_vma      ar_length;
  64   unsigned short ar_version;
  65   dwarf_vma      ar_info_offset;
  66   unsigned char  ar_pointer_size;
  67   unsigned char  ar_segment_size;
  68 }
  69 DWARF2_Internal_ARange;
  70
  71 /* N.B. The order here must match the order in debug_displays.  */
  72
  73 enum dwarf_section_display_enum
  74 {
  75   abbrev = 0,
  76   aranges,
  77   frame,
  78   info,
  79   line,
  80   pubnames,
  81   gnu_pubnames,
  82   eh_frame,
  83   macinfo,
  84   macro,
  85   str,
  86   loc,
  87   pubtypes,
  88   gnu_pubtypes,
  89   ranges,
  90   static_func,
  91   static_vars,
  92   types,
  93   weaknames,
  94   gdb_index,
  95   trace_info,
  96   trace_abbrev,
  97   trace_aranges,
  98   info_dwo,
  99   abbrev_dwo,
 100   types_dwo,
 101   line_dwo,
 102   loc_dwo,
 103   macro_dwo,
 104   macinfo_dwo,
 105   str_dwo,
 106   str_index,
 107   str_index_dwo,
 108   debug_addr,
 109   dwp_cu_index,
 110   dwp_tu_index,
 111   max
 112 };
 113
 114 struct dwarf_section
 115 {
 116   /* A debug section has a different name when it's stored compressed
 117      or not.  COMPRESSED_NAME and UNCOMPRESSED_NAME are the two
 118      possibilities.  NAME is set to whichever one is used for this
 119      input file, as determined by load_debug_section().  */
 120   const char *uncompressed_name;
 121   const char *compressed_name;
 122   const char *name;
 123   unsigned char *start;
 124   dwarf_vma address;
 125   dwarf_size_type size;
 126   enum dwarf_section_display_enum abbrev_sec;
 127
 128   /* Used by clients to help them implement the reloc_at callback.  */
 129   void * reloc_info;
 130   unsigned long num_relocs;
 131
 132   /* A spare field for random use.  */
 133   void *user_data;
 134 };
 135
 136 /* A structure containing the name of a debug section
 137    and a pointer to a function that can decode it.  */
 138 struct dwarf_section_display
 139 {
 140   struct dwarf_section section;
 141   int (*display) (struct dwarf_section *, void *);
 142   int *enabled;
 143   bfd_boolean relocate;
 144 };
 145
 146 extern struct dwarf_section_display debug_displays [];
 147
 148 /* This structure records the information that
 149    we extract from the.debug_info section.  */
 150 typedef struct
 151 {
 152   unsigned int   pointer_size;
 153   unsigned int   offset_size;
 154   int            dwarf_version;
 155   dwarf_vma      cu_offset;
 156   dwarf_vma      base_address;
 157   /* This field is filled in when reading the attribute DW_AT_GNU_addr_base and
 158      is used with the form DW_AT_GNU_FORM_addr_index.  */
 159   dwarf_vma      addr_base;
 160   /* This field is filled in when reading the attribute DW_AT_GNU_ranges_base and
 161      is used when calculating ranges.  */
 162   dwarf_vma      ranges_base;
 163   /* This is an array of offsets to the location list table.  */
 164   dwarf_vma *    loc_offsets;
 165   int *          have_frame_base;
 166   unsigned int   num_loc_offsets;
 167   unsigned int   max_loc_offsets;
 168   /* List of .debug_ranges offsets seen in this .debug_info.  */
 169   dwarf_vma *    range_lists;
 170   unsigned int   num_range_lists;
 171   unsigned int   max_range_lists;
 172 }
 173 debug_info;
 174
 175 extern unsigned int eh_addr_size;
 176
 177 extern int do_debug_info;
 178 extern int do_debug_abbrevs;
 179 extern int do_debug_lines;
 180 extern int do_debug_pubnames;
 181 extern int do_debug_pubtypes;
 182 extern int do_debug_aranges;
 183 extern int do_debug_ranges;
 184 extern int do_debug_frames;
 185 extern int do_debug_frames_interp;
 186 extern int do_debug_macinfo;
 187 extern int do_debug_str;
 188 extern int do_debug_loc;
 189 extern int do_gdb_index;
 190 extern int do_trace_info;
 191 extern int do_trace_abbrevs;
 192 extern int do_trace_aranges;
 193 extern int do_debug_addr;
 194 extern int do_debug_cu_index;
 195 extern int do_wide;
 196
 197 extern int dwarf_cutoff_level;
 198 extern unsigned long dwarf_start_die;
 199
 200 extern int dwarf_check;
 201
 202 extern void init_dwarf_regnames (unsigned int);
 203 extern void init_dwarf_regnames_i386 (void);
 204 extern void init_dwarf_regnames_iamcu (void);
 205 extern void init_dwarf_regnames_x86_64 (void);
 206 extern void init_dwarf_regnames_aarch64 (void);
 207
 208 extern int load_debug_section (enum dwarf_section_display_enum, void *);
 209 extern void free_debug_section (enum dwarf_section_display_enum);
 210
 211 extern void free_debug_memory (void);
 212
 213 extern void dwarf_select_sections_by_names (const char *);
 214 extern void dwarf_select_sections_by_letters (const char *);
 215 extern void dwarf_select_sections_all (void);
 216
 217 extern unsigned int * find_cu_tu_set (void *, unsigned int);
 218
 219 extern void * cmalloc (size_t, size_t);
 220 extern void * xcalloc2 (size_t, size_t);
 221 extern void * xcmalloc (size_t, size_t);
 222 extern void * xcrealloc (void *, size_t, size_t);
 223
 224 extern dwarf_vma read_leb128 (unsigned char *, unsigned int *, bfd_boolean, const unsigned char * const);
 225
 226 /* A callback into the client.  Retuns TRUE if there is a
 227    relocation against the given debug section at the given
 228    offset.  */
 229 extern bfd_boolean reloc_at (struct dwarf_section *, dwarf_vma);