1 /* dwarf.h - DWARF support header file 2 Copyright (C) 2005-2016 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 extern void init_dwarf_regnames_s390 (void); 208 209 extern int load_debug_section (enum dwarf_section_display_enum, void *); 210 extern void free_debug_section (enum dwarf_section_display_enum); 211 212 extern void free_debug_memory (void); 213 214 extern void dwarf_select_sections_by_names (const char *); 215 extern void dwarf_select_sections_by_letters (const char *); 216 extern void dwarf_select_sections_all (void); 217 218 extern unsigned int * find_cu_tu_set (void *, unsigned int); 219 220 extern void * cmalloc (size_t, size_t); 221 extern void * xcalloc2 (size_t, size_t); 222 extern void * xcmalloc (size_t, size_t); 223 extern void * xcrealloc (void *, size_t, size_t); 224 225 extern dwarf_vma read_leb128 (unsigned char *, unsigned int *, bfd_boolean, const unsigned char * const); 226 227 /* A callback into the client. Retuns TRUE if there is a 228 relocation against the given debug section at the given 229 offset. */ 230 extern bfd_boolean reloc_at (struct dwarf_section *, dwarf_vma); 231