* NEWS: Add note about --dwarf-depth, --dwarf-start, and
[external/binutils.git] / binutils / dwarf.h
1 /* dwarf.h - DWARF support header file
2    Copyright 2005, 2007, 2008, 2009, 2010, 2011
3    Free Software Foundation, Inc.
4
5    This file is part of GNU Binutils.
6
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.
11
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.
16
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.  */
21
22 typedef unsigned HOST_WIDEST_INT  dwarf_vma;
23 typedef HOST_WIDEST_INT           dwarf_signed_vma;
24 typedef unsigned HOST_WIDEST_INT  dwarf_size_type;
25
26 /* Structure found in the .debug_line section.  */
27 typedef struct
28 {
29   unsigned char li_length          [4];
30   unsigned char li_version         [2];
31   unsigned char li_prologue_length [4];
32   unsigned char li_min_insn_length [1];
33   unsigned char li_default_is_stmt [1];
34   unsigned char li_line_base       [1];
35   unsigned char li_line_range      [1];
36   unsigned char li_opcode_base     [1];
37 }
38 DWARF2_External_LineInfo;
39
40 typedef struct
41 {
42   dwarf_vma      li_length;
43   unsigned short li_version;
44   unsigned int   li_prologue_length;
45   unsigned char  li_min_insn_length;
46   unsigned char  li_max_ops_per_insn;
47   unsigned char  li_default_is_stmt;
48   int            li_line_base;
49   unsigned char  li_line_range;
50   unsigned char  li_opcode_base;
51 }
52 DWARF2_Internal_LineInfo;
53
54 /* Structure found in .debug_pubnames section.  */
55 typedef struct
56 {
57   unsigned char pn_length  [4];
58   unsigned char pn_version [2];
59   unsigned char pn_offset  [4];
60   unsigned char pn_size    [4];
61 }
62 DWARF2_External_PubNames;
63
64 typedef struct
65 {
66   dwarf_vma      pn_length;
67   unsigned short pn_version;
68   dwarf_vma      pn_offset;
69   dwarf_vma      pn_size;
70 }
71 DWARF2_Internal_PubNames;
72
73 /* Structure found in .debug_info section.  */
74 typedef struct
75 {
76   unsigned char  cu_length        [4];
77   unsigned char  cu_version       [2];
78   unsigned char  cu_abbrev_offset [4];
79   unsigned char  cu_pointer_size  [1];
80 }
81 DWARF2_External_CompUnit;
82
83 typedef struct
84 {
85   dwarf_vma      cu_length;
86   unsigned short cu_version;
87   dwarf_vma      cu_abbrev_offset;
88   unsigned char  cu_pointer_size;
89 }
90 DWARF2_Internal_CompUnit;
91
92 typedef struct
93 {
94   unsigned char  ar_length       [4];
95   unsigned char  ar_version      [2];
96   unsigned char  ar_info_offset  [4];
97   unsigned char  ar_pointer_size [1];
98   unsigned char  ar_segment_size [1];
99 }
100 DWARF2_External_ARange;
101
102 typedef struct
103 {
104   dwarf_vma      ar_length;
105   unsigned short ar_version;
106   dwarf_vma      ar_info_offset;
107   unsigned char  ar_pointer_size;
108   unsigned char  ar_segment_size;
109 }
110 DWARF2_Internal_ARange;
111
112 struct dwarf_section
113 {
114   /* A debug section has a different name when it's stored compressed
115      or not.  COMPRESSED_NAME and UNCOMPRESSED_NAME are the two
116      possibilities.  NAME is set to whichever one is used for this
117      input file, as determined by load_debug_section().  */
118   const char *uncompressed_name;
119   const char *compressed_name;
120   const char *name;
121   unsigned char *start;
122   dwarf_vma address;
123   dwarf_size_type size;
124 };
125
126 /* A structure containing the name of a debug section
127    and a pointer to a function that can decode it.  */
128 struct dwarf_section_display
129 {
130   struct dwarf_section section;
131   int (*display) (struct dwarf_section *, void *);
132   int *enabled;
133   unsigned int relocate : 1;
134 };
135
136 enum dwarf_section_display_enum
137 {
138   abbrev = 0,
139   aranges,
140   frame,
141   info,
142   line,
143   pubnames,
144   eh_frame,
145   macinfo,
146   str,
147   loc,
148   pubtypes,
149   ranges,
150   static_func,
151   static_vars,
152   types,
153   weaknames,
154   trace_info,
155   trace_abbrev,
156   trace_aranges,
157   max
158 };
159
160 extern struct dwarf_section_display debug_displays [];
161
162 /* This structure records the information that
163    we extract from the.debug_info section.  */
164 typedef struct
165 {
166   unsigned int   pointer_size;
167   unsigned int   offset_size;
168   int            dwarf_version;
169   dwarf_vma      cu_offset;
170   dwarf_vma      base_address;
171   /* This is an array of offsets to the location list table.  */
172   dwarf_vma *    loc_offsets;
173   int *          have_frame_base;
174   unsigned int   num_loc_offsets;
175   unsigned int   max_loc_offsets;
176   /* List of .debug_ranges offsets seen in this .debug_info.  */
177   dwarf_vma *    range_lists;
178   unsigned int   num_range_lists;
179   unsigned int   max_range_lists;
180 }
181 debug_info;
182
183 extern int eh_addr_size;
184
185 extern int do_debug_info;
186 extern int do_debug_abbrevs;
187 extern int do_debug_lines;
188 extern int do_debug_pubnames;
189 extern int do_debug_pubtypes;
190 extern int do_debug_aranges;
191 extern int do_debug_ranges;
192 extern int do_debug_frames;
193 extern int do_debug_frames_interp;
194 extern int do_debug_macinfo;
195 extern int do_debug_str;
196 extern int do_debug_loc;
197 extern int do_gdb_index;
198 extern int do_trace_info;
199 extern int do_trace_abbrevs;
200 extern int do_trace_aranges;
201 extern int do_wide;
202
203 extern int dwarf_cutoff_level;
204 extern unsigned long dwarf_start_die;
205
206 extern void init_dwarf_regnames (unsigned int);
207 extern void init_dwarf_regnames_i386 (void);
208 extern void init_dwarf_regnames_x86_64 (void);
209
210 extern int load_debug_section (enum dwarf_section_display_enum, void *);
211 extern void free_debug_section (enum dwarf_section_display_enum);
212
213 extern void free_debug_memory (void);
214
215 extern void dwarf_select_sections_by_names (const char *);
216 extern void dwarf_select_sections_by_letters (const char *);
217 extern void dwarf_select_sections_all (void);
218
219 void * cmalloc (size_t, size_t);
220 void * xcmalloc (size_t, size_t);
221 void * xcrealloc (void *, size_t, size_t);
222
223 dwarf_vma read_leb128 (unsigned char *, unsigned int *, int);