1/* Declarations and definitions of codes relating to the DWARF2 symbolic
2   debugging information format.
3   Copyright (C) 1992, 1993, 1995, 1996, 1997, 2000
4   Free Software Foundation, Inc.
5   Contributed by Gary Funck (gary@intrepid.com).  Derived from the
6   DWARF 1 implementation written by Ron Guilmette (rfg@monkeys.com).
7
8This file is part of GNU CC.
9
10GNU CC is free software; you can redistribute it and/or modify
11it under the terms of the GNU General Public License as published by
12the Free Software Foundation; either version 2, or (at your option)
13any later version.
14
15GNU CC is distributed in the hope that it will be useful,
16but WITHOUT ANY WARRANTY; without even the implied warranty of
17MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18GNU General Public License for more details.
19
20You should have received a copy of the GNU General Public License
21along with GNU CC; see the file COPYING.  If not, write to
22the Free Software Foundation, 59 Temple Place - Suite 330,
23Boston, MA 02111-1307, USA.  */
24
25/* This file is derived from the DWARF specification (a public document)
26   Revision 2.0.0 (July 27, 1993) developed by the UNIX International
27   Programming Languages Special Interest Group (UI/PLSIG) and distributed
28   by UNIX International.  Copies of this specification are available from
29   UNIX International, 20 Waterview Boulevard, Parsippany, NJ, 07054.  */
30
31/* This file is shared between GCC and GDB, and should not contain
32   prototypes.  */
33
34/* Tag names and codes.  */
35
36enum dwarf_tag
37  {
38    DW_TAG_padding = 0x00,
39    DW_TAG_array_type = 0x01,
40    DW_TAG_class_type = 0x02,
41    DW_TAG_entry_point = 0x03,
42    DW_TAG_enumeration_type = 0x04,
43    DW_TAG_formal_parameter = 0x05,
44    DW_TAG_imported_declaration = 0x08,
45    DW_TAG_label = 0x0a,
46    DW_TAG_lexical_block = 0x0b,
47    DW_TAG_member = 0x0d,
48    DW_TAG_pointer_type = 0x0f,
49    DW_TAG_reference_type = 0x10,
50    DW_TAG_compile_unit = 0x11,
51    DW_TAG_string_type = 0x12,
52    DW_TAG_structure_type = 0x13,
53    DW_TAG_subroutine_type = 0x15,
54    DW_TAG_typedef = 0x16,
55    DW_TAG_union_type = 0x17,
56    DW_TAG_unspecified_parameters = 0x18,
57    DW_TAG_variant = 0x19,
58    DW_TAG_common_block = 0x1a,
59    DW_TAG_common_inclusion = 0x1b,
60    DW_TAG_inheritance = 0x1c,
61    DW_TAG_inlined_subroutine = 0x1d,
62    DW_TAG_module = 0x1e,
63    DW_TAG_ptr_to_member_type = 0x1f,
64    DW_TAG_set_type = 0x20,
65    DW_TAG_subrange_type = 0x21,
66    DW_TAG_with_stmt = 0x22,
67    DW_TAG_access_declaration = 0x23,
68    DW_TAG_base_type = 0x24,
69    DW_TAG_catch_block = 0x25,
70    DW_TAG_const_type = 0x26,
71    DW_TAG_constant = 0x27,
72    DW_TAG_enumerator = 0x28,
73    DW_TAG_file_type = 0x29,
74    DW_TAG_friend = 0x2a,
75    DW_TAG_namelist = 0x2b,
76    DW_TAG_namelist_item = 0x2c,
77    DW_TAG_packed_type = 0x2d,
78    DW_TAG_subprogram = 0x2e,
79    DW_TAG_template_type_param = 0x2f,
80    DW_TAG_template_value_param = 0x30,
81    DW_TAG_thrown_type = 0x31,
82    DW_TAG_try_block = 0x32,
83    DW_TAG_variant_part = 0x33,
84    DW_TAG_variable = 0x34,
85    DW_TAG_volatile_type = 0x35,
86    /* SGI/MIPS Extensions */
87    DW_TAG_MIPS_loop = 0x4081,
88    /* GNU extensions */
89    DW_TAG_format_label = 0x4101,	/* for FORTRAN 77 and Fortran 90 */
90    DW_TAG_function_template = 0x4102,	/* for C++ */
91    DW_TAG_class_template = 0x4103	/* for C++ */
92  };
93
94#define DW_TAG_lo_user	0x4080
95#define DW_TAG_hi_user	0xffff
96
97/* flag that tells whether entry has a child or not */
98#define DW_children_no   0
99#define	DW_children_yes  1
100
101/* Form names and codes.  */
102enum dwarf_form
103  {
104    DW_FORM_addr = 0x01,
105    DW_FORM_block2 = 0x03,
106    DW_FORM_block4 = 0x04,
107    DW_FORM_data2 = 0x05,
108    DW_FORM_data4 = 0x06,
109    DW_FORM_data8 = 0x07,
110    DW_FORM_string = 0x08,
111    DW_FORM_block = 0x09,
112    DW_FORM_block1 = 0x0a,
113    DW_FORM_data1 = 0x0b,
114    DW_FORM_flag = 0x0c,
115    DW_FORM_sdata = 0x0d,
116    DW_FORM_strp = 0x0e,
117    DW_FORM_udata = 0x0f,
118    DW_FORM_ref_addr = 0x10,
119    DW_FORM_ref1 = 0x11,
120    DW_FORM_ref2 = 0x12,
121    DW_FORM_ref4 = 0x13,
122    DW_FORM_ref8 = 0x14,
123    DW_FORM_ref_udata = 0x15,
124    DW_FORM_indirect = 0x16
125  };
126
127/* Attribute names and codes.  */
128
129enum dwarf_attribute
130  {
131    DW_AT_sibling = 0x01,
132    DW_AT_location = 0x02,
133    DW_AT_name = 0x03,
134    DW_AT_ordering = 0x09,
135    DW_AT_subscr_data = 0x0a,
136    DW_AT_byte_size = 0x0b,
137    DW_AT_bit_offset = 0x0c,
138    DW_AT_bit_size = 0x0d,
139    DW_AT_element_list = 0x0f,
140    DW_AT_stmt_list = 0x10,
141    DW_AT_low_pc = 0x11,
142    DW_AT_high_pc = 0x12,
143    DW_AT_language = 0x13,
144    DW_AT_member = 0x14,
145    DW_AT_discr = 0x15,
146    DW_AT_discr_value = 0x16,
147    DW_AT_visibility = 0x17,
148    DW_AT_import = 0x18,
149    DW_AT_string_length = 0x19,
150    DW_AT_common_reference = 0x1a,
151    DW_AT_comp_dir = 0x1b,
152    DW_AT_const_value = 0x1c,
153    DW_AT_containing_type = 0x1d,
154    DW_AT_default_value = 0x1e,
155    DW_AT_inline = 0x20,
156    DW_AT_is_optional = 0x21,
157    DW_AT_lower_bound = 0x22,
158    DW_AT_producer = 0x25,
159    DW_AT_prototyped = 0x27,
160    DW_AT_return_addr = 0x2a,
161    DW_AT_start_scope = 0x2c,
162    DW_AT_stride_size = 0x2e,
163    DW_AT_upper_bound = 0x2f,
164    DW_AT_abstract_origin = 0x31,
165    DW_AT_accessibility = 0x32,
166    DW_AT_address_class = 0x33,
167    DW_AT_artificial = 0x34,
168    DW_AT_base_types = 0x35,
169    DW_AT_calling_convention = 0x36,
170    DW_AT_count = 0x37,
171    DW_AT_data_member_location = 0x38,
172    DW_AT_decl_column = 0x39,
173    DW_AT_decl_file = 0x3a,
174    DW_AT_decl_line = 0x3b,
175    DW_AT_declaration = 0x3c,
176    DW_AT_discr_list = 0x3d,
177    DW_AT_encoding = 0x3e,
178    DW_AT_external = 0x3f,
179    DW_AT_frame_base = 0x40,
180    DW_AT_friend = 0x41,
181    DW_AT_identifier_case = 0x42,
182    DW_AT_macro_info = 0x43,
183    DW_AT_namelist_items = 0x44,
184    DW_AT_priority = 0x45,
185    DW_AT_segment = 0x46,
186    DW_AT_specification = 0x47,
187    DW_AT_static_link = 0x48,
188    DW_AT_type = 0x49,
189    DW_AT_use_location = 0x4a,
190    DW_AT_variable_parameter = 0x4b,
191    DW_AT_virtuality = 0x4c,
192    DW_AT_vtable_elem_location = 0x4d,
193    /* SGI/MIPS Extensions */
194    DW_AT_MIPS_fde = 0x2001,
195    DW_AT_MIPS_loop_begin = 0x2002,
196    DW_AT_MIPS_tail_loop_begin = 0x2003,
197    DW_AT_MIPS_epilog_begin = 0x2004,
198    DW_AT_MIPS_loop_unroll_factor = 0x2005,
199    DW_AT_MIPS_software_pipeline_depth = 0x2006,
200    DW_AT_MIPS_linkage_name = 0x2007,
201    DW_AT_MIPS_stride = 0x2008,
202    DW_AT_MIPS_abstract_name = 0x2009,
203    DW_AT_MIPS_clone_origin = 0x200a,
204    DW_AT_MIPS_has_inlines = 0x200b,
205    /* GNU extensions.  */
206    DW_AT_sf_names = 0x2101,
207    DW_AT_src_info = 0x2102,
208    DW_AT_mac_info = 0x2103,
209    DW_AT_src_coords = 0x2104,
210    DW_AT_body_begin = 0x2105,
211    DW_AT_body_end = 0x2106
212  };
213
214#define DW_AT_lo_user	0x2000	/* implementation-defined range start */
215#define DW_AT_hi_user	0x3ff0	/* implementation-defined range end */
216
217/* Location atom names and codes.  */
218
219enum dwarf_location_atom
220  {
221    DW_OP_addr = 0x03,
222    DW_OP_deref = 0x06,
223    DW_OP_const1u = 0x08,
224    DW_OP_const1s = 0x09,
225    DW_OP_const2u = 0x0a,
226    DW_OP_const2s = 0x0b,
227    DW_OP_const4u = 0x0c,
228    DW_OP_const4s = 0x0d,
229    DW_OP_const8u = 0x0e,
230    DW_OP_const8s = 0x0f,
231    DW_OP_constu = 0x10,
232    DW_OP_consts = 0x11,
233    DW_OP_dup = 0x12,
234    DW_OP_drop = 0x13,
235    DW_OP_over = 0x14,
236    DW_OP_pick = 0x15,
237    DW_OP_swap = 0x16,
238    DW_OP_rot = 0x17,
239    DW_OP_xderef = 0x18,
240    DW_OP_abs = 0x19,
241    DW_OP_and = 0x1a,
242    DW_OP_div = 0x1b,
243    DW_OP_minus = 0x1c,
244    DW_OP_mod = 0x1d,
245    DW_OP_mul = 0x1e,
246    DW_OP_neg = 0x1f,
247    DW_OP_not = 0x20,
248    DW_OP_or = 0x21,
249    DW_OP_plus = 0x22,
250    DW_OP_plus_uconst = 0x23,
251    DW_OP_shl = 0x24,
252    DW_OP_shr = 0x25,
253    DW_OP_shra = 0x26,
254    DW_OP_xor = 0x27,
255    DW_OP_bra = 0x28,
256    DW_OP_eq = 0x29,
257    DW_OP_ge = 0x2a,
258    DW_OP_gt = 0x2b,
259    DW_OP_le = 0x2c,
260    DW_OP_lt = 0x2d,
261    DW_OP_ne = 0x2e,
262    DW_OP_skip = 0x2f,
263    DW_OP_lit0 = 0x30,
264    DW_OP_lit1 = 0x31,
265    DW_OP_lit2 = 0x32,
266    DW_OP_lit3 = 0x33,
267    DW_OP_lit4 = 0x34,
268    DW_OP_lit5 = 0x35,
269    DW_OP_lit6 = 0x36,
270    DW_OP_lit7 = 0x37,
271    DW_OP_lit8 = 0x38,
272    DW_OP_lit9 = 0x39,
273    DW_OP_lit10 = 0x3a,
274    DW_OP_lit11 = 0x3b,
275    DW_OP_lit12 = 0x3c,
276    DW_OP_lit13 = 0x3d,
277    DW_OP_lit14 = 0x3e,
278    DW_OP_lit15 = 0x3f,
279    DW_OP_lit16 = 0x40,
280    DW_OP_lit17 = 0x41,
281    DW_OP_lit18 = 0x42,
282    DW_OP_lit19 = 0x43,
283    DW_OP_lit20 = 0x44,
284    DW_OP_lit21 = 0x45,
285    DW_OP_lit22 = 0x46,
286    DW_OP_lit23 = 0x47,
287    DW_OP_lit24 = 0x48,
288    DW_OP_lit25 = 0x49,
289    DW_OP_lit26 = 0x4a,
290    DW_OP_lit27 = 0x4b,
291    DW_OP_lit28 = 0x4c,
292    DW_OP_lit29 = 0x4d,
293    DW_OP_lit30 = 0x4e,
294    DW_OP_lit31 = 0x4f,
295    DW_OP_reg0 = 0x50,
296    DW_OP_reg1 = 0x51,
297    DW_OP_reg2 = 0x52,
298    DW_OP_reg3 = 0x53,
299    DW_OP_reg4 = 0x54,
300    DW_OP_reg5 = 0x55,
301    DW_OP_reg6 = 0x56,
302    DW_OP_reg7 = 0x57,
303    DW_OP_reg8 = 0x58,
304    DW_OP_reg9 = 0x59,
305    DW_OP_reg10 = 0x5a,
306    DW_OP_reg11 = 0x5b,
307    DW_OP_reg12 = 0x5c,
308    DW_OP_reg13 = 0x5d,
309    DW_OP_reg14 = 0x5e,
310    DW_OP_reg15 = 0x5f,
311    DW_OP_reg16 = 0x60,
312    DW_OP_reg17 = 0x61,
313    DW_OP_reg18 = 0x62,
314    DW_OP_reg19 = 0x63,
315    DW_OP_reg20 = 0x64,
316    DW_OP_reg21 = 0x65,
317    DW_OP_reg22 = 0x66,
318    DW_OP_reg23 = 0x67,
319    DW_OP_reg24 = 0x68,
320    DW_OP_reg25 = 0x69,
321    DW_OP_reg26 = 0x6a,
322    DW_OP_reg27 = 0x6b,
323    DW_OP_reg28 = 0x6c,
324    DW_OP_reg29 = 0x6d,
325    DW_OP_reg30 = 0x6e,
326    DW_OP_reg31 = 0x6f,
327    DW_OP_breg0 = 0x70,
328    DW_OP_breg1 = 0x71,
329    DW_OP_breg2 = 0x72,
330    DW_OP_breg3 = 0x73,
331    DW_OP_breg4 = 0x74,
332    DW_OP_breg5 = 0x75,
333    DW_OP_breg6 = 0x76,
334    DW_OP_breg7 = 0x77,
335    DW_OP_breg8 = 0x78,
336    DW_OP_breg9 = 0x79,
337    DW_OP_breg10 = 0x7a,
338    DW_OP_breg11 = 0x7b,
339    DW_OP_breg12 = 0x7c,
340    DW_OP_breg13 = 0x7d,
341    DW_OP_breg14 = 0x7e,
342    DW_OP_breg15 = 0x7f,
343    DW_OP_breg16 = 0x80,
344    DW_OP_breg17 = 0x81,
345    DW_OP_breg18 = 0x82,
346    DW_OP_breg19 = 0x83,
347    DW_OP_breg20 = 0x84,
348    DW_OP_breg21 = 0x85,
349    DW_OP_breg22 = 0x86,
350    DW_OP_breg23 = 0x87,
351    DW_OP_breg24 = 0x88,
352    DW_OP_breg25 = 0x89,
353    DW_OP_breg26 = 0x8a,
354    DW_OP_breg27 = 0x8b,
355    DW_OP_breg28 = 0x8c,
356    DW_OP_breg29 = 0x8d,
357    DW_OP_breg30 = 0x8e,
358    DW_OP_breg31 = 0x8f,
359    DW_OP_regx = 0x90,
360    DW_OP_fbreg = 0x91,
361    DW_OP_bregx = 0x92,
362    DW_OP_piece = 0x93,
363    DW_OP_deref_size = 0x94,
364    DW_OP_xderef_size = 0x95,
365    DW_OP_nop = 0x96
366  };
367
368#define DW_OP_lo_user	0x80	/* implementation-defined range start */
369#define DW_OP_hi_user	0xff	/* implementation-defined range end */
370
371/* Type encodings.  */
372
373enum dwarf_type
374  {
375    DW_ATE_void = 0x0,
376    DW_ATE_address = 0x1,
377    DW_ATE_boolean = 0x2,
378    DW_ATE_complex_float = 0x3,
379    DW_ATE_float = 0x4,
380    DW_ATE_signed = 0x5,
381    DW_ATE_signed_char = 0x6,
382    DW_ATE_unsigned = 0x7,
383    DW_ATE_unsigned_char = 0x8
384  };
385
386#define	DW_ATE_lo_user 0x80
387#define	DW_ATE_hi_user 0xff
388
389/* Array ordering names and codes.  */
390enum dwarf_array_dim_ordering
391  {
392    DW_ORD_row_major = 0,
393    DW_ORD_col_major = 1
394  };
395
396/* access attribute */
397enum dwarf_access_attribute
398  {
399    DW_ACCESS_public = 1,
400    DW_ACCESS_protected = 2,
401    DW_ACCESS_private = 3
402  };
403
404/* visibility */
405enum dwarf_visibility_attribute
406  {
407    DW_VIS_local = 1,
408    DW_VIS_exported = 2,
409    DW_VIS_qualified = 3
410  };
411
412/* virtuality */
413enum dwarf_virtuality_attribute
414  {
415    DW_VIRTUALITY_none = 0,
416    DW_VIRTUALITY_virtual = 1,
417    DW_VIRTUALITY_pure_virtual = 2
418  };
419
420/* case sensitivity */
421enum dwarf_id_case
422  {
423    DW_ID_case_sensitive = 0,
424    DW_ID_up_case = 1,
425    DW_ID_down_case = 2,
426    DW_ID_case_insensitive = 3
427  };
428
429/* calling convention */
430enum dwarf_calling_convention
431  {
432    DW_CC_normal = 0x1,
433    DW_CC_program = 0x2,
434    DW_CC_nocall = 0x3
435  };
436
437#define DW_CC_lo_user 0x40
438#define DW_CC_hi_user 0xff
439
440/* inline attribute */
441enum dwarf_inline_attribute
442  {
443    DW_INL_not_inlined = 0,
444    DW_INL_inlined = 1,
445    DW_INL_declared_not_inlined = 2,
446    DW_INL_declared_inlined = 3
447  };
448
449/* discriminant lists */
450enum dwarf_discrim_list
451  {
452    DW_DSC_label = 0,
453    DW_DSC_range = 1
454  };
455
456/* line number opcodes */
457enum dwarf_line_number_ops
458  {
459    DW_LNS_extended_op = 0,
460    DW_LNS_copy = 1,
461    DW_LNS_advance_pc = 2,
462    DW_LNS_advance_line = 3,
463    DW_LNS_set_file = 4,
464    DW_LNS_set_column = 5,
465    DW_LNS_negate_stmt = 6,
466    DW_LNS_set_basic_block = 7,
467    DW_LNS_const_add_pc = 8,
468    DW_LNS_fixed_advance_pc = 9
469  };
470
471/* line number extended opcodes */
472enum dwarf_line_number_x_ops
473  {
474    DW_LNE_end_sequence = 1,
475    DW_LNE_set_address = 2,
476    DW_LNE_define_file = 3
477  };
478
479/* call frame information */
480enum dwarf_call_frame_info
481  {
482    DW_CFA_advance_loc = 0x40,
483    DW_CFA_offset = 0x80,
484    DW_CFA_restore = 0xc0,
485    DW_CFA_nop = 0x00,
486    DW_CFA_set_loc = 0x01,
487    DW_CFA_advance_loc1 = 0x02,
488    DW_CFA_advance_loc2 = 0x03,
489    DW_CFA_advance_loc4 = 0x04,
490    DW_CFA_offset_extended = 0x05,
491    DW_CFA_restore_extended = 0x06,
492    DW_CFA_undefined = 0x07,
493    DW_CFA_same_value = 0x08,
494    DW_CFA_register = 0x09,
495    DW_CFA_remember_state = 0x0a,
496    DW_CFA_restore_state = 0x0b,
497    DW_CFA_def_cfa = 0x0c,
498    DW_CFA_def_cfa_register = 0x0d,
499    DW_CFA_def_cfa_offset = 0x0e,
500    /* SGI/MIPS specific */
501    DW_CFA_MIPS_advance_loc8 = 0x1d,
502
503    /* GNU extensions */
504    DW_CFA_GNU_window_save = 0x2d,
505    DW_CFA_GNU_args_size = 0x2e,
506    DW_CFA_GNU_negative_offset_extended = 0x2f
507  };
508
509#define DW_CIE_ID	  0xffffffff
510#define DW_CIE_VERSION	  1
511
512#define DW_CFA_extended   0
513#define DW_CFA_low_user   0x1c
514#define DW_CFA_high_user  0x3f
515
516#define DW_CHILDREN_no		     0x00
517#define DW_CHILDREN_yes		     0x01
518
519#define DW_ADDR_none		0
520
521/* Source language names and codes.  */
522
523enum dwarf_source_language
524  {
525    DW_LANG_C89 = 0x0001,
526    DW_LANG_C = 0x0002,
527    DW_LANG_Ada83 = 0x0003,
528    DW_LANG_C_plus_plus = 0x0004,
529    DW_LANG_Cobol74 = 0x0005,
530    DW_LANG_Cobol85 = 0x0006,
531    DW_LANG_Fortran77 = 0x0007,
532    DW_LANG_Fortran90 = 0x0008,
533    DW_LANG_Pascal83 = 0x0009,
534    DW_LANG_Modula2 = 0x000a,
535    DW_LANG_Mips_Assembler = 0x8001
536  };
537
538
539#define DW_LANG_lo_user 0x8000	/* implementation-defined range start */
540#define DW_LANG_hi_user 0xffff	/* implementation-defined range start */
541
542/* Names and codes for macro information.  */
543
544enum dwarf_macinfo_record_type
545  {
546    DW_MACINFO_define = 1,
547    DW_MACINFO_undef = 2,
548    DW_MACINFO_start_file = 3,
549    DW_MACINFO_end_file = 4,
550    DW_MACINFO_vendor_ext = 255
551  };
552