include/dwarf2.h

   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,
   4    2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
   5    Free Software Foundation, Inc.
   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
  44 #ifndef _DWARF2_H
  45 #define _DWARF2_H
  46
  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
 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
 107 #define DW_AT_stride_size   DW_AT_bit_stride  /* Note: The use of DW_AT_stride_size is deprecated.  */
 108 #define DW_AT_stride   DW_AT_byte_stride  /* Note: The use of DW_AT_stride is deprecated.  */
 109
 110 /* Decimal sign encodings.  */
 111 enum 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.  */
 122 enum 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.  */
 134 enum dwarf_array_dim_ordering
 135   {
 136     DW_ORD_row_major = 0,
 137     DW_ORD_col_major = 1
 138   };
 139
 140 /* Access attribute.  */
 141 enum dwarf_access_attribute
 142   {
 143     DW_ACCESS_public = 1,
 144     DW_ACCESS_protected = 2,
 145     DW_ACCESS_private = 3
 146   };
 147
 148 /* Visibility.  */
 149 enum dwarf_visibility_attribute
 150   {
 151     DW_VIS_local = 1,
 152     DW_VIS_exported = 2,
 153     DW_VIS_qualified = 3
 154   };
 155
 156 /* Virtuality.  */
 157 enum 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.  */
 165 enum 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.  */
 174 enum 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
 183     DW_CC_GNU_renesas_sh = 0x40,
 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
 193   };
 194
 195 /* Inline attribute.  */
 196 enum 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.  */
 205 enum dwarf_discrim_list
 206   {
 207     DW_DSC_label = 0,
 208     DW_DSC_range = 1
 209   };
 210
 211 /* Line number opcodes.  */
 212 enum 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.  */
 231 enum 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,
 248     DW_LNE_HP_source_file_correlation  = 0x80,
 249
 250     DW_LNE_lo_user = 0x80,
 251     DW_LNE_hi_user = 0xff
 252   };
 253
 254 /* Sub-opcodes for DW_LNE_HP_source_file_correlation.  */
 255 enum 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
 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.  */
 274 enum 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,
 296     /* DWARF 4.  */
 297     DW_LANG_Python = 0x0014,
 298     /* DWARF 5.  */
 299     DW_LANG_Go = 0x0016,
 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.  */
 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
 314   };
 315
 316 /* Names and codes for macro information.  */
 317 enum 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   };
 325
 326 /* Names and codes for new style macro information.  */
 327 enum 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   };
 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
 363
 364 #ifdef __cplusplus
 365 extern "C" {
 366 #endif /* __cplusplus */
 367
 368 /* Return the name of a DW_TAG_ constant, or NULL if the value is not
 369    recognized.  */
 370 extern 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.  */
 374 extern 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.  */
 378 extern 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.  */
 382 extern 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.  */
 386 extern 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.  */
 390 extern const char *get_DW_CFA_name (unsigned int opc);
 391
 392 #ifdef __cplusplus
 393 }
 394 #endif /* __cplusplus */
 395
 396 #endif /* _DWARF2_H */