]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame_incremental - binutils/dwarf.h
projects / thirdparty / binutils-gdb.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
Add support to readelf and objdump for following links to separate debug information...
[thirdparty/binutils-gdb.git] / binutils / dwarf.h
... / ...
CommitLineData
1/* dwarf.h - DWARF support header file
2 Copyright (C) 2005-2017 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#include "dwarf2.h" /* for enum dwarf_unit_type */
22
23typedef unsigned HOST_WIDEST_INT dwarf_vma;
24typedef HOST_WIDEST_INT dwarf_signed_vma;
25typedef unsigned HOST_WIDEST_INT dwarf_size_type;
26
27/* Structure found in the .debug_line section. */
28typedef struct
29{
30 dwarf_vma li_length;
31 unsigned short li_version;
32 dwarf_vma li_prologue_length;
33 unsigned char li_min_insn_length;
34 unsigned char li_max_ops_per_insn;
35 unsigned char li_default_is_stmt;
36 int li_line_base;
37 unsigned char li_line_range;
38 unsigned char li_opcode_base;
39 unsigned int li_offset_size;
40}
41DWARF2_Internal_LineInfo;
42
43/* Structure found in .debug_pubnames section. */
44typedef struct
45{
46 dwarf_vma pn_length;
47 unsigned short pn_version;
48 dwarf_vma pn_offset;
49 dwarf_vma pn_size;
50}
51DWARF2_Internal_PubNames;
52
53/* Structure found in .debug_info section. */
54typedef struct
55{
56 dwarf_vma cu_length;
57 unsigned short cu_version;
58 dwarf_vma cu_abbrev_offset;
59 unsigned char cu_pointer_size;
60 enum dwarf_unit_type cu_unit_type;
61}
62DWARF2_Internal_CompUnit;
63
64/* Structure found in .debug_aranges section. */
65typedef struct
66{
67 dwarf_vma ar_length;
68 unsigned short ar_version;
69 dwarf_vma ar_info_offset;
70 unsigned char ar_pointer_size;
71 unsigned char ar_segment_size;
72}
73DWARF2_Internal_ARange;
74
75/* N.B. The order here must match the order in debug_displays. */
76
77enum dwarf_section_display_enum
78{
79 abbrev = 0,
80 aranges,
81 frame,
82 info,
83 line,
84 pubnames,
85 gnu_pubnames,
86 eh_frame,
87 macinfo,
88 macro,
89 str,
90 line_str,
91 loc,
92 loclists,
93 pubtypes,
94 gnu_pubtypes,
95 ranges,
96 rnglists,
97 static_func,
98 static_vars,
99 types,
100 weaknames,
101 gdb_index,
102 debug_names,
103 trace_info,
104 trace_abbrev,
105 trace_aranges,
106 info_dwo,
107 abbrev_dwo,
108 types_dwo,
109 line_dwo,
110 loc_dwo,
111 macro_dwo,
112 macinfo_dwo,
113 str_dwo,
114 str_index,
115 str_index_dwo,
116 debug_addr,
117 dwp_cu_index,
118 dwp_tu_index,
119 gnu_debuglink,
120 gnu_debugaltlink,
121 separate_debug_str,
122 max
123};
124
125struct dwarf_section
126{
127 /* A debug section has a different name when it's stored compressed
128 or not. COMPRESSED_NAME and UNCOMPRESSED_NAME are the two
129 possibilities. NAME is set to whichever one is used for this
130 input file, as determined by load_debug_section(). */
131 const char * uncompressed_name;
132 const char * compressed_name;
133 const char * name;
134 /* If non-NULL then FILENAME is the name of the separate debug info
135 file containing the section. */
136 const char * filename;
137 unsigned char * start;
138 dwarf_vma address;
139 dwarf_size_type size;
140 enum dwarf_section_display_enum abbrev_sec;
141 /* Used by clients to help them implement the reloc_at callback. */
142 void * reloc_info;
143 unsigned long num_relocs;
144 /* A spare field for random use. */
145 void * user_data;
146};
147
148/* A structure containing the name of a debug section
149 and a pointer to a function that can decode it. */
150struct dwarf_section_display
151{
152 struct dwarf_section section;
153 int (* display) (struct dwarf_section *, void *);
154 int * enabled;
155 bfd_boolean relocate;
156};
157
158extern struct dwarf_section_display debug_displays [];
159
160/* This structure records the information that
161 we extract from the.debug_info section. */
162typedef struct
163{
164 unsigned int pointer_size;
165 unsigned int offset_size;
166 int dwarf_version;
167 dwarf_vma cu_offset;
168 dwarf_vma base_address;
169 /* This field is filled in when reading the attribute DW_AT_GNU_addr_base and
170 is used with the form DW_AT_GNU_FORM_addr_index. */
171 dwarf_vma addr_base;
172 /* This field is filled in when reading the attribute DW_AT_GNU_ranges_base and
173 is used when calculating ranges. */
174 dwarf_vma ranges_base;
175 /* This is an array of offsets to the location list table. */
176 dwarf_vma * loc_offsets;
177 /* This is an array of offsets to the location view table. */
178 dwarf_vma * loc_views;
179 int * have_frame_base;
180 unsigned int num_loc_offsets;
181 unsigned int max_loc_offsets;
182 unsigned int num_loc_views;
183 /* List of .debug_ranges offsets seen in this .debug_info. */
184 dwarf_vma * range_lists;
185 unsigned int num_range_lists;
186 unsigned int max_range_lists;
187}
188debug_info;
189
190extern unsigned int eh_addr_size;
191
192extern int do_debug_info;
193extern int do_debug_abbrevs;
194extern int do_debug_lines;
195extern int do_debug_pubnames;
196extern int do_debug_pubtypes;
197extern int do_debug_aranges;
198extern int do_debug_ranges;
199extern int do_debug_frames;
200extern int do_debug_frames_interp;
201extern int do_debug_macinfo;
202extern int do_debug_str;
203extern int do_debug_loc;
204extern int do_gdb_index;
205extern int do_trace_info;
206extern int do_trace_abbrevs;
207extern int do_trace_aranges;
208extern int do_debug_addr;
209extern int do_debug_cu_index;
210extern int do_wide;
211extern int do_debug_links;
212
213extern int dwarf_cutoff_level;
214extern unsigned long dwarf_start_die;
215
216extern int dwarf_check;
217
218extern void init_dwarf_regnames (unsigned int);
219extern void init_dwarf_regnames_i386 (void);
220extern void init_dwarf_regnames_iamcu (void);
221extern void init_dwarf_regnames_x86_64 (void);
222extern void init_dwarf_regnames_aarch64 (void);
223extern void init_dwarf_regnames_s390 (void);
224
225extern bfd_boolean load_debug_section (enum dwarf_section_display_enum, void *);
226extern void free_debug_section (enum dwarf_section_display_enum);
227extern void * load_separate_debug_file (void *, const char *);
228extern void close_debug_file (void *);
229extern void * open_debug_file (const char *);
230
231extern void free_debug_memory (void);
232
233extern void dwarf_select_sections_by_names (const char *);
234extern void dwarf_select_sections_by_letters (const char *);
235extern void dwarf_select_sections_all (void);
236
237extern unsigned int * find_cu_tu_set (void *, unsigned int);
238
239extern void * cmalloc (size_t, size_t);
240extern void * xcalloc2 (size_t, size_t);
241extern void * xcmalloc (size_t, size_t);
242extern void * xcrealloc (void *, size_t, size_t);
243
244extern dwarf_vma read_leb128 (unsigned char *, unsigned int *, bfd_boolean, const unsigned char * const);
245
246/* A callback into the client. Returns TRUE if there is a
247 relocation against the given debug section at the given
248 offset. */
249extern bfd_boolean reloc_at (struct dwarf_section *, dwarf_vma);
A mirror of the official binutils-gdb repository