| /* Declarations and definitions of codes relating to the DWARF2 and |
| DWARF3 symbolic debugging information formats. |
| Copyright (C) 1992-2024 Free Software Foundation, Inc. |
| |
| Written by Gary Funck (gary@intrepid.com) The Ada Joint Program |
| Office (AJPO), Florida State University and Silicon Graphics Inc. |
| provided support for this effort -- June 21, 1995. |
| |
| Derived from the DWARF 1 implementation written by Ron Guilmette |
| (rfg@netcom.com), November 1990. |
| |
| This file is part of GCC. |
| |
| GCC is free software; you can redistribute it and/or modify it under |
| the terms of the GNU General Public License as published by the Free |
| Software Foundation; either version 3, or (at your option) any later |
| version. |
| |
| GCC is distributed in the hope that it will be useful, but WITHOUT |
| ANY WARRANTY; without even the implied warranty of MERCHANTABILITY |
| or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public |
| License for more details. |
| |
| Under Section 7 of GPL version 3, you are granted additional |
| permissions described in the GCC Runtime Library Exception, version |
| 3.1, as published by the Free Software Foundation. |
| |
| You should have received a copy of the GNU General Public License and |
| a copy of the GCC Runtime Library Exception along with this program; |
| see the files COPYING3 and COPYING.RUNTIME respectively. If not, see |
| <http://www.gnu.org/licenses/>. */ |
| |
| /* This file is derived from the DWARF specification (a public document) |
| Revision 2.0.0 (July 27, 1993) developed by the UNIX International |
| Programming Languages Special Interest Group (UI/PLSIG) and distributed |
| by UNIX International. Copies of this specification are available from |
| UNIX International, 20 Waterview Boulevard, Parsippany, NJ, 07054. |
| |
| This file also now contains definitions from the DWARF 3 specification |
| published Dec 20, 2005, available from: http://dwarf.freestandards.org. */ |
| |
| #ifndef _DWARF2_H |
| #define _DWARF2_H |
| |
| #define DW_TAG(name, value) , name = value |
| #define DW_TAG_DUP(name, value) , name = value |
| #define DW_FORM(name, value) , name = value |
| #define DW_AT(name, value) , name = value |
| #define DW_AT_DUP(name, value) , name = value |
| #define DW_OP(name, value) , name = value |
| #define DW_OP_DUP(name, value) , name = value |
| #define DW_ATE(name, value) , name = value |
| #define DW_ATE_DUP(name, value) , name = value |
| #define DW_CFA(name, value) , name = value |
| #define DW_CFA_DUP(name, value) , name = value |
| #define DW_IDX(name, value) , name = value |
| #define DW_IDX_DUP(name, value) , name = value |
| #define DW_UT(name, value) , name = value |
| |
| #define DW_FIRST_TAG(name, value) enum dwarf_tag { \ |
| name = value |
| #define DW_END_TAG }; |
| #define DW_FIRST_FORM(name, value) enum dwarf_form { \ |
| name = value |
| #define DW_END_FORM }; |
| #define DW_FIRST_AT(name, value) enum dwarf_attribute { \ |
| name = value |
| #define DW_END_AT }; |
| #define DW_FIRST_OP(name, value) enum dwarf_location_atom { \ |
| name = value |
| #define DW_END_OP }; |
| #define DW_FIRST_ATE(name, value) enum dwarf_type { \ |
| name = value |
| #define DW_END_ATE }; |
| #define DW_FIRST_CFA(name, value) enum dwarf_call_frame_info { \ |
| name = value |
| #define DW_END_CFA }; |
| #define DW_FIRST_IDX(name, value) enum dwarf_name_index_attribute { \ |
| name = value |
| #define DW_END_IDX }; |
| #define DW_FIRST_UT(name, value) enum dwarf_unit_type { \ |
| name = value |
| #define DW_END_UT }; |
| |
| #include "dwarf2.def" |
| |
| #undef DW_FIRST_TAG |
| #undef DW_END_TAG |
| #undef DW_FIRST_FORM |
| #undef DW_END_FORM |
| #undef DW_FIRST_AT |
| #undef DW_END_AT |
| #undef DW_FIRST_OP |
| #undef DW_END_OP |
| #undef DW_FIRST_ATE |
| #undef DW_END_ATE |
| #undef DW_FIRST_CFA |
| #undef DW_END_CFA |
| #undef DW_FIRST_IDX |
| #undef DW_END_IDX |
| #undef DW_FIRST_UT |
| #undef DW_END_UT |
| |
| #undef DW_TAG |
| #undef DW_TAG_DUP |
| #undef DW_FORM |
| #undef DW_AT |
| #undef DW_AT_DUP |
| #undef DW_OP |
| #undef DW_OP_DUP |
| #undef DW_ATE |
| #undef DW_ATE_DUP |
| #undef DW_CFA |
| #undef DW_CFA_DUP |
| #undef DW_IDX |
| #undef DW_IDX_DUP |
| #undef DW_UT |
| |
| /* Flag that tells whether entry has a child or not. */ |
| #define DW_children_no 0 |
| #define DW_children_yes 1 |
| |
| #define DW_AT_stride_size DW_AT_bit_stride /* Note: The use of DW_AT_stride_size is deprecated. */ |
| #define DW_AT_stride DW_AT_byte_stride /* Note: The use of DW_AT_stride is deprecated. */ |
| |
| /* Decimal sign encodings. */ |
| enum dwarf_decimal_sign_encoding |
| { |
| /* DWARF 3. */ |
| DW_DS_unsigned = 0x01, |
| DW_DS_leading_overpunch = 0x02, |
| DW_DS_trailing_overpunch = 0x03, |
| DW_DS_leading_separate = 0x04, |
| DW_DS_trailing_separate = 0x05 |
| }; |
| |
| /* Endianity encodings. */ |
| enum dwarf_endianity_encoding |
| { |
| /* DWARF 3. */ |
| DW_END_default = 0x00, |
| DW_END_big = 0x01, |
| DW_END_little = 0x02, |
| |
| DW_END_lo_user = 0x40, |
| DW_END_hi_user = 0xff |
| }; |
| |
| /* Array ordering names and codes. */ |
| enum dwarf_array_dim_ordering |
| { |
| DW_ORD_row_major = 0, |
| DW_ORD_col_major = 1 |
| }; |
| |
| /* Access attribute. */ |
| enum dwarf_access_attribute |
| { |
| DW_ACCESS_public = 1, |
| DW_ACCESS_protected = 2, |
| DW_ACCESS_private = 3 |
| }; |
| |
| /* Visibility. */ |
| enum dwarf_visibility_attribute |
| { |
| DW_VIS_local = 1, |
| DW_VIS_exported = 2, |
| DW_VIS_qualified = 3 |
| }; |
| |
| /* Virtuality. */ |
| enum dwarf_virtuality_attribute |
| { |
| DW_VIRTUALITY_none = 0, |
| DW_VIRTUALITY_virtual = 1, |
| DW_VIRTUALITY_pure_virtual = 2 |
| }; |
| |
| /* Case sensitivity. */ |
| enum dwarf_id_case |
| { |
| DW_ID_case_sensitive = 0, |
| DW_ID_up_case = 1, |
| DW_ID_down_case = 2, |
| DW_ID_case_insensitive = 3 |
| }; |
| |
| /* Calling convention. */ |
| enum dwarf_calling_convention |
| { |
| DW_CC_normal = 0x1, |
| DW_CC_program = 0x2, |
| DW_CC_nocall = 0x3, |
| |
| /* DWARF 5. */ |
| DW_CC_pass_by_reference = 0x4, |
| DW_CC_pass_by_value = 0x5, |
| |
| DW_CC_lo_user = 0x40, |
| DW_CC_hi_user = 0xff, |
| |
| DW_CC_GNU_renesas_sh = 0x40, |
| DW_CC_GNU_borland_fastcall_i386 = 0x41, |
| |
| /* This DW_CC_ value is not currently generated by any toolchain. It is |
| used internally to GDB to indicate OpenCL C functions that have been |
| compiled with the IBM XL C for OpenCL compiler and use a non-platform |
| calling convention for passing OpenCL C vector types. This value may |
| be changed freely as long as it does not conflict with any other DW_CC_ |
| value defined here. */ |
| DW_CC_GDB_IBM_OpenCL = 0xff |
| }; |
| |
| /* Inline attribute. */ |
| enum dwarf_inline_attribute |
| { |
| DW_INL_not_inlined = 0, |
| DW_INL_inlined = 1, |
| DW_INL_declared_not_inlined = 2, |
| DW_INL_declared_inlined = 3 |
| }; |
| |
| /* Discriminant lists. */ |
| enum dwarf_discrim_list |
| { |
| DW_DSC_label = 0, |
| DW_DSC_range = 1 |
| }; |
| |
| /* Line number opcodes. */ |
| enum dwarf_line_number_ops |
| { |
| DW_LNS_extended_op = 0, |
| DW_LNS_copy = 1, |
| DW_LNS_advance_pc = 2, |
| DW_LNS_advance_line = 3, |
| DW_LNS_set_file = 4, |
| DW_LNS_set_column = 5, |
| DW_LNS_negate_stmt = 6, |
| DW_LNS_set_basic_block = 7, |
| DW_LNS_const_add_pc = 8, |
| DW_LNS_fixed_advance_pc = 9, |
| /* DWARF 3. */ |
| DW_LNS_set_prologue_end = 10, |
| DW_LNS_set_epilogue_begin = 11, |
| DW_LNS_set_isa = 12 |
| }; |
| |
| /* Line number extended opcodes. */ |
| enum dwarf_line_number_x_ops |
| { |
| DW_LNE_end_sequence = 1, |
| DW_LNE_set_address = 2, |
| DW_LNE_define_file = 3, |
| DW_LNE_set_discriminator = 4, |
| /* HP extensions. */ |
| DW_LNE_HP_negate_is_UV_update = 0x11, |
| DW_LNE_HP_push_context = 0x12, |
| DW_LNE_HP_pop_context = 0x13, |
| DW_LNE_HP_set_file_line_column = 0x14, |
| DW_LNE_HP_set_routine_name = 0x15, |
| DW_LNE_HP_set_sequence = 0x16, |
| DW_LNE_HP_negate_post_semantics = 0x17, |
| DW_LNE_HP_negate_function_exit = 0x18, |
| DW_LNE_HP_negate_front_end_logical = 0x19, |
| DW_LNE_HP_define_proc = 0x20, |
| DW_LNE_HP_source_file_correlation = 0x80, |
| |
| DW_LNE_lo_user = 0x80, |
| DW_LNE_hi_user = 0xff |
| }; |
| |
| /* Sub-opcodes for DW_LNE_HP_source_file_correlation. */ |
| enum dwarf_line_number_hp_sfc_ops |
| { |
| DW_LNE_HP_SFC_formfeed = 1, |
| DW_LNE_HP_SFC_set_listing_line = 2, |
| DW_LNE_HP_SFC_associate = 3 |
| }; |
| |
| /* Content type codes in line table directory_entry_format |
| and file_name_entry_format sequences. */ |
| enum dwarf_line_number_content_type |
| { |
| DW_LNCT_path = 0x1, |
| DW_LNCT_directory_index = 0x2, |
| DW_LNCT_timestamp = 0x3, |
| DW_LNCT_size = 0x4, |
| DW_LNCT_MD5 = 0x5, |
| DW_LNCT_lo_user = 0x2000, |
| DW_LNCT_hi_user = 0x3fff |
| }; |
| |
| /* Type codes for location list entries. */ |
| enum dwarf_location_list_entry_type |
| { |
| DW_LLE_end_of_list = 0x00, |
| DW_LLE_base_addressx = 0x01, |
| DW_LLE_startx_endx = 0x02, |
| DW_LLE_startx_length = 0x03, |
| DW_LLE_offset_pair = 0x04, |
| DW_LLE_default_location = 0x05, |
| DW_LLE_base_address = 0x06, |
| DW_LLE_start_end = 0x07, |
| DW_LLE_start_length = 0x08, |
| |
| /* <http://lists.dwarfstd.org/private.cgi/dwarf-discuss-dwarfstd.org/2017-April/004347.html> |
| has the proposal for now; only available to list members. |
| |
| A (possibly updated) copy of the proposal is available at |
| <http://people.redhat.com/aoliva/papers/sfn/dwarf6-sfn-lvu.txt>. */ |
| DW_LLE_GNU_view_pair = 0x09, |
| #define DW_LLE_view_pair DW_LLE_GNU_view_pair |
| |
| /* Former extension for Fission. |
| See http://gcc.gnu.org/wiki/DebugFission. */ |
| DW_LLE_GNU_end_of_list_entry = 0x00, |
| DW_LLE_GNU_base_address_selection_entry = 0x01, |
| DW_LLE_GNU_start_end_entry = 0x02, |
| DW_LLE_GNU_start_length_entry = 0x03 |
| }; |
| |
| #define DW_CIE_ID 0xffffffff |
| #define DW64_CIE_ID 0xffffffffffffffffULL |
| |
| #define DW_CFA_extended 0 |
| |
| #define DW_CHILDREN_no 0x00 |
| #define DW_CHILDREN_yes 0x01 |
| |
| #define DW_ADDR_none 0 |
| |
| /* Source language names and codes. */ |
| enum dwarf_source_language |
| { |
| DW_LANG_C89 = 0x0001, |
| DW_LANG_C = 0x0002, |
| DW_LANG_Ada83 = 0x0003, |
| DW_LANG_C_plus_plus = 0x0004, |
| DW_LANG_Cobol74 = 0x0005, |
| DW_LANG_Cobol85 = 0x0006, |
| DW_LANG_Fortran77 = 0x0007, |
| DW_LANG_Fortran90 = 0x0008, |
| DW_LANG_Pascal83 = 0x0009, |
| DW_LANG_Modula2 = 0x000a, |
| /* DWARF 3. */ |
| DW_LANG_Java = 0x000b, |
| DW_LANG_C99 = 0x000c, |
| DW_LANG_Ada95 = 0x000d, |
| DW_LANG_Fortran95 = 0x000e, |
| DW_LANG_PLI = 0x000f, |
| DW_LANG_ObjC = 0x0010, |
| DW_LANG_ObjC_plus_plus = 0x0011, |
| DW_LANG_UPC = 0x0012, |
| DW_LANG_D = 0x0013, |
| /* DWARF 4. */ |
| DW_LANG_Python = 0x0014, |
| /* DWARF 5. */ |
| DW_LANG_OpenCL = 0x0015, |
| DW_LANG_Go = 0x0016, |
| DW_LANG_Modula3 = 0x0017, |
| DW_LANG_Haskell = 0x0018, |
| DW_LANG_C_plus_plus_03 = 0x0019, |
| DW_LANG_C_plus_plus_11 = 0x001a, |
| DW_LANG_OCaml = 0x001b, |
| DW_LANG_Rust = 0x001c, |
| DW_LANG_C11 = 0x001d, |
| DW_LANG_Swift = 0x001e, |
| DW_LANG_Julia = 0x001f, |
| DW_LANG_Dylan = 0x0020, |
| DW_LANG_C_plus_plus_14 = 0x0021, |
| DW_LANG_Fortran03 = 0x0022, |
| DW_LANG_Fortran08 = 0x0023, |
| DW_LANG_RenderScript = 0x0024, |
| DW_LANG_BLISS = 0x0025, |
| DW_LANG_Kotlin = 0x0026, |
| DW_LANG_Zig = 0x0027, |
| DW_LANG_Crystal = 0x0028, |
| DW_LANG_C_plus_plus_17 = 0x002a, |
| DW_LANG_C_plus_plus_20 = 0x002b, |
| DW_LANG_C17 = 0x002c, |
| DW_LANG_Fortran18 = 0x002d, |
| DW_LANG_Ada2005 = 0x002e, |
| DW_LANG_Ada2012 = 0x002f, |
| |
| DW_LANG_lo_user = 0x8000, /* Implementation-defined range start. */ |
| DW_LANG_hi_user = 0xffff, /* Implementation-defined range start. */ |
| |
| /* MIPS. */ |
| DW_LANG_Mips_Assembler = 0x8001, |
| /* UPC. */ |
| DW_LANG_Upc = 0x8765, |
| /* HP extensions. */ |
| DW_LANG_HP_Bliss = 0x8003, |
| DW_LANG_HP_Basic91 = 0x8004, |
| DW_LANG_HP_Pascal91 = 0x8005, |
| DW_LANG_HP_IMacro = 0x8006, |
| DW_LANG_HP_Assembler = 0x8007, |
| |
| /* Rust extension, but replaced in DWARF 5. */ |
| DW_LANG_Rust_old = 0x9000 |
| }; |
| |
| /* Names and codes for macro information. */ |
| enum dwarf_macinfo_record_type |
| { |
| DW_MACINFO_define = 1, |
| DW_MACINFO_undef = 2, |
| DW_MACINFO_start_file = 3, |
| DW_MACINFO_end_file = 4, |
| DW_MACINFO_vendor_ext = 255 |
| }; |
| |
| /* DW_TAG_defaulted/DW_TAG_GNU_defaulted attributes. */ |
| enum dwarf_defaulted_attribute |
| { |
| DW_DEFAULTED_no = 0x00, |
| DW_DEFAULTED_in_class = 0x01, |
| DW_DEFAULTED_out_of_class = 0x02 |
| }; |
| |
| /* Names and codes for new style macro information. */ |
| enum dwarf_macro_record_type |
| { |
| DW_MACRO_define = 0x01, |
| DW_MACRO_undef = 0x02, |
| DW_MACRO_start_file = 0x03, |
| DW_MACRO_end_file = 0x04, |
| DW_MACRO_define_strp = 0x05, |
| DW_MACRO_undef_strp = 0x06, |
| DW_MACRO_import = 0x07, |
| DW_MACRO_define_sup = 0x08, |
| DW_MACRO_undef_sup = 0x09, |
| DW_MACRO_import_sup = 0x0a, |
| DW_MACRO_define_strx = 0x0b, |
| DW_MACRO_undef_strx = 0x0c, |
| DW_MACRO_lo_user = 0xe0, |
| DW_MACRO_hi_user = 0xff, |
| |
| /* Compatibility macros for the GNU .debug_macro extension. */ |
| DW_MACRO_GNU_define = 0x01, |
| DW_MACRO_GNU_undef = 0x02, |
| DW_MACRO_GNU_start_file = 0x03, |
| DW_MACRO_GNU_end_file = 0x04, |
| DW_MACRO_GNU_define_indirect = 0x05, |
| DW_MACRO_GNU_undef_indirect = 0x06, |
| DW_MACRO_GNU_transparent_include = 0x07, |
| /* Extensions for DWZ multifile. |
| See http://www.dwarfstd.org/ShowIssue.php?issue=120604.1&type=open . */ |
| DW_MACRO_GNU_define_indirect_alt = 0x08, |
| DW_MACRO_GNU_undef_indirect_alt = 0x09, |
| DW_MACRO_GNU_transparent_include_alt = 0x0a, |
| DW_MACRO_GNU_lo_user = 0xe0, |
| DW_MACRO_GNU_hi_user = 0xff |
| }; |
| |
| /* Range list entry kinds in .debug_rnglists* section. */ |
| enum dwarf_range_list_entry |
| { |
| DW_RLE_end_of_list = 0x00, |
| DW_RLE_base_addressx = 0x01, |
| DW_RLE_startx_endx = 0x02, |
| DW_RLE_startx_length = 0x03, |
| DW_RLE_offset_pair = 0x04, |
| DW_RLE_base_address = 0x05, |
| DW_RLE_start_end = 0x06, |
| DW_RLE_start_length = 0x07 |
| }; |
| |
| /* @@@ For use with GNU frame unwind information. */ |
| |
| #define DW_EH_PE_absptr 0x00 |
| #define DW_EH_PE_omit 0xff |
| |
| #define DW_EH_PE_uleb128 0x01 |
| #define DW_EH_PE_udata2 0x02 |
| #define DW_EH_PE_udata4 0x03 |
| #define DW_EH_PE_udata8 0x04 |
| #define DW_EH_PE_sleb128 0x09 |
| #define DW_EH_PE_sdata2 0x0A |
| #define DW_EH_PE_sdata4 0x0B |
| #define DW_EH_PE_sdata8 0x0C |
| #define DW_EH_PE_signed 0x08 |
| |
| #define DW_EH_PE_pcrel 0x10 |
| #define DW_EH_PE_textrel 0x20 |
| #define DW_EH_PE_datarel 0x30 |
| #define DW_EH_PE_funcrel 0x40 |
| #define DW_EH_PE_aligned 0x50 |
| |
| #define DW_EH_PE_indirect 0x80 |
| |
| /* Codes for the debug sections in a dwarf package (.dwp) file. |
| (From the pre-standard formats Extensions for Fission. |
| See http://gcc.gnu.org/wiki/DebugFissionDWP). */ |
| enum dwarf_sect |
| { |
| DW_SECT_INFO = 1, |
| DW_SECT_TYPES = 2, |
| DW_SECT_ABBREV = 3, |
| DW_SECT_LINE = 4, |
| DW_SECT_LOC = 5, |
| DW_SECT_STR_OFFSETS = 6, |
| DW_SECT_MACINFO = 7, |
| DW_SECT_MACRO = 8, |
| DW_SECT_MAX = 8 |
| }; |
| |
| /* Codes for the debug sections in a dwarf package (.dwp) file. |
| (From the official DWARF v5 spec. |
| See http://dwarfstd.org/doc/DWARF5.pdf, section 7.3.5). */ |
| enum dwarf_sect_v5 |
| { |
| DW_SECT_INFO_V5 = 1, |
| DW_SECT_RESERVED_V5 = 2, |
| DW_SECT_ABBREV_V5 = 3, |
| DW_SECT_LINE_V5 = 4, |
| DW_SECT_LOCLISTS_V5 = 5, |
| DW_SECT_STR_OFFSETS_V5 = 6, |
| DW_SECT_MACRO_V5 = 7, |
| DW_SECT_RNGLISTS_V5 = 8, |
| DW_SECT_MAX_V5 = 8 |
| }; |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif /* __cplusplus */ |
| |
| /* Return the name of a DW_TAG_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_TAG_name (unsigned int tag); |
| |
| /* Return the name of a DW_AT_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_AT_name (unsigned int attr); |
| |
| /* Return the name of a DW_FORM_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_FORM_name (unsigned int form); |
| |
| /* Return the name of a DW_OP_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_OP_name (unsigned int op); |
| |
| /* Return the name of a DW_ATE_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_ATE_name (unsigned int enc); |
| |
| /* Return the name of a DW_CFA_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_CFA_name (unsigned int opc); |
| |
| /* Return the name of a DW_IDX_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_IDX_name (unsigned int idx); |
| |
| /* Return the name of a DW_UT_ constant, or NULL if the value is not |
| recognized. */ |
| extern const char *get_DW_UT_name (unsigned int ut); |
| |
| #ifdef __cplusplus |
| } |
| #endif /* __cplusplus */ |
| |
| #endif /* _DWARF2_H */ |