1 /* dwarf.h - DWARF support header file
2 Copyright 2005, 2007, 2008, 2009, 2010
3 Free Software Foundation, Inc.
5 This file is part of GNU Binutils.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
20 MA 02110-1301, USA. */
22 typedef unsigned HOST_WIDEST_INT dwarf_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 bfd_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 bfd_vma ar_info_offset
;
106 unsigned char ar_pointer_size
;
107 unsigned char ar_segment_size
;
109 DWARF2_Internal_ARange
;
113 /* A debug section has a different name when it's stored compressed
114 or not. COMPRESSED_NAME and UNCOMPRESSED_NAME are the two
115 possibilities. NAME is set to whichever one is used for this
116 input file, as determined by load_debug_section(). */
117 const char *uncompressed_name
;
118 const char *compressed_name
;
120 unsigned char *start
;
122 dwarf_size_type size
;
125 /* A structure containing the name of a debug section
126 and a pointer to a function that can decode it. */
127 struct dwarf_section_display
129 struct dwarf_section section
;
130 int (*display
) (struct dwarf_section
*, void *);
132 unsigned int relocate
: 1;
135 enum dwarf_section_display_enum
159 extern struct dwarf_section_display debug_displays
[];
161 /* This structure records the information that
162 we extract from the.debug_info section. */
165 unsigned int pointer_size
;
166 unsigned int offset_size
;
169 bfd_vma base_address
;
170 /* This is an array of offsets to the location list table. */
171 bfd_vma
*loc_offsets
;
172 int *have_frame_base
;
173 unsigned int num_loc_offsets
;
174 unsigned int max_loc_offsets
;
175 /* List of .debug_ranges offsets seen in this .debug_info. */
176 bfd_vma
*range_lists
;
177 unsigned int num_range_lists
;
178 unsigned int max_range_lists
;
182 extern int eh_addr_size
;
184 extern int do_debug_info
;
185 extern int do_debug_abbrevs
;
186 extern int do_debug_lines
;
187 extern int do_debug_pubnames
;
188 extern int do_debug_pubtypes
;
189 extern int do_debug_aranges
;
190 extern int do_debug_ranges
;
191 extern int do_debug_frames
;
192 extern int do_debug_frames_interp
;
193 extern int do_debug_macinfo
;
194 extern int do_debug_str
;
195 extern int do_debug_loc
;
196 extern int do_gdb_index
;
197 extern int do_trace_info
;
198 extern int do_trace_abbrevs
;
199 extern int do_trace_aranges
;
202 extern void init_dwarf_regnames (unsigned int);
203 extern void init_dwarf_regnames_i386 (void);
204 extern void init_dwarf_regnames_x86_64 (void);
206 extern int load_debug_section (enum dwarf_section_display_enum
,
208 extern void free_debug_section (enum dwarf_section_display_enum
);
210 extern void free_debug_memory (void);
212 extern void dwarf_select_sections_by_names (const char *);
213 extern void dwarf_select_sections_by_letters (const char *);
214 extern void dwarf_select_sections_all (void);
216 void *cmalloc (size_t, size_t);
217 void *xcmalloc (size_t, size_t);
218 void *xcrealloc (void *, size_t, size_t);
220 bfd_vma
read_leb128 (unsigned char *data
,
221 unsigned int *length_return
, int sign
);