dwarf.h revision 07dc1947c362e187fb955d283b692f8769dd5def
/*
Copyright (C) 2000,2001,2003,2004,2005,2006 Silicon Graphics, Inc. All Rights Reserved.
Portions Copyright 2002-2010 Sun Microsystems, Inc. All rights reserved.
Portions Copyright 2007-2010 David Anderson. All rights reserved.
under the terms of version 2.1 of the GNU Lesser General Public License
as published by the Free Software Foundation.
This program is distributed in the hope that it would be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Further, this software is distributed without any warranty that it is
free of the rightful claim of any third person regarding infringement
or the like. Any license provided herein, whether implied or
otherwise, applies only to this software file. Patent licenses, if
any, provided herein do not apply to combinations of this program with
other software, or any other product whatsoever.
You should have received a copy of the GNU Lesser General Public
License along with this program; if not, write the Free Software
Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston MA 02110-1301,
USA.
Contact information: Silicon Graphics, Inc., 1500 Crittenden Lane,
Mountain View, CA 94043, or:
For further information regarding this notice, see:
*/
#ifndef __DWARF_H
#define __DWARF_H
#ifdef __cplusplus
extern "C" {
#endif
/*
dwarf.h DWARF debugging information values
$Revision: 1.41 $ $Date: 2006/04/17 00:09:56 $
The comment "DWARF3" appears where there are
new entries from DWARF3 as of 2004, "DWARF3f"
where there are new entries as of the November 2005
public review document and other comments apply
where extension entries appear.
Extensions part of DWARF4 are marked DWARF4.
A few extension names have omitted the 'vendor id'
(See chapter 7, "Vendor Extensibility"). Please
always use a 'vendor id' string in extension names.
Vendors should use a vendor string in names and
whereever possible avoid duplicating values used by
other vendor extensions
*/
#define DW_TAG_array_type 0x01
#define DW_TAG_class_type 0x02
#define DW_TAG_entry_point 0x03
#define DW_TAG_enumeration_type 0x04
#define DW_TAG_formal_parameter 0x05
#define DW_TAG_imported_declaration 0x08
#define DW_TAG_label 0x0a
#define DW_TAG_lexical_block 0x0b
#define DW_TAG_member 0x0d
#define DW_TAG_pointer_type 0x0f
#define DW_TAG_reference_type 0x10
#define DW_TAG_compile_unit 0x11
#define DW_TAG_string_type 0x12
#define DW_TAG_structure_type 0x13
#define DW_TAG_subroutine_type 0x15
#define DW_TAG_typedef 0x16
#define DW_TAG_union_type 0x17
#define DW_TAG_unspecified_parameters 0x18
#define DW_TAG_variant 0x19
#define DW_TAG_common_block 0x1a
#define DW_TAG_common_inclusion 0x1b
#define DW_TAG_inheritance 0x1c
#define DW_TAG_inlined_subroutine 0x1d
#define DW_TAG_module 0x1e
#define DW_TAG_ptr_to_member_type 0x1f
#define DW_TAG_set_type 0x20
#define DW_TAG_subrange_type 0x21
#define DW_TAG_with_stmt 0x22
#define DW_TAG_access_declaration 0x23
#define DW_TAG_base_type 0x24
#define DW_TAG_catch_block 0x25
#define DW_TAG_const_type 0x26
#define DW_TAG_constant 0x27
#define DW_TAG_enumerator 0x28
#define DW_TAG_file_type 0x29
#define DW_TAG_friend 0x2a
#define DW_TAG_namelist 0x2b
/* Early releases of this header had the following
misspelled with a trailing 's' */
#define DW_TAG_packed_type 0x2d
#define DW_TAG_subprogram 0x2e
/* The DWARF2 document had two spellings of the following
two TAGs, DWARF3 specifies the longer spelling. */
#define DW_TAG_thrown_type 0x31
#define DW_TAG_try_block 0x32
#define DW_TAG_variant_part 0x33
#define DW_TAG_variable 0x34
#define DW_TAG_volatile_type 0x35
/* Do not use DW_TAG_mutable_type */
#define DW_TAG_lo_user 0x4080
#define DW_TAG_MIPS_loop 0x4081
/* HP extensions: ftp://ftp.hp.com/pub/lang/tools/WDB/wdb-4.0.tar.gz */
/* GNU extensions. The first 3 missing the GNU_. */
/* GNU extension. http://gcc.gnu.org/wiki/TemplateParmsDwarf */
/* ALTIUM extensions */
/* Starcore __mwa_circ qualifier */
/* Starcore __rev_carry qualifier */
/* M16 __rom qualifier */
/* The following 3 are extensions to support UPC */
/* PGI (STMicroelectronics) extensions. */
/* The following are SUN extensions */
#define DW_TAG_hi_user 0xffff
#define DW_children_no 0
#define DW_children_yes 1
#define DW_FORM_addr 0x01
#define DW_FORM_block2 0x03
#define DW_FORM_block4 0x04
#define DW_FORM_data2 0x05
#define DW_FORM_data4 0x06
#define DW_FORM_data8 0x07
#define DW_FORM_string 0x08
#define DW_FORM_block 0x09
#define DW_FORM_block1 0x0a
#define DW_FORM_data1 0x0b
#define DW_FORM_flag 0x0c
#define DW_FORM_sdata 0x0d
#define DW_FORM_strp 0x0e
#define DW_FORM_udata 0x0f
#define DW_FORM_ref_addr 0x10
#define DW_FORM_ref1 0x11
#define DW_FORM_ref2 0x12
#define DW_FORM_ref4 0x13
#define DW_FORM_ref8 0x14
#define DW_FORM_ref_udata 0x15
#define DW_FORM_indirect 0x16
/* 0x1a thru 0x1f were left unused accidentally. Reserved for future use. */
#define DW_AT_sibling 0x01
#define DW_AT_location 0x02
#define DW_AT_name 0x03
#define DW_AT_ordering 0x09
#define DW_AT_subscr_data 0x0a
#define DW_AT_byte_size 0x0b
#define DW_AT_bit_offset 0x0c
#define DW_AT_bit_size 0x0d
#define DW_AT_element_list 0x0f
#define DW_AT_stmt_list 0x10
#define DW_AT_low_pc 0x11
#define DW_AT_high_pc 0x12
#define DW_AT_language 0x13
#define DW_AT_member 0x14
#define DW_AT_discr 0x15
#define DW_AT_discr_value 0x16
#define DW_AT_visibility 0x17
#define DW_AT_import 0x18
#define DW_AT_string_length 0x19
#define DW_AT_common_reference 0x1a
#define DW_AT_comp_dir 0x1b
#define DW_AT_const_value 0x1c
#define DW_AT_containing_type 0x1d
#define DW_AT_default_value 0x1e
#define DW_AT_inline 0x20
#define DW_AT_is_optional 0x21
#define DW_AT_lower_bound 0x22
#define DW_AT_producer 0x25
#define DW_AT_prototyped 0x27
#define DW_AT_return_addr 0x2a
#define DW_AT_start_scope 0x2c
#define DW_AT_upper_bound 0x2f
#define DW_AT_abstract_origin 0x31
#define DW_AT_accessibility 0x32
#define DW_AT_address_class 0x33
#define DW_AT_artificial 0x34
#define DW_AT_base_types 0x35
#define DW_AT_calling_convention 0x36
#define DW_AT_count 0x37
#define DW_AT_data_member_location 0x38
#define DW_AT_decl_column 0x39
#define DW_AT_decl_file 0x3a
#define DW_AT_decl_line 0x3b
#define DW_AT_declaration 0x3c
#define DW_AT_discr_list 0x3d
#define DW_AT_encoding 0x3e
#define DW_AT_external 0x3f
#define DW_AT_frame_base 0x40
#define DW_AT_friend 0x41
#define DW_AT_identifier_case 0x42
#define DW_AT_macro_info 0x43
#define DW_AT_namelist_item 0x44
#define DW_AT_priority 0x45
#define DW_AT_segment 0x46
#define DW_AT_specification 0x47
#define DW_AT_static_link 0x48
#define DW_AT_type 0x49
#define DW_AT_use_location 0x4a
#define DW_AT_variable_parameter 0x4b
#define DW_AT_virtuality 0x4c
#define DW_AT_vtable_elem_location 0x4d
/* In extensions, we attempt to include the vendor extension
in the name even when the vendor leaves it out. */
/* HP extensions. */
/* Follows extension so dwarfdump prints the most-likely-useful name. */
#define DW_AT_lo_user 0x2000
/* HP extensions. */
/* GNU extensions. */
/* ALTIUM extension: ALTIUM Compliant location lists (flag) */
/* Sun extensions */
/* UPC extension */
/* PGI (STMicroelectronics) extensions. */
#define DW_AT_PGI_lbase 0x3a00 /* PGI. Block, constant, reference. This attribute is an ASTPLAB extension used to describe the array local base. */
#define DW_AT_PGI_soffset 0x3a01 /* PGI. Block, constant, reference. ASTPLAB adds this attribute to describe the section offset, or the offset to the first element in the dimension. */
#define DW_AT_PGI_lstride 0x3a02 /* PGI. Block, constant, reference. ASTPLAB adds this attribute to describe the linear stride or the distance between elements in the dimension. */
/* Apple Extensions for closures */
/* Apple Extensions for Objective-C runtime info */
#define DW_AT_hi_user 0x3fff
#define DW_OP_addr 0x03
#define DW_OP_deref 0x06
#define DW_OP_const1u 0x08
#define DW_OP_const1s 0x09
#define DW_OP_const2u 0x0a
#define DW_OP_const2s 0x0b
#define DW_OP_const4u 0x0c
#define DW_OP_const4s 0x0d
#define DW_OP_const8u 0x0e
#define DW_OP_const8s 0x0f
#define DW_OP_constu 0x10
#define DW_OP_consts 0x11
#define DW_OP_dup 0x12
#define DW_OP_drop 0x13
#define DW_OP_over 0x14
#define DW_OP_pick 0x15
#define DW_OP_swap 0x16
#define DW_OP_rot 0x17
#define DW_OP_xderef 0x18
#define DW_OP_abs 0x19
#define DW_OP_and 0x1a
#define DW_OP_div 0x1b
#define DW_OP_minus 0x1c
#define DW_OP_mod 0x1d
#define DW_OP_mul 0x1e
#define DW_OP_neg 0x1f
#define DW_OP_not 0x20
#define DW_OP_or 0x21
#define DW_OP_plus 0x22
#define DW_OP_plus_uconst 0x23
#define DW_OP_shl 0x24
#define DW_OP_shr 0x25
#define DW_OP_shra 0x26
#define DW_OP_xor 0x27
#define DW_OP_bra 0x28
#define DW_OP_eq 0x29
#define DW_OP_ge 0x2a
#define DW_OP_gt 0x2b
#define DW_OP_le 0x2c
#define DW_OP_lt 0x2d
#define DW_OP_ne 0x2e
#define DW_OP_skip 0x2f
#define DW_OP_lit0 0x30
#define DW_OP_lit1 0x31
#define DW_OP_lit2 0x32
#define DW_OP_lit3 0x33
#define DW_OP_lit4 0x34
#define DW_OP_lit5 0x35
#define DW_OP_lit6 0x36
#define DW_OP_lit7 0x37
#define DW_OP_lit8 0x38
#define DW_OP_lit9 0x39
#define DW_OP_lit10 0x3a
#define DW_OP_lit11 0x3b
#define DW_OP_lit12 0x3c
#define DW_OP_lit13 0x3d
#define DW_OP_lit14 0x3e
#define DW_OP_lit15 0x3f
#define DW_OP_lit16 0x40
#define DW_OP_lit17 0x41
#define DW_OP_lit18 0x42
#define DW_OP_lit19 0x43
#define DW_OP_lit20 0x44
#define DW_OP_lit21 0x45
#define DW_OP_lit22 0x46
#define DW_OP_lit23 0x47
#define DW_OP_lit24 0x48
#define DW_OP_lit25 0x49
#define DW_OP_lit26 0x4a
#define DW_OP_lit27 0x4b
#define DW_OP_lit28 0x4c
#define DW_OP_lit29 0x4d
#define DW_OP_lit30 0x4e
#define DW_OP_lit31 0x4f
#define DW_OP_reg0 0x50
#define DW_OP_reg1 0x51
#define DW_OP_reg2 0x52
#define DW_OP_reg3 0x53
#define DW_OP_reg4 0x54
#define DW_OP_reg5 0x55
#define DW_OP_reg6 0x56
#define DW_OP_reg7 0x57
#define DW_OP_reg8 0x58
#define DW_OP_reg9 0x59
#define DW_OP_reg10 0x5a
#define DW_OP_reg11 0x5b
#define DW_OP_reg12 0x5c
#define DW_OP_reg13 0x5d
#define DW_OP_reg14 0x5e
#define DW_OP_reg15 0x5f
#define DW_OP_reg16 0x60
#define DW_OP_reg17 0x61
#define DW_OP_reg18 0x62
#define DW_OP_reg19 0x63
#define DW_OP_reg20 0x64
#define DW_OP_reg21 0x65
#define DW_OP_reg22 0x66
#define DW_OP_reg23 0x67
#define DW_OP_reg24 0x68
#define DW_OP_reg25 0x69
#define DW_OP_reg26 0x6a
#define DW_OP_reg27 0x6b
#define DW_OP_reg28 0x6c
#define DW_OP_reg29 0x6d
#define DW_OP_reg30 0x6e
#define DW_OP_reg31 0x6f
#define DW_OP_breg0 0x70
#define DW_OP_breg1 0x71
#define DW_OP_breg2 0x72
#define DW_OP_breg3 0x73
#define DW_OP_breg4 0x74
#define DW_OP_breg5 0x75
#define DW_OP_breg6 0x76
#define DW_OP_breg7 0x77
#define DW_OP_breg8 0x78
#define DW_OP_breg9 0x79
#define DW_OP_breg10 0x7a
#define DW_OP_breg11 0x7b
#define DW_OP_breg12 0x7c
#define DW_OP_breg13 0x7d
#define DW_OP_breg14 0x7e
#define DW_OP_breg15 0x7f
#define DW_OP_breg16 0x80
#define DW_OP_breg17 0x81
#define DW_OP_breg18 0x82
#define DW_OP_breg19 0x83
#define DW_OP_breg20 0x84
#define DW_OP_breg21 0x85
#define DW_OP_breg22 0x86
#define DW_OP_breg23 0x87
#define DW_OP_breg24 0x88
#define DW_OP_breg25 0x89
#define DW_OP_breg26 0x8a
#define DW_OP_breg27 0x8b
#define DW_OP_breg28 0x8c
#define DW_OP_breg29 0x8d
#define DW_OP_breg30 0x8e
#define DW_OP_breg31 0x8f
#define DW_OP_regx 0x90
#define DW_OP_fbreg 0x91
#define DW_OP_bregx 0x92
#define DW_OP_piece 0x93
#define DW_OP_deref_size 0x94
#define DW_OP_xderef_size 0x95
#define DW_OP_nop 0x96
/* GNU extensions. */
/* Follows extension so dwarfdump prints the most-likely-useful name. */
#define DW_OP_lo_user 0xe0
/* HP extensions. */
/* Apple extension. */
#define DW_OP_hi_user 0xff
#define DW_ATE_address 0x1
#define DW_ATE_boolean 0x2
#define DW_ATE_complex_float 0x3
#define DW_ATE_float 0x4
#define DW_ATE_signed 0x5
#define DW_ATE_signed_char 0x6
#define DW_ATE_unsigned 0x7
#define DW_ATE_unsigned_char 0x8
/* ALTIUM extensions. x80, x81 */
/* Follows extension so dwarfdump prints the most-likely-useful name. */
#define DW_ATE_lo_user 0x80
/* Shown here to help dwarfdump build script. */
/* HP Floating point extensions. */
/* Sun extensions */
#define DW_ATE_SUN_interval_float 0x91
#define DW_ATE_hi_user 0xff
/* Decimal Sign codes. */
/* Endian code name. */
/* For use with DW_TAG_SUN_codeflags
* If DW_TAG_SUN_codeflags is accepted as a dwarf standard, then
* standard dwarf ATCF entries start at 0x01
*/
/* Accessibility code name. */
#define DW_ACCESS_public 0x01
#define DW_ACCESS_protected 0x02
#define DW_ACCESS_private 0x03
/* Visibility code name. */
#define DW_VIS_local 0x01
#define DW_VIS_exported 0x02
#define DW_VIS_qualified 0x03
/* Virtuality code name. */
#define DW_VIRTUALITY_none 0x00
#define DW_VIRTUALITY_virtual 0x01
#define DW_VIRTUALITY_pure_virtual 0x02
#define DW_LANG_C89 0x0001
#define DW_LANG_C 0x0002
#define DW_LANG_Ada83 0x0003
#define DW_LANG_C_plus_plus 0x0004
#define DW_LANG_Cobol74 0x0005
#define DW_LANG_Cobol85 0x0006
#define DW_LANG_Fortran77 0x0007
#define DW_LANG_Fortran90 0x0008
#define DW_LANG_Pascal83 0x0009
#define DW_LANG_Modula2 0x000a
/* The following 2 are not yet formally approved October 2010, but
it seems extremely likely they will be approved as the committee
chair agrees these should be ok and no one on the committee
has objected. */
#define DW_LANG_lo_user 0x8000
DW_LANG_UPC instead. */
/* ALTIUM extension */
/* Sun extensions */
#define DW_LANG_hi_user 0xffff
/* Identifier case name. */
#define DW_ID_case_sensitive 0x00
#define DW_ID_up_case 0x01
#define DW_ID_down_case 0x02
#define DW_ID_case_insensitive 0x03
/* Calling Convention Name. */
#define DW_CC_normal 0x01
#define DW_CC_program 0x02
#define DW_CC_nocall 0x03
#define DW_CC_lo_user 0x40
/* ALTIUM extensions. */
/* Function is an interrupt handler, return address on system stack. */
/* Near function model, return address on system stack. */
/* Near function model, return address on user stack. */
/* Huge function model, return address on user stack. */
#define DW_CC_hi_user 0xff
/* Inline Code Name. */
#define DW_INL_not_inlined 0x00
#define DW_INL_inlined 0x01
#define DW_INL_declared_not_inlined 0x02
#define DW_INL_declared_inlined 0x03
/* Ordering Name. */
#define DW_ORD_row_major 0x00
#define DW_ORD_col_major 0x01
/* Discriminant Descriptor Name. */
#define DW_DSC_label 0x00
#define DW_DSC_range 0x01
/* Line number standard opcode name. */
#define DW_LNS_copy 0x01
#define DW_LNS_advance_pc 0x02
#define DW_LNS_advance_line 0x03
#define DW_LNS_set_file 0x04
#define DW_LNS_set_column 0x05
#define DW_LNS_negate_stmt 0x06
#define DW_LNS_set_basic_block 0x07
#define DW_LNS_const_add_pc 0x08
#define DW_LNS_fixed_advance_pc 0x09
/* Line number extended opcode name. */
#define DW_LNE_end_sequence 0x01
#define DW_LNE_set_address 0x02
#define DW_LNE_define_file 0x03
/* HP extensions. */
/* These are known values for DW_LNS_set_isa. */
#define DW_ISA_UNKNOWN 0
/* The following two are ARM specific. */
/* Macro information. */
#define DW_MACINFO_define 0x01
#define DW_MACINFO_undef 0x02
#define DW_MACINFO_start_file 0x03
#define DW_MACINFO_end_file 0x04
#define DW_MACINFO_vendor_ext 0xff
/* CFA operator compaction (a space saving measure, see
the DWARF standard) means DW_CFA_extended and DW_CFA_nop
have the same value here. */
#define DW_CFA_advance_loc 0x40
#define DW_CFA_offset 0x80
#define DW_CFA_restore 0xc0
#define DW_CFA_extended 0
#define DW_CFA_nop 0x00
#define DW_CFA_set_loc 0x01
#define DW_CFA_advance_loc1 0x02
#define DW_CFA_advance_loc2 0x03
#define DW_CFA_advance_loc4 0x04
#define DW_CFA_offset_extended 0x05
#define DW_CFA_restore_extended 0x06
#define DW_CFA_undefined 0x07
#define DW_CFA_same_value 0x08
#define DW_CFA_register 0x09
#define DW_CFA_remember_state 0x0a
#define DW_CFA_restore_state 0x0b
#define DW_CFA_def_cfa 0x0c
#define DW_CFA_def_cfa_register 0x0d
#define DW_CFA_def_cfa_offset 0x0e
#define DW_CFA_lo_user 0x1c
/* GNU extensions. */
#define DW_CFA_high_user 0x3f
/* GNU exception header encoding. See the Generic
Elf Specification of the Linux Standard Base (LSB).
The upper 4 bits indicate how the value is to be applied.
The lower 4 bits indicate the format of the data.
*/
/* Mapping from machine registers and pseudo-regs into the .debug_frame table.
DW_FRAME entries are machine specific. These describe
They describe a mapping from hardware register number to
the number used in the table to identify that register.
The CFA (Canonical Frame Address) described in DWARF is called
Libdwarf interfaces defined in 2008 make the
frame definitions
here (and the fixed table sizes they imply) obsolete.
They are left here for compatibility.
*/
/* Default column used for CFA in the libdwarf reader client.
Assumes reg 0 never appears as
a register in DWARF information. Usable for MIPS,
but never a good idea, really. */
#define DW_FRAME_CFA_COL 0
/* MIPS1, 2 have only some of these 64-bit registers.
** in that case, the register is considered stored after the second
** swc1.
*/
/* ***IMPORTANT NOTE, TARGET DEPENDENCY ****
The following 4 #defines are dependent on
the target cpu(s) that you apply libdwarf to.
Ensure that DW_FRAME_UNDEFINED_VAL and DW_FRAME_SAME_VAL
do not conflict with the range [0-DW_FRAME_STATIC_LINK].
The value 63 works for MIPS cpus at least up to the R16000.
For a cpu with more than 63 real registers
DW_FRAME_HIGHEST_NORMAL_REGISTER
must be increased for things to work properly!
Also ensure that DW_FRAME_UNDEFINED_VAL DW_FRAME_SAME_VAL
are not in the range [0-DW_FRAME_STATIC_LINK]
Having DW_FRAME_HIGHEST_NORMAL_REGISTER be higher than
is strictly needed is safe.
*/
#ifndef DW_FRAME_HIGHEST_NORMAL_REGISTER
#define DW_FRAME_HIGHEST_NORMAL_REGISTER 63
#endif
/* This is the number of columns in the Frame Table.
This constant should
be kept in sync with DW_REG_TABLE_SIZE defined in libdwarf.h
It must also be large enough to be beyond the highest
compiler-defined-register (meaning DW_FRAME_RA_COL DW_FRAME_STATIC_LINK
#ifndef DW_FRAME_LAST_REG_NUM
#endif
/* Column recording ra (return address from a function call).
This is common to many architectures, but as a 'simple register'
is not necessarily adequate for all architectures.
in the .debug_frame section.
*/
/* Column recording static link applicable to up-level
addressing, as in IRIX mp code, pascal, etc.
This is common to many architectures but
is not necessarily adequate for all architectures.
in the .debug_frame section.
*/
/*
DW_FRAME_UNDEFINED_VAL and DW_FRAME_SAME_VAL are
never on disk, just generated by libdwarf. See libdwarf.h
for their values.
*/
#define DW_CHILDREN_no 0x00
#define DW_CHILDREN_yes 0x01
#define DW_ADDR_none 0
#ifdef __cplusplus
}
#endif
#endif /* __DWARF_H */