1 /* dwarf.h - DWARF support header file
2 Copyright 2005-2013 Free Software Foundation, Inc.
4 This file is part of GNU Binutils.
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.
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.
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. */
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
;
25 /* Structure found in the .debug_line section. */
28 unsigned char li_length
[4];
29 unsigned char li_version
[2];
30 unsigned char li_prologue_length
[4];
31 unsigned char li_min_insn_length
[1];
32 unsigned char li_default_is_stmt
[1];
33 unsigned char li_line_base
[1];
34 unsigned char li_line_range
[1];
35 unsigned char li_opcode_base
[1];
37 DWARF2_External_LineInfo
;
42 unsigned short li_version
;
43 unsigned int li_prologue_length
;
44 unsigned char li_min_insn_length
;
45 unsigned char li_max_ops_per_insn
;
46 unsigned char li_default_is_stmt
;
48 unsigned char li_line_range
;
49 unsigned char li_opcode_base
;
51 DWARF2_Internal_LineInfo
;
53 /* Structure found in .debug_pubnames section. */
56 unsigned char pn_length
[4];
57 unsigned char pn_version
[2];
58 unsigned char pn_offset
[4];
59 unsigned char pn_size
[4];
61 DWARF2_External_PubNames
;
66 unsigned short pn_version
;
70 DWARF2_Internal_PubNames
;
72 /* Structure found in .debug_info section. */
75 unsigned char cu_length
[4];
76 unsigned char cu_version
[2];
77 unsigned char cu_abbrev_offset
[4];
78 unsigned char cu_pointer_size
[1];
80 DWARF2_External_CompUnit
;
85 unsigned short cu_version
;
86 dwarf_vma cu_abbrev_offset
;
87 unsigned char cu_pointer_size
;
89 DWARF2_Internal_CompUnit
;
93 unsigned char ar_length
[4];
94 unsigned char ar_version
[2];
95 unsigned char ar_info_offset
[4];
96 unsigned char ar_pointer_size
[1];
97 unsigned char ar_segment_size
[1];
99 DWARF2_External_ARange
;
104 unsigned short ar_version
;
105 dwarf_vma ar_info_offset
;
106 unsigned char ar_pointer_size
;
107 unsigned char ar_segment_size
;
109 DWARF2_Internal_ARange
;
111 enum dwarf_section_display_enum
152 /* A debug section has a different name when it's stored compressed
153 or not. COMPRESSED_NAME and UNCOMPRESSED_NAME are the two
154 possibilities. NAME is set to whichever one is used for this
155 input file, as determined by load_debug_section(). */
156 const char *uncompressed_name
;
157 const char *compressed_name
;
159 unsigned char *start
;
161 dwarf_size_type size
;
162 enum dwarf_section_display_enum abbrev_sec
;
165 /* A structure containing the name of a debug section
166 and a pointer to a function that can decode it. */
167 struct dwarf_section_display
169 struct dwarf_section section
;
170 int (*display
) (struct dwarf_section
*, void *);
172 unsigned int relocate
: 1;
175 extern struct dwarf_section_display debug_displays
[];
177 /* This structure records the information that
178 we extract from the.debug_info section. */
181 unsigned int pointer_size
;
182 unsigned int offset_size
;
185 dwarf_vma base_address
;
186 /* This field is filled in when reading the attribute DW_AT_GNU_addr_base and
187 is used with the form DW_AT_GNU_FORM_addr_index. */
189 /* This field is filled in when reading the attribute DW_AT_GNU_ranges_base and
190 is used when calculating ranges. */
191 dwarf_vma ranges_base
;
192 /* This is an array of offsets to the location list table. */
193 dwarf_vma
* loc_offsets
;
194 int * have_frame_base
;
195 unsigned int num_loc_offsets
;
196 unsigned int max_loc_offsets
;
197 /* List of .debug_ranges offsets seen in this .debug_info. */
198 dwarf_vma
* range_lists
;
199 unsigned int num_range_lists
;
200 unsigned int max_range_lists
;
204 extern int eh_addr_size
;
206 extern int do_debug_info
;
207 extern int do_debug_abbrevs
;
208 extern int do_debug_lines
;
209 extern int do_debug_pubnames
;
210 extern int do_debug_pubtypes
;
211 extern int do_debug_aranges
;
212 extern int do_debug_ranges
;
213 extern int do_debug_frames
;
214 extern int do_debug_frames_interp
;
215 extern int do_debug_macinfo
;
216 extern int do_debug_str
;
217 extern int do_debug_loc
;
218 extern int do_gdb_index
;
219 extern int do_trace_info
;
220 extern int do_trace_abbrevs
;
221 extern int do_trace_aranges
;
222 extern int do_debug_addr
;
223 extern int do_debug_cu_index
;
226 extern int dwarf_cutoff_level
;
227 extern unsigned long dwarf_start_die
;
229 extern int dwarf_check
;
231 extern void init_dwarf_regnames (unsigned int);
232 extern void init_dwarf_regnames_i386 (void);
233 extern void init_dwarf_regnames_x86_64 (void);
235 extern int load_debug_section (enum dwarf_section_display_enum
, void *);
236 extern void free_debug_section (enum dwarf_section_display_enum
);
238 extern void free_debug_memory (void);
240 extern void dwarf_select_sections_by_names (const char *);
241 extern void dwarf_select_sections_by_letters (const char *);
242 extern void dwarf_select_sections_all (void);
244 unsigned int * find_cu_tu_set (void *, unsigned int);
246 void * cmalloc (size_t, size_t);
247 void * xcmalloc (size_t, size_t);
248 void * xcrealloc (void *, size_t, size_t);
250 extern dwarf_vma
read_leb128 (unsigned char *, unsigned int *, bfd_boolean
, const unsigned char * const);