gdb/
[deliverable/binutils-gdb.git] / include / dwarf2.h
CommitLineData
e0452928
DD
1/* Declarations and definitions of codes relating to the DWARF2 and
2 DWARF3 symbolic debugging information formats.
3 Copyright (C) 1992, 1993, 1995, 1996, 1997, 1999, 2000, 2001, 2002,
fa66ec53 4 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
de432b8c 5 Free Software Foundation, Inc.
e0452928
DD
6
7 Written by Gary Funck (gary@intrepid.com) The Ada Joint Program
8 Office (AJPO), Florida State University and Silicon Graphics Inc.
9 provided support for this effort -- June 21, 1995.
10
11 Derived from the DWARF 1 implementation written by Ron Guilmette
12 (rfg@netcom.com), November 1990.
13
14 This file is part of GCC.
15
16 GCC is free software; you can redistribute it and/or modify it under
17 the terms of the GNU General Public License as published by the Free
18 Software Foundation; either version 3, or (at your option) any later
19 version.
20
21 GCC is distributed in the hope that it will be useful, but WITHOUT
22 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
23 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
24 License for more details.
25
26 Under Section 7 of GPL version 3, you are granted additional
27 permissions described in the GCC Runtime Library Exception, version
28 3.1, as published by the Free Software Foundation.
29
30 You should have received a copy of the GNU General Public License and
31 a copy of the GCC Runtime Library Exception along with this program;
32 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
33 <http://www.gnu.org/licenses/>. */
34
35/* This file is derived from the DWARF specification (a public document)
36 Revision 2.0.0 (July 27, 1993) developed by the UNIX International
37 Programming Languages Special Interest Group (UI/PLSIG) and distributed
38 by UNIX International. Copies of this specification are available from
39 UNIX International, 20 Waterview Boulevard, Parsippany, NJ, 07054.
40
41 This file also now contains definitions from the DWARF 3 specification
42 published Dec 20, 2005, available from: http://dwarf.freestandards.org. */
43
47704ddf
KT
44#ifndef _DWARF2_H
45#define _DWARF2_H
e0452928 46
fa66ec53
DD
47#define DW_TAG(name, value) , name = value
48#define DW_TAG_DUP(name, value) , name = value
49#define DW_FORM(name, value) , name = value
50#define DW_AT(name, value) , name = value
51#define DW_AT_DUP(name, value) , name = value
52#define DW_OP(name, value) , name = value
53#define DW_OP_DUP(name, value) , name = value
54#define DW_ATE(name, value) , name = value
55#define DW_ATE_DUP(name, value) , name = value
56#define DW_CFA(name, value) , name = value
57
58#define DW_FIRST_TAG(name, value) enum dwarf_tag { \
59 name = value
60#define DW_END_TAG };
61#define DW_FIRST_FORM(name, value) enum dwarf_form { \
62 name = value
63#define DW_END_FORM };
64#define DW_FIRST_AT(name, value) enum dwarf_attribute { \
65 name = value
66#define DW_END_AT };
67#define DW_FIRST_OP(name, value) enum dwarf_location_atom { \
68 name = value
69#define DW_END_OP };
70#define DW_FIRST_ATE(name, value) enum dwarf_type { \
71 name = value
72#define DW_END_ATE };
73#define DW_FIRST_CFA(name, value) enum dwarf_call_frame_info { \
74 name = value
75#define DW_END_CFA };
76
77#include "dwarf2.def"
78
79#undef DW_FIRST_TAG
80#undef DW_END_TAG
81#undef DW_FIRST_FORM
82#undef DW_END_FORM
83#undef DW_FIRST_AT
84#undef DW_END_AT
85#undef DW_FIRST_OP
86#undef DW_END_OP
87#undef DW_FIRST_ATE
88#undef DW_END_ATE
89#undef DW_FIRST_CFA
90#undef DW_END_CFA
91
92#undef DW_TAG
93#undef DW_TAG_DUP
94#undef DW_FORM
95#undef DW_AT
96#undef DW_AT_DUP
97#undef DW_OP
98#undef DW_OP_DUP
99#undef DW_ATE
100#undef DW_ATE_DUP
101#undef DW_CFA
e0452928
DD
102
103/* Flag that tells whether entry has a child or not. */
104#define DW_children_no 0
105#define DW_children_yes 1
106
e0452928 107#define DW_AT_stride_size DW_AT_bit_stride /* Note: The use of DW_AT_stride_size is deprecated. */
e0452928 108#define DW_AT_stride DW_AT_byte_stride /* Note: The use of DW_AT_stride is deprecated. */
e0452928
DD
109
110/* Decimal sign encodings. */
111enum dwarf_decimal_sign_encoding
112 {
113 /* DWARF 3. */
114 DW_DS_unsigned = 0x01,
115 DW_DS_leading_overpunch = 0x02,
116 DW_DS_trailing_overpunch = 0x03,
117 DW_DS_leading_separate = 0x04,
118 DW_DS_trailing_separate = 0x05
119 };
120
121/* Endianity encodings. */
122enum dwarf_endianity_encoding
123 {
124 /* DWARF 3. */
125 DW_END_default = 0x00,
126 DW_END_big = 0x01,
127 DW_END_little = 0x02,
128
129 DW_END_lo_user = 0x40,
130 DW_END_hi_user = 0xff
131 };
132
133/* Array ordering names and codes. */
134enum dwarf_array_dim_ordering
135 {
136 DW_ORD_row_major = 0,
137 DW_ORD_col_major = 1
138 };
139
140/* Access attribute. */
141enum dwarf_access_attribute
142 {
143 DW_ACCESS_public = 1,
144 DW_ACCESS_protected = 2,
145 DW_ACCESS_private = 3
146 };
147
148/* Visibility. */
149enum dwarf_visibility_attribute
150 {
151 DW_VIS_local = 1,
152 DW_VIS_exported = 2,
153 DW_VIS_qualified = 3
154 };
155
156/* Virtuality. */
157enum dwarf_virtuality_attribute
158 {
159 DW_VIRTUALITY_none = 0,
160 DW_VIRTUALITY_virtual = 1,
161 DW_VIRTUALITY_pure_virtual = 2
162 };
163
164/* Case sensitivity. */
165enum dwarf_id_case
166 {
167 DW_ID_case_sensitive = 0,
168 DW_ID_up_case = 1,
169 DW_ID_down_case = 2,
170 DW_ID_case_insensitive = 3
171 };
172
173/* Calling convention. */
174enum dwarf_calling_convention
175 {
176 DW_CC_normal = 0x1,
177 DW_CC_program = 0x2,
178 DW_CC_nocall = 0x3,
179
180 DW_CC_lo_user = 0x40,
181 DW_CC_hi_user = 0xff,
182
dec397b2 183 DW_CC_GNU_renesas_sh = 0x40,
54fcddd0
UW
184 DW_CC_GNU_borland_fastcall_i386 = 0x41,
185
186 /* This DW_CC_ value is not currently generated by any toolchain. It is
187 used internally to GDB to indicate OpenCL C functions that have been
188 compiled with the IBM XL C for OpenCL compiler and use a non-platform
189 calling convention for passing OpenCL C vector types. This value may
190 be changed freely as long as it does not conflict with any other DW_CC_
191 value defined here. */
192 DW_CC_GDB_IBM_OpenCL = 0xff
e0452928
DD
193 };
194
195/* Inline attribute. */
196enum dwarf_inline_attribute
197 {
198 DW_INL_not_inlined = 0,
199 DW_INL_inlined = 1,
200 DW_INL_declared_not_inlined = 2,
201 DW_INL_declared_inlined = 3
202 };
203
204/* Discriminant lists. */
205enum dwarf_discrim_list
206 {
207 DW_DSC_label = 0,
208 DW_DSC_range = 1
209 };
210
211/* Line number opcodes. */
212enum dwarf_line_number_ops
213 {
214 DW_LNS_extended_op = 0,
215 DW_LNS_copy = 1,
216 DW_LNS_advance_pc = 2,
217 DW_LNS_advance_line = 3,
218 DW_LNS_set_file = 4,
219 DW_LNS_set_column = 5,
220 DW_LNS_negate_stmt = 6,
221 DW_LNS_set_basic_block = 7,
222 DW_LNS_const_add_pc = 8,
223 DW_LNS_fixed_advance_pc = 9,
224 /* DWARF 3. */
225 DW_LNS_set_prologue_end = 10,
226 DW_LNS_set_epilogue_begin = 11,
227 DW_LNS_set_isa = 12
228 };
229
230/* Line number extended opcodes. */
231enum dwarf_line_number_x_ops
232 {
233 DW_LNE_end_sequence = 1,
234 DW_LNE_set_address = 2,
235 DW_LNE_define_file = 3,
236 DW_LNE_set_discriminator = 4,
237 /* HP extensions. */
238 DW_LNE_HP_negate_is_UV_update = 0x11,
239 DW_LNE_HP_push_context = 0x12,
240 DW_LNE_HP_pop_context = 0x13,
241 DW_LNE_HP_set_file_line_column = 0x14,
242 DW_LNE_HP_set_routine_name = 0x15,
243 DW_LNE_HP_set_sequence = 0x16,
244 DW_LNE_HP_negate_post_semantics = 0x17,
245 DW_LNE_HP_negate_function_exit = 0x18,
246 DW_LNE_HP_negate_front_end_logical = 0x19,
247 DW_LNE_HP_define_proc = 0x20,
93a6c7a4 248 DW_LNE_HP_source_file_correlation = 0x80,
e0452928
DD
249
250 DW_LNE_lo_user = 0x80,
251 DW_LNE_hi_user = 0xff
252 };
253
bbda3415
TG
254/* Sub-opcodes for DW_LNE_HP_source_file_correlation. */
255enum dwarf_line_number_hp_sfc_ops
256 {
257 DW_LNE_HP_SFC_formfeed = 1,
258 DW_LNE_HP_SFC_set_listing_line = 2,
259 DW_LNE_HP_SFC_associate = 3
260 };
261
e0452928
DD
262#define DW_CIE_ID 0xffffffff
263#define DW64_CIE_ID 0xffffffffffffffffULL
264#define DW_CIE_VERSION 1
265
266#define DW_CFA_extended 0
267
268#define DW_CHILDREN_no 0x00
269#define DW_CHILDREN_yes 0x01
270
271#define DW_ADDR_none 0
272
273/* Source language names and codes. */
274enum dwarf_source_language
275 {
276 DW_LANG_C89 = 0x0001,
277 DW_LANG_C = 0x0002,
278 DW_LANG_Ada83 = 0x0003,
279 DW_LANG_C_plus_plus = 0x0004,
280 DW_LANG_Cobol74 = 0x0005,
281 DW_LANG_Cobol85 = 0x0006,
282 DW_LANG_Fortran77 = 0x0007,
283 DW_LANG_Fortran90 = 0x0008,
284 DW_LANG_Pascal83 = 0x0009,
285 DW_LANG_Modula2 = 0x000a,
286 /* DWARF 3. */
287 DW_LANG_Java = 0x000b,
288 DW_LANG_C99 = 0x000c,
289 DW_LANG_Ada95 = 0x000d,
290 DW_LANG_Fortran95 = 0x000e,
291 DW_LANG_PLI = 0x000f,
292 DW_LANG_ObjC = 0x0010,
293 DW_LANG_ObjC_plus_plus = 0x0011,
294 DW_LANG_UPC = 0x0012,
295 DW_LANG_D = 0x0013,
3fce87a0 296 /* DWARF 4. */
2b6f5997 297 DW_LANG_Python = 0x0014,
8baf536a
DD
298 /* DWARF 5. */
299 DW_LANG_Go = 0x0016,
e0452928
DD
300
301 DW_LANG_lo_user = 0x8000, /* Implementation-defined range start. */
302 DW_LANG_hi_user = 0xffff, /* Implementation-defined range start. */
303
304 /* MIPS. */
305 DW_LANG_Mips_Assembler = 0x8001,
306 /* UPC. */
93a6c7a4
TG
307 DW_LANG_Upc = 0x8765,
308 /* HP extensions. */
309 DW_LANG_HP_Bliss = 0x8003,
310 DW_LANG_HP_Basic91 = 0x8004,
311 DW_LANG_HP_Pascal91 = 0x8005,
312 DW_LANG_HP_IMacro = 0x8006,
313 DW_LANG_HP_Assembler = 0x8007
e0452928
DD
314 };
315
316/* Names and codes for macro information. */
317enum dwarf_macinfo_record_type
318 {
319 DW_MACINFO_define = 1,
320 DW_MACINFO_undef = 2,
321 DW_MACINFO_start_file = 3,
322 DW_MACINFO_end_file = 4,
323 DW_MACINFO_vendor_ext = 255
324 };
d4743114
JJ
325
326/* Names and codes for new style macro information. */
327enum dwarf_macro_record_type
328 {
329 DW_MACRO_GNU_define = 1,
330 DW_MACRO_GNU_undef = 2,
331 DW_MACRO_GNU_start_file = 3,
332 DW_MACRO_GNU_end_file = 4,
333 DW_MACRO_GNU_define_indirect = 5,
334 DW_MACRO_GNU_undef_indirect = 6,
335 DW_MACRO_GNU_transparent_include = 7,
336 DW_MACRO_GNU_lo_user = 0xe0,
337 DW_MACRO_GNU_hi_user = 0xff
338 };
e0452928
DD
339\f
340/* @@@ For use with GNU frame unwind information. */
341
342#define DW_EH_PE_absptr 0x00
343#define DW_EH_PE_omit 0xff
344
345#define DW_EH_PE_uleb128 0x01
346#define DW_EH_PE_udata2 0x02
347#define DW_EH_PE_udata4 0x03
348#define DW_EH_PE_udata8 0x04
349#define DW_EH_PE_sleb128 0x09
350#define DW_EH_PE_sdata2 0x0A
351#define DW_EH_PE_sdata4 0x0B
352#define DW_EH_PE_sdata8 0x0C
353#define DW_EH_PE_signed 0x08
354
355#define DW_EH_PE_pcrel 0x10
356#define DW_EH_PE_textrel 0x20
357#define DW_EH_PE_datarel 0x30
358#define DW_EH_PE_funcrel 0x40
359#define DW_EH_PE_aligned 0x50
360
361#define DW_EH_PE_indirect 0x80
362
fa66ec53
DD
363
364#ifdef __cplusplus
365extern "C" {
366#endif /* __cplusplus */
367
368/* Return the name of a DW_TAG_ constant, or NULL if the value is not
369 recognized. */
370extern const char *get_DW_TAG_name (unsigned int tag);
371
372/* Return the name of a DW_AT_ constant, or NULL if the value is not
373 recognized. */
374extern const char *get_DW_AT_name (unsigned int attr);
375
376/* Return the name of a DW_FORM_ constant, or NULL if the value is not
377 recognized. */
378extern const char *get_DW_FORM_name (unsigned int form);
379
380/* Return the name of a DW_OP_ constant, or NULL if the value is not
381 recognized. */
382extern const char *get_DW_OP_name (unsigned int op);
383
384/* Return the name of a DW_ATE_ constant, or NULL if the value is not
385 recognized. */
386extern const char *get_DW_ATE_name (unsigned int enc);
387
388/* Return the name of a DW_CFA_ constant, or NULL if the value is not
389 recognized. */
390extern const char *get_DW_CFA_name (unsigned int opc);
391
392#ifdef __cplusplus
393}
394#endif /* __cplusplus */
395
47704ddf 396#endif /* _DWARF2_H */
This page took 0.152417 seconds and 4 git commands to generate.