1 /* Declarations and definitions of codes relating to the DWARF2 symbolic
2 debugging information format.
3 Copyright (C) 1992, 1993, 1995, 1996, 1997, 1999, 2000, 2001, 2002,
4 2003, 2004 Free Software Foundation, Inc.
6 Written by Gary Funck (gary@intrepid.com) The Ada Joint Program
7 Office (AJPO), Florida State University and Silicon Graphics Inc.
8 provided support for this effort -- June 21, 1995.
10 Derived from the DWARF 1 implementation written by Ron Guilmette
11 (rfg@netcom.com), November 1990.
13 This file is part of GCC.
15 GCC is free software; you can redistribute it and/or modify it under
16 the terms of the GNU General Public License as published by the Free
17 Software Foundation; either version 2, or (at your option) any later
20 GCC is distributed in the hope that it will be useful, but WITHOUT
21 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
22 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
23 License for more details.
25 You should have received a copy of the GNU General Public License
26 along with GCC; see the file COPYING. If not, write to the Free
27 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
30 /* This file is derived from the DWARF specification (a public document)
31 Revision 2.0.0 (July 27, 1993) developed by the UNIX International
32 Programming Languages Special Interest Group (UI/PLSIG) and distributed
33 by UNIX International. Copies of this specification are available from
34 UNIX International, 20 Waterview Boulevard, Parsippany, NJ, 07054.
36 This file also now contains definitions from the DWARF 3 specification. */
38 /* This file is shared between GCC and GDB, and should not contain
47 /* Structure found in the .debug_line section. */
50 unsigned char li_length
[4];
51 unsigned char li_version
[2];
52 unsigned char li_prologue_length
[4];
53 unsigned char li_min_insn_length
[1];
54 unsigned char li_default_is_stmt
[1];
55 unsigned char li_line_base
[1];
56 unsigned char li_line_range
[1];
57 unsigned char li_opcode_base
[1];
59 DWARF2_External_LineInfo
;
63 unsigned long li_length
;
64 unsigned short li_version
;
65 unsigned int li_prologue_length
;
66 unsigned char li_min_insn_length
;
67 unsigned char li_default_is_stmt
;
69 unsigned char li_line_range
;
70 unsigned char li_opcode_base
;
72 DWARF2_Internal_LineInfo
;
74 /* Structure found in .debug_pubnames section. */
77 unsigned char pn_length
[4];
78 unsigned char pn_version
[2];
79 unsigned char pn_offset
[4];
80 unsigned char pn_size
[4];
82 DWARF2_External_PubNames
;
86 unsigned long pn_length
;
87 unsigned short pn_version
;
88 unsigned long pn_offset
;
89 unsigned long pn_size
;
91 DWARF2_Internal_PubNames
;
93 /* Structure found in .debug_info section. */
96 unsigned char cu_length
[4];
97 unsigned char cu_version
[2];
98 unsigned char cu_abbrev_offset
[4];
99 unsigned char cu_pointer_size
[1];
101 DWARF2_External_CompUnit
;
105 unsigned long cu_length
;
106 unsigned short cu_version
;
107 unsigned long cu_abbrev_offset
;
108 unsigned char cu_pointer_size
;
110 DWARF2_Internal_CompUnit
;
114 unsigned char ar_length
[4];
115 unsigned char ar_version
[2];
116 unsigned char ar_info_offset
[4];
117 unsigned char ar_pointer_size
[1];
118 unsigned char ar_segment_size
[1];
120 DWARF2_External_ARange
;
124 unsigned long ar_length
;
125 unsigned short ar_version
;
126 unsigned long ar_info_offset
;
127 unsigned char ar_pointer_size
;
128 unsigned char ar_segment_size
;
130 DWARF2_Internal_ARange
;
133 /* Tag names and codes. */
136 DW_TAG_padding
= 0x00,
137 DW_TAG_array_type
= 0x01,
138 DW_TAG_class_type
= 0x02,
139 DW_TAG_entry_point
= 0x03,
140 DW_TAG_enumeration_type
= 0x04,
141 DW_TAG_formal_parameter
= 0x05,
142 DW_TAG_imported_declaration
= 0x08,
144 DW_TAG_lexical_block
= 0x0b,
145 DW_TAG_member
= 0x0d,
146 DW_TAG_pointer_type
= 0x0f,
147 DW_TAG_reference_type
= 0x10,
148 DW_TAG_compile_unit
= 0x11,
149 DW_TAG_string_type
= 0x12,
150 DW_TAG_structure_type
= 0x13,
151 DW_TAG_subroutine_type
= 0x15,
152 DW_TAG_typedef
= 0x16,
153 DW_TAG_union_type
= 0x17,
154 DW_TAG_unspecified_parameters
= 0x18,
155 DW_TAG_variant
= 0x19,
156 DW_TAG_common_block
= 0x1a,
157 DW_TAG_common_inclusion
= 0x1b,
158 DW_TAG_inheritance
= 0x1c,
159 DW_TAG_inlined_subroutine
= 0x1d,
160 DW_TAG_module
= 0x1e,
161 DW_TAG_ptr_to_member_type
= 0x1f,
162 DW_TAG_set_type
= 0x20,
163 DW_TAG_subrange_type
= 0x21,
164 DW_TAG_with_stmt
= 0x22,
165 DW_TAG_access_declaration
= 0x23,
166 DW_TAG_base_type
= 0x24,
167 DW_TAG_catch_block
= 0x25,
168 DW_TAG_const_type
= 0x26,
169 DW_TAG_constant
= 0x27,
170 DW_TAG_enumerator
= 0x28,
171 DW_TAG_file_type
= 0x29,
172 DW_TAG_friend
= 0x2a,
173 DW_TAG_namelist
= 0x2b,
174 DW_TAG_namelist_item
= 0x2c,
175 DW_TAG_packed_type
= 0x2d,
176 DW_TAG_subprogram
= 0x2e,
177 DW_TAG_template_type_param
= 0x2f,
178 DW_TAG_template_value_param
= 0x30,
179 DW_TAG_thrown_type
= 0x31,
180 DW_TAG_try_block
= 0x32,
181 DW_TAG_variant_part
= 0x33,
182 DW_TAG_variable
= 0x34,
183 DW_TAG_volatile_type
= 0x35,
185 DW_TAG_dwarf_procedure
= 0x36,
186 DW_TAG_restrict_type
= 0x37,
187 DW_TAG_interface_type
= 0x38,
188 DW_TAG_namespace
= 0x39,
189 DW_TAG_imported_module
= 0x3a,
190 DW_TAG_unspecified_type
= 0x3b,
191 DW_TAG_partial_unit
= 0x3c,
192 DW_TAG_imported_unit
= 0x3d,
193 /* SGI/MIPS Extensions. */
194 DW_TAG_MIPS_loop
= 0x4081,
195 /* HP extensions. See: ftp://ftp.hp.com/pub/lang/tools/WDB/wdb-4.0.tar.gz . */
196 DW_TAG_HP_array_descriptor
= 0x4090,
197 /* GNU extensions. */
198 DW_TAG_format_label
= 0x4101, /* For FORTRAN 77 and Fortran 90. */
199 DW_TAG_function_template
= 0x4102, /* For C++. */
200 DW_TAG_class_template
= 0x4103, /* For C++. */
201 DW_TAG_GNU_BINCL
= 0x4104,
202 DW_TAG_GNU_EINCL
= 0x4105,
203 /* Extensions for UPC. See: http://upc.gwu.edu/~upc. */
204 DW_TAG_upc_shared_type
= 0x8765,
205 DW_TAG_upc_strict_type
= 0x8766,
206 DW_TAG_upc_relaxed_type
= 0x8767,
207 /* PGI (STMicroelectronics) extensions. No documentation available. */
208 DW_TAG_PGI_kanji_type
= 0xA000,
209 DW_TAG_PGI_interface_block
= 0xA020
212 #define DW_TAG_lo_user 0x4080
213 #define DW_TAG_hi_user 0xffff
215 /* Flag that tells whether entry has a child or not. */
216 #define DW_children_no 0
217 #define DW_children_yes 1
219 /* Form names and codes. */
223 DW_FORM_block2
= 0x03,
224 DW_FORM_block4
= 0x04,
225 DW_FORM_data2
= 0x05,
226 DW_FORM_data4
= 0x06,
227 DW_FORM_data8
= 0x07,
228 DW_FORM_string
= 0x08,
229 DW_FORM_block
= 0x09,
230 DW_FORM_block1
= 0x0a,
231 DW_FORM_data1
= 0x0b,
233 DW_FORM_sdata
= 0x0d,
235 DW_FORM_udata
= 0x0f,
236 DW_FORM_ref_addr
= 0x10,
241 DW_FORM_ref_udata
= 0x15,
242 DW_FORM_indirect
= 0x16
245 /* Attribute names and codes. */
248 DW_AT_sibling
= 0x01,
249 DW_AT_location
= 0x02,
251 DW_AT_ordering
= 0x09,
252 DW_AT_subscr_data
= 0x0a,
253 DW_AT_byte_size
= 0x0b,
254 DW_AT_bit_offset
= 0x0c,
255 DW_AT_bit_size
= 0x0d,
256 DW_AT_element_list
= 0x0f,
257 DW_AT_stmt_list
= 0x10,
259 DW_AT_high_pc
= 0x12,
260 DW_AT_language
= 0x13,
263 DW_AT_discr_value
= 0x16,
264 DW_AT_visibility
= 0x17,
266 DW_AT_string_length
= 0x19,
267 DW_AT_common_reference
= 0x1a,
268 DW_AT_comp_dir
= 0x1b,
269 DW_AT_const_value
= 0x1c,
270 DW_AT_containing_type
= 0x1d,
271 DW_AT_default_value
= 0x1e,
273 DW_AT_is_optional
= 0x21,
274 DW_AT_lower_bound
= 0x22,
275 DW_AT_producer
= 0x25,
276 DW_AT_prototyped
= 0x27,
277 DW_AT_return_addr
= 0x2a,
278 DW_AT_start_scope
= 0x2c,
279 DW_AT_stride_size
= 0x2e,
280 DW_AT_upper_bound
= 0x2f,
281 DW_AT_abstract_origin
= 0x31,
282 DW_AT_accessibility
= 0x32,
283 DW_AT_address_class
= 0x33,
284 DW_AT_artificial
= 0x34,
285 DW_AT_base_types
= 0x35,
286 DW_AT_calling_convention
= 0x36,
288 DW_AT_data_member_location
= 0x38,
289 DW_AT_decl_column
= 0x39,
290 DW_AT_decl_file
= 0x3a,
291 DW_AT_decl_line
= 0x3b,
292 DW_AT_declaration
= 0x3c,
293 DW_AT_discr_list
= 0x3d,
294 DW_AT_encoding
= 0x3e,
295 DW_AT_external
= 0x3f,
296 DW_AT_frame_base
= 0x40,
298 DW_AT_identifier_case
= 0x42,
299 DW_AT_macro_info
= 0x43,
300 DW_AT_namelist_items
= 0x44,
301 DW_AT_priority
= 0x45,
302 DW_AT_segment
= 0x46,
303 DW_AT_specification
= 0x47,
304 DW_AT_static_link
= 0x48,
306 DW_AT_use_location
= 0x4a,
307 DW_AT_variable_parameter
= 0x4b,
308 DW_AT_virtuality
= 0x4c,
309 DW_AT_vtable_elem_location
= 0x4d,
310 /* DWARF 3 values. */
311 DW_AT_allocated
= 0x4e,
312 DW_AT_associated
= 0x4f,
313 DW_AT_data_location
= 0x50,
315 DW_AT_entry_pc
= 0x52,
316 DW_AT_use_UTF8
= 0x53,
317 DW_AT_extension
= 0x54,
319 DW_AT_trampoline
= 0x56,
320 DW_AT_call_column
= 0x57,
321 DW_AT_call_file
= 0x58,
322 DW_AT_call_line
= 0x59,
323 /* SGI/MIPS extensions. */
324 DW_AT_MIPS_fde
= 0x2001,
325 DW_AT_MIPS_loop_begin
= 0x2002,
326 DW_AT_MIPS_tail_loop_begin
= 0x2003,
327 DW_AT_MIPS_epilog_begin
= 0x2004,
328 DW_AT_MIPS_loop_unroll_factor
= 0x2005,
329 DW_AT_MIPS_software_pipeline_depth
= 0x2006,
330 DW_AT_MIPS_linkage_name
= 0x2007,
331 DW_AT_MIPS_stride
= 0x2008,
332 DW_AT_MIPS_abstract_name
= 0x2009,
333 DW_AT_MIPS_clone_origin
= 0x200a,
334 DW_AT_MIPS_has_inlines
= 0x200b,
336 DW_AT_HP_block_index
= 0x2000,
337 DW_AT_HP_unmodifiable
= 0x2001, /* Same as DW_AT_MIPS_fde. */
338 DW_AT_HP_actuals_stmt_list
= 0x2010,
339 DW_AT_HP_proc_per_section
= 0x2011,
340 DW_AT_HP_raw_data_ptr
= 0x2012,
341 DW_AT_HP_pass_by_reference
= 0x2013,
342 DW_AT_HP_opt_level
= 0x2014,
343 DW_AT_HP_prof_version_id
= 0x2015,
344 DW_AT_HP_opt_flags
= 0x2016,
345 DW_AT_HP_cold_region_low_pc
= 0x2017,
346 DW_AT_HP_cold_region_high_pc
= 0x2018,
347 DW_AT_HP_all_variables_modifiable
= 0x2019,
348 DW_AT_HP_linkage_name
= 0x201a,
349 DW_AT_HP_prof_flags
= 0x201b, /* In comp unit of procs_info for -g. */
350 /* GNU extensions. */
351 DW_AT_sf_names
= 0x2101,
352 DW_AT_src_info
= 0x2102,
353 DW_AT_mac_info
= 0x2103,
354 DW_AT_src_coords
= 0x2104,
355 DW_AT_body_begin
= 0x2105,
356 DW_AT_body_end
= 0x2106,
357 DW_AT_GNU_vector
= 0x2107,
358 /* VMS extensions. */
359 DW_AT_VMS_rtnbeg_pd_address
= 0x2201,
361 DW_AT_upc_threads_scaled
= 0x3210,
362 /* PGI (STMicroelectronics) extensions. */
363 DW_AT_PGI_lbase
= 0x3a00,
364 DW_AT_PGI_soffset
= 0x3a01,
365 DW_AT_PGI_lstride
= 0x3a02
368 #define DW_AT_lo_user 0x2000 /* Implementation-defined range start. */
369 #define DW_AT_hi_user 0x3ff0 /* Implementation-defined range end. */
371 /* Location atom names and codes. */
372 enum dwarf_location_atom
376 DW_OP_const1u
= 0x08,
377 DW_OP_const1s
= 0x09,
378 DW_OP_const2u
= 0x0a,
379 DW_OP_const2s
= 0x0b,
380 DW_OP_const4u
= 0x0c,
381 DW_OP_const4s
= 0x0d,
382 DW_OP_const8u
= 0x0e,
383 DW_OP_const8s
= 0x0f,
403 DW_OP_plus_uconst
= 0x23,
516 DW_OP_deref_size
= 0x94,
517 DW_OP_xderef_size
= 0x95,
519 /* DWARF 3 extensions. */
520 DW_OP_push_object_address
= 0x97,
523 DW_OP_call_ref
= 0x9a,
524 /* GNU extensions. */
525 DW_OP_GNU_push_tls_address
= 0xe0,
527 DW_OP_HP_unknown
= 0xe0, /* Ouch, the same as GNU_push_tls_address. */
528 DW_OP_HP_is_value
= 0xe1,
529 DW_OP_HP_fltconst4
= 0xe2,
530 DW_OP_HP_fltconst8
= 0xe3,
531 DW_OP_HP_mod_range
= 0xe4,
532 DW_OP_HP_unmod_range
= 0xe5,
536 #define DW_OP_lo_user 0xe0 /* Implementation-defined range start. */
537 #define DW_OP_hi_user 0xff /* Implementation-defined range end. */
539 /* Type encodings. */
543 DW_ATE_address
= 0x1,
544 DW_ATE_boolean
= 0x2,
545 DW_ATE_complex_float
= 0x3,
548 DW_ATE_signed_char
= 0x6,
549 DW_ATE_unsigned
= 0x7,
550 DW_ATE_unsigned_char
= 0x8,
552 DW_ATE_imaginary_float
= 0x9,
554 DW_ATE_HP_float80
= 0x80, /* Floating-point (80 bit). */
555 DW_ATE_HP_complex_float80
= 0x81, /* Complex floating-point (80 bit). */
556 DW_ATE_HP_float128
= 0x82, /* Floating-point (128 bit). */
557 DW_ATE_HP_complex_float128
= 0x83, /* Complex floating-point (128 bit). */
558 DW_ATE_HP_floathpintel
= 0x84, /* Floating-point (82 bit IA64). */
559 DW_ATE_HP_imaginary_float80
= 0x85,
560 DW_ATE_HP_imaginary_float128
= 0x86
563 #define DW_ATE_lo_user 0x80
564 #define DW_ATE_hi_user 0xff
566 /* Array ordering names and codes. */
567 enum dwarf_array_dim_ordering
569 DW_ORD_row_major
= 0,
573 /* Access attribute. */
574 enum dwarf_access_attribute
576 DW_ACCESS_public
= 1,
577 DW_ACCESS_protected
= 2,
578 DW_ACCESS_private
= 3
582 enum dwarf_visibility_attribute
590 enum dwarf_virtuality_attribute
592 DW_VIRTUALITY_none
= 0,
593 DW_VIRTUALITY_virtual
= 1,
594 DW_VIRTUALITY_pure_virtual
= 2
597 /* Case sensitivity. */
600 DW_ID_case_sensitive
= 0,
603 DW_ID_case_insensitive
= 3
606 /* Calling convention. */
607 enum dwarf_calling_convention
612 DW_CC_GNU_renesas_sh
= 0x40
615 #define DW_CC_lo_user 0x40
616 #define DW_CC_hi_user 0xff
618 /* Inline attribute. */
619 enum dwarf_inline_attribute
621 DW_INL_not_inlined
= 0,
623 DW_INL_declared_not_inlined
= 2,
624 DW_INL_declared_inlined
= 3
627 /* Discriminant lists. */
628 enum dwarf_discrim_list
634 /* Line number opcodes. */
635 enum dwarf_line_number_ops
637 DW_LNS_extended_op
= 0,
639 DW_LNS_advance_pc
= 2,
640 DW_LNS_advance_line
= 3,
642 DW_LNS_set_column
= 5,
643 DW_LNS_negate_stmt
= 6,
644 DW_LNS_set_basic_block
= 7,
645 DW_LNS_const_add_pc
= 8,
646 DW_LNS_fixed_advance_pc
= 9,
648 DW_LNS_set_prologue_end
= 10,
649 DW_LNS_set_epilogue_begin
= 11,
653 /* Line number extended opcodes. */
654 enum dwarf_line_number_x_ops
656 DW_LNE_end_sequence
= 1,
657 DW_LNE_set_address
= 2,
658 DW_LNE_define_file
= 3,
660 DW_LNE_HP_negate_is_UV_update
= 0x11,
661 DW_LNE_HP_push_context
= 0x12,
662 DW_LNE_HP_pop_context
= 0x13,
663 DW_LNE_HP_set_file_line_column
= 0x14,
664 DW_LNE_HP_set_routine_name
= 0x15,
665 DW_LNE_HP_set_sequence
= 0x16,
666 DW_LNE_HP_negate_post_semantics
= 0x17,
667 DW_LNE_HP_negate_function_exit
= 0x18,
668 DW_LNE_HP_negate_front_end_logical
= 0x19,
669 DW_LNE_HP_define_proc
= 0x20
672 /* Call frame information. */
673 enum dwarf_call_frame_info
675 DW_CFA_advance_loc
= 0x40,
676 DW_CFA_offset
= 0x80,
677 DW_CFA_restore
= 0xc0,
679 DW_CFA_set_loc
= 0x01,
680 DW_CFA_advance_loc1
= 0x02,
681 DW_CFA_advance_loc2
= 0x03,
682 DW_CFA_advance_loc4
= 0x04,
683 DW_CFA_offset_extended
= 0x05,
684 DW_CFA_restore_extended
= 0x06,
685 DW_CFA_undefined
= 0x07,
686 DW_CFA_same_value
= 0x08,
687 DW_CFA_register
= 0x09,
688 DW_CFA_remember_state
= 0x0a,
689 DW_CFA_restore_state
= 0x0b,
690 DW_CFA_def_cfa
= 0x0c,
691 DW_CFA_def_cfa_register
= 0x0d,
692 DW_CFA_def_cfa_offset
= 0x0e,
694 DW_CFA_def_cfa_expression
= 0x0f,
695 DW_CFA_expression
= 0x10,
696 DW_CFA_offset_extended_sf
= 0x11,
697 DW_CFA_def_cfa_sf
= 0x12,
698 DW_CFA_def_cfa_offset_sf
= 0x13,
699 /* SGI/MIPS specific. */
700 DW_CFA_MIPS_advance_loc8
= 0x1d,
701 /* GNU extensions. */
702 DW_CFA_GNU_window_save
= 0x2d,
703 DW_CFA_GNU_args_size
= 0x2e,
704 DW_CFA_GNU_negative_offset_extended
= 0x2f
707 #define DW_CIE_ID 0xffffffff
708 #define DW_CIE_VERSION 1
710 #define DW_CFA_extended 0
711 #define DW_CFA_lo_user 0x1c
712 #define DW_CFA_hi_user 0x3f
714 #define DW_CHILDREN_no 0x00
715 #define DW_CHILDREN_yes 0x01
717 #define DW_ADDR_none 0
719 /* Source language names and codes. */
720 enum dwarf_source_language
722 DW_LANG_C89
= 0x0001,
724 DW_LANG_Ada83
= 0x0003,
725 DW_LANG_C_plus_plus
= 0x0004,
726 DW_LANG_Cobol74
= 0x0005,
727 DW_LANG_Cobol85
= 0x0006,
728 DW_LANG_Fortran77
= 0x0007,
729 DW_LANG_Fortran90
= 0x0008,
730 DW_LANG_Pascal83
= 0x0009,
731 DW_LANG_Modula2
= 0x000a,
732 DW_LANG_Java
= 0x000b,
734 DW_LANG_C99
= 0x000c,
735 DW_LANG_Ada95
= 0x000d,
736 DW_LANG_Fortran95
= 0x000e,
738 DW_LANG_Mips_Assembler
= 0x8001,
743 #define DW_LANG_lo_user 0x8000 /* Implementation-defined range start. */
744 #define DW_LANG_hi_user 0xffff /* Implementation-defined range start. */
746 /* Names and codes for macro information. */
747 enum dwarf_macinfo_record_type
749 DW_MACINFO_define
= 1,
750 DW_MACINFO_undef
= 2,
751 DW_MACINFO_start_file
= 3,
752 DW_MACINFO_end_file
= 4,
753 DW_MACINFO_vendor_ext
= 255
756 /* @@@ For use with GNU frame unwind information. */
758 #define DW_EH_PE_absptr 0x00
759 #define DW_EH_PE_omit 0xff
761 #define DW_EH_PE_uleb128 0x01
762 #define DW_EH_PE_udata2 0x02
763 #define DW_EH_PE_udata4 0x03
764 #define DW_EH_PE_udata8 0x04
765 #define DW_EH_PE_sleb128 0x09
766 #define DW_EH_PE_sdata2 0x0A
767 #define DW_EH_PE_sdata4 0x0B
768 #define DW_EH_PE_sdata8 0x0C
769 #define DW_EH_PE_signed 0x08
771 #define DW_EH_PE_pcrel 0x10
772 #define DW_EH_PE_textrel 0x20
773 #define DW_EH_PE_datarel 0x30
774 #define DW_EH_PE_funcrel 0x40
775 #define DW_EH_PE_aligned 0x50
777 #define DW_EH_PE_indirect 0x80
779 /** Private definitions ***/
793 ULONG ReturnAddressRegister
;
794 ULONG AugStringLength
;
805 unsigned long Length
;
808 unsigned long PcBegin
;
809 unsigned long PcRange
;
810 unsigned long AugLength
;
815 typedef struct _CFSTATE
817 unsigned long Location
;
824 unsigned long IsUwop
;
826 } DW2CFSTATE
, *PDW2CFSTATE
;
828 #define NextCIE(p) ((void*)((char*)p + p->Length + 4))
832 #endif /* dwarf2.h */