github.com/q45/go@v0.0.0-20151101211701-a4fb8c13db3f/src/cmd/link/internal/ld/dwarf_defs.go (about) 1 // Copyright 2010 The Go Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style 3 // license that can be found in the LICENSE file. 4 5 package ld 6 7 // TODO/NICETOHAVE: 8 // - eliminate DW_CLS_ if not used 9 // - package info in compilation units 10 // - assign global variables and types to their packages 11 // - gdb uses c syntax, meaning clumsy quoting is needed for go identifiers. eg 12 // ptype struct '[]uint8' and qualifiers need to be quoted away 13 // - lexical scoping is lost, so gdb gets confused as to which 'obj.i' you mean. 14 // - file:line info for variables 15 // - make strings a typedef so prettyprinters can see the underlying string type 16 // 17 // Copyright 2010 The Go Authors. All rights reserved. 18 // Use of this source code is governed by a BSD-style 19 // license that can be found in the LICENSE file. 20 21 /* 22 * Emit debug_abbrevs, debug_info and debug_line sections to current 23 * offset in cout. 24 */ 25 26 /* 27 * Add the dwarf section names to the ELF 28 * s[ection]h[eader]str[ing]tab. Prerequisite for 29 * dwarfaddelfheaders(). 30 */ 31 32 /* 33 * Add section headers pointing to the sections emitted in 34 * dwarfemitdebugsections. 35 */ 36 // Copyright 2010 The Go Authors. All rights reserved. 37 // Use of this source code is governed by a BSD-style 38 // license that can be found in the LICENSE file. 39 40 // Cut, pasted, tr-and-awk'ed from tables in 41 // http://dwarfstd.org/doc/Dwarf3.pdf 42 43 // Table 18 44 const ( 45 DW_TAG_array_type = 0x01 46 DW_TAG_class_type = 0x02 47 DW_TAG_entry_point = 0x03 48 DW_TAG_enumeration_type = 0x04 49 DW_TAG_formal_parameter = 0x05 50 DW_TAG_imported_declaration = 0x08 51 DW_TAG_label = 0x0a 52 DW_TAG_lexical_block = 0x0b 53 DW_TAG_member = 0x0d 54 DW_TAG_pointer_type = 0x0f 55 DW_TAG_reference_type = 0x10 56 DW_TAG_compile_unit = 0x11 57 DW_TAG_string_type = 0x12 58 DW_TAG_structure_type = 0x13 59 DW_TAG_subroutine_type = 0x15 60 DW_TAG_typedef = 0x16 61 DW_TAG_union_type = 0x17 62 DW_TAG_unspecified_parameters = 0x18 63 DW_TAG_variant = 0x19 64 DW_TAG_common_block = 0x1a 65 DW_TAG_common_inclusion = 0x1b 66 DW_TAG_inheritance = 0x1c 67 DW_TAG_inlined_subroutine = 0x1d 68 DW_TAG_module = 0x1e 69 DW_TAG_ptr_to_member_type = 0x1f 70 DW_TAG_set_type = 0x20 71 DW_TAG_subrange_type = 0x21 72 DW_TAG_with_stmt = 0x22 73 DW_TAG_access_declaration = 0x23 74 DW_TAG_base_type = 0x24 75 DW_TAG_catch_block = 0x25 76 DW_TAG_const_type = 0x26 77 DW_TAG_constant = 0x27 78 DW_TAG_enumerator = 0x28 79 DW_TAG_file_type = 0x29 80 DW_TAG_friend = 0x2a 81 DW_TAG_namelist = 0x2b 82 DW_TAG_namelist_item = 0x2c 83 DW_TAG_packed_type = 0x2d 84 DW_TAG_subprogram = 0x2e 85 DW_TAG_template_type_parameter = 0x2f 86 DW_TAG_template_value_parameter = 0x30 87 DW_TAG_thrown_type = 0x31 88 DW_TAG_try_block = 0x32 89 DW_TAG_variant_part = 0x33 90 DW_TAG_variable = 0x34 91 DW_TAG_volatile_type = 0x35 92 // Dwarf3 93 DW_TAG_dwarf_procedure = 0x36 94 DW_TAG_restrict_type = 0x37 95 DW_TAG_interface_type = 0x38 96 DW_TAG_namespace = 0x39 97 DW_TAG_imported_module = 0x3a 98 DW_TAG_unspecified_type = 0x3b 99 DW_TAG_partial_unit = 0x3c 100 DW_TAG_imported_unit = 0x3d 101 DW_TAG_condition = 0x3f 102 DW_TAG_shared_type = 0x40 103 // Dwarf4 104 DW_TAG_type_unit = 0x41 105 DW_TAG_rvalue_reference_type = 0x42 106 DW_TAG_template_alias = 0x43 107 108 // User defined 109 DW_TAG_lo_user = 0x4080 110 DW_TAG_hi_user = 0xffff 111 ) 112 113 // Table 19 114 const ( 115 DW_CHILDREN_no = 0x00 116 DW_CHILDREN_yes = 0x01 117 ) 118 119 // Not from the spec, but logicaly belongs here 120 const ( 121 DW_CLS_ADDRESS = 0x01 + iota 122 DW_CLS_BLOCK 123 DW_CLS_CONSTANT 124 DW_CLS_FLAG 125 DW_CLS_PTR // lineptr, loclistptr, macptr, rangelistptr 126 DW_CLS_REFERENCE 127 DW_CLS_ADDRLOC 128 DW_CLS_STRING 129 ) 130 131 // Table 20 132 const ( 133 DW_AT_sibling = 0x01 // reference 134 DW_AT_location = 0x02 // block, loclistptr 135 DW_AT_name = 0x03 // string 136 DW_AT_ordering = 0x09 // constant 137 DW_AT_byte_size = 0x0b // block, constant, reference 138 DW_AT_bit_offset = 0x0c // block, constant, reference 139 DW_AT_bit_size = 0x0d // block, constant, reference 140 DW_AT_stmt_list = 0x10 // lineptr 141 DW_AT_low_pc = 0x11 // address 142 DW_AT_high_pc = 0x12 // address 143 DW_AT_language = 0x13 // constant 144 DW_AT_discr = 0x15 // reference 145 DW_AT_discr_value = 0x16 // constant 146 DW_AT_visibility = 0x17 // constant 147 DW_AT_import = 0x18 // reference 148 DW_AT_string_length = 0x19 // block, loclistptr 149 DW_AT_common_reference = 0x1a // reference 150 DW_AT_comp_dir = 0x1b // string 151 DW_AT_const_value = 0x1c // block, constant, string 152 DW_AT_containing_type = 0x1d // reference 153 DW_AT_default_value = 0x1e // reference 154 DW_AT_inline = 0x20 // constant 155 DW_AT_is_optional = 0x21 // flag 156 DW_AT_lower_bound = 0x22 // block, constant, reference 157 DW_AT_producer = 0x25 // string 158 DW_AT_prototyped = 0x27 // flag 159 DW_AT_return_addr = 0x2a // block, loclistptr 160 DW_AT_start_scope = 0x2c // constant 161 DW_AT_bit_stride = 0x2e // constant 162 DW_AT_upper_bound = 0x2f // block, constant, reference 163 DW_AT_abstract_origin = 0x31 // reference 164 DW_AT_accessibility = 0x32 // constant 165 DW_AT_address_class = 0x33 // constant 166 DW_AT_artificial = 0x34 // flag 167 DW_AT_base_types = 0x35 // reference 168 DW_AT_calling_convention = 0x36 // constant 169 DW_AT_count = 0x37 // block, constant, reference 170 DW_AT_data_member_location = 0x38 // block, constant, loclistptr 171 DW_AT_decl_column = 0x39 // constant 172 DW_AT_decl_file = 0x3a // constant 173 DW_AT_decl_line = 0x3b // constant 174 DW_AT_declaration = 0x3c // flag 175 DW_AT_discr_list = 0x3d // block 176 DW_AT_encoding = 0x3e // constant 177 DW_AT_external = 0x3f // flag 178 DW_AT_frame_base = 0x40 // block, loclistptr 179 DW_AT_friend = 0x41 // reference 180 DW_AT_identifier_case = 0x42 // constant 181 DW_AT_macro_info = 0x43 // macptr 182 DW_AT_namelist_item = 0x44 // block 183 DW_AT_priority = 0x45 // reference 184 DW_AT_segment = 0x46 // block, loclistptr 185 DW_AT_specification = 0x47 // reference 186 DW_AT_static_link = 0x48 // block, loclistptr 187 DW_AT_type = 0x49 // reference 188 DW_AT_use_location = 0x4a // block, loclistptr 189 DW_AT_variable_parameter = 0x4b // flag 190 DW_AT_virtuality = 0x4c // constant 191 DW_AT_vtable_elem_location = 0x4d // block, loclistptr 192 // Dwarf3 193 DW_AT_allocated = 0x4e // block, constant, reference 194 DW_AT_associated = 0x4f // block, constant, reference 195 DW_AT_data_location = 0x50 // block 196 DW_AT_byte_stride = 0x51 // block, constant, reference 197 DW_AT_entry_pc = 0x52 // address 198 DW_AT_use_UTF8 = 0x53 // flag 199 DW_AT_extension = 0x54 // reference 200 DW_AT_ranges = 0x55 // rangelistptr 201 DW_AT_trampoline = 0x56 // address, flag, reference, string 202 DW_AT_call_column = 0x57 // constant 203 DW_AT_call_file = 0x58 // constant 204 DW_AT_call_line = 0x59 // constant 205 DW_AT_description = 0x5a // string 206 DW_AT_binary_scale = 0x5b // constant 207 DW_AT_decimal_scale = 0x5c // constant 208 DW_AT_small = 0x5d // reference 209 DW_AT_decimal_sign = 0x5e // constant 210 DW_AT_digit_count = 0x5f // constant 211 DW_AT_picture_string = 0x60 // string 212 DW_AT_mutable = 0x61 // flag 213 DW_AT_threads_scaled = 0x62 // flag 214 DW_AT_explicit = 0x63 // flag 215 DW_AT_object_pointer = 0x64 // reference 216 DW_AT_endianity = 0x65 // constant 217 DW_AT_elemental = 0x66 // flag 218 DW_AT_pure = 0x67 // flag 219 DW_AT_recursive = 0x68 // flag 220 221 DW_AT_lo_user = 0x2000 // --- 222 DW_AT_hi_user = 0x3fff // --- 223 ) 224 225 // Table 21 226 const ( 227 DW_FORM_addr = 0x01 // address 228 DW_FORM_block2 = 0x03 // block 229 DW_FORM_block4 = 0x04 // block 230 DW_FORM_data2 = 0x05 // constant 231 DW_FORM_data4 = 0x06 // constant, lineptr, loclistptr, macptr, rangelistptr 232 DW_FORM_data8 = 0x07 // constant, lineptr, loclistptr, macptr, rangelistptr 233 DW_FORM_string = 0x08 // string 234 DW_FORM_block = 0x09 // block 235 DW_FORM_block1 = 0x0a // block 236 DW_FORM_data1 = 0x0b // constant 237 DW_FORM_flag = 0x0c // flag 238 DW_FORM_sdata = 0x0d // constant 239 DW_FORM_strp = 0x0e // string 240 DW_FORM_udata = 0x0f // constant 241 DW_FORM_ref_addr = 0x10 // reference 242 DW_FORM_ref1 = 0x11 // reference 243 DW_FORM_ref2 = 0x12 // reference 244 DW_FORM_ref4 = 0x13 // reference 245 DW_FORM_ref8 = 0x14 // reference 246 DW_FORM_ref_udata = 0x15 // reference 247 DW_FORM_indirect = 0x16 // (see Section 7.5.3) 248 ) 249 250 // Table 24 (#operands, notes) 251 const ( 252 DW_OP_addr = 0x03 // 1 constant address (size target specific) 253 DW_OP_deref = 0x06 // 0 254 DW_OP_const1u = 0x08 // 1 1-byte constant 255 DW_OP_const1s = 0x09 // 1 1-byte constant 256 DW_OP_const2u = 0x0a // 1 2-byte constant 257 DW_OP_const2s = 0x0b // 1 2-byte constant 258 DW_OP_const4u = 0x0c // 1 4-byte constant 259 DW_OP_const4s = 0x0d // 1 4-byte constant 260 DW_OP_const8u = 0x0e // 1 8-byte constant 261 DW_OP_const8s = 0x0f // 1 8-byte constant 262 DW_OP_constu = 0x10 // 1 ULEB128 constant 263 DW_OP_consts = 0x11 // 1 SLEB128 constant 264 DW_OP_dup = 0x12 // 0 265 DW_OP_drop = 0x13 // 0 266 DW_OP_over = 0x14 // 0 267 DW_OP_pick = 0x15 // 1 1-byte stack index 268 DW_OP_swap = 0x16 // 0 269 DW_OP_rot = 0x17 // 0 270 DW_OP_xderef = 0x18 // 0 271 DW_OP_abs = 0x19 // 0 272 DW_OP_and = 0x1a // 0 273 DW_OP_div = 0x1b // 0 274 DW_OP_minus = 0x1c // 0 275 DW_OP_mod = 0x1d // 0 276 DW_OP_mul = 0x1e // 0 277 DW_OP_neg = 0x1f // 0 278 DW_OP_not = 0x20 // 0 279 DW_OP_or = 0x21 // 0 280 DW_OP_plus = 0x22 // 0 281 DW_OP_plus_uconst = 0x23 // 1 ULEB128 addend 282 DW_OP_shl = 0x24 // 0 283 DW_OP_shr = 0x25 // 0 284 DW_OP_shra = 0x26 // 0 285 DW_OP_xor = 0x27 // 0 286 DW_OP_skip = 0x2f // 1 signed 2-byte constant 287 DW_OP_bra = 0x28 // 1 signed 2-byte constant 288 DW_OP_eq = 0x29 // 0 289 DW_OP_ge = 0x2a // 0 290 DW_OP_gt = 0x2b // 0 291 DW_OP_le = 0x2c // 0 292 DW_OP_lt = 0x2d // 0 293 DW_OP_ne = 0x2e // 0 294 DW_OP_lit0 = 0x30 // 0 ... 295 DW_OP_lit31 = 0x4f // 0 literals 0..31 = (DW_OP_lit0 + literal) 296 DW_OP_reg0 = 0x50 // 0 .. 297 DW_OP_reg31 = 0x6f // 0 reg 0..31 = (DW_OP_reg0 + regnum) 298 DW_OP_breg0 = 0x70 // 1 ... 299 DW_OP_breg31 = 0x8f // 1 SLEB128 offset base register 0..31 = (DW_OP_breg0 + regnum) 300 DW_OP_regx = 0x90 // 1 ULEB128 register 301 DW_OP_fbreg = 0x91 // 1 SLEB128 offset 302 DW_OP_bregx = 0x92 // 2 ULEB128 register followed by SLEB128 offset 303 DW_OP_piece = 0x93 // 1 ULEB128 size of piece addressed 304 DW_OP_deref_size = 0x94 // 1 1-byte size of data retrieved 305 DW_OP_xderef_size = 0x95 // 1 1-byte size of data retrieved 306 DW_OP_nop = 0x96 // 0 307 DW_OP_push_object_address = 0x97 // 0 308 DW_OP_call2 = 0x98 // 1 2-byte offset of DIE 309 DW_OP_call4 = 0x99 // 1 4-byte offset of DIE 310 DW_OP_call_ref = 0x9a // 1 4- or 8-byte offset of DIE 311 DW_OP_form_tls_address = 0x9b // 0 312 DW_OP_call_frame_cfa = 0x9c // 0 313 DW_OP_bit_piece = 0x9d // 2 314 DW_OP_lo_user = 0xe0 315 DW_OP_hi_user = 0xff 316 ) 317 318 // Table 25 319 const ( 320 DW_ATE_address = 0x01 321 DW_ATE_boolean = 0x02 322 DW_ATE_complex_float = 0x03 323 DW_ATE_float = 0x04 324 DW_ATE_signed = 0x05 325 DW_ATE_signed_char = 0x06 326 DW_ATE_unsigned = 0x07 327 DW_ATE_unsigned_char = 0x08 328 DW_ATE_imaginary_float = 0x09 329 DW_ATE_packed_decimal = 0x0a 330 DW_ATE_numeric_string = 0x0b 331 DW_ATE_edited = 0x0c 332 DW_ATE_signed_fixed = 0x0d 333 DW_ATE_unsigned_fixed = 0x0e 334 DW_ATE_decimal_float = 0x0f 335 DW_ATE_lo_user = 0x80 336 DW_ATE_hi_user = 0xff 337 ) 338 339 // Table 26 340 const ( 341 DW_DS_unsigned = 0x01 342 DW_DS_leading_overpunch = 0x02 343 DW_DS_trailing_overpunch = 0x03 344 DW_DS_leading_separate = 0x04 345 DW_DS_trailing_separate = 0x05 346 ) 347 348 // Table 27 349 const ( 350 DW_END_default = 0x00 351 DW_END_big = 0x01 352 DW_END_little = 0x02 353 DW_END_lo_user = 0x40 354 DW_END_hi_user = 0xff 355 ) 356 357 // Table 28 358 const ( 359 DW_ACCESS_public = 0x01 360 DW_ACCESS_protected = 0x02 361 DW_ACCESS_private = 0x03 362 ) 363 364 // Table 29 365 const ( 366 DW_VIS_local = 0x01 367 DW_VIS_exported = 0x02 368 DW_VIS_qualified = 0x03 369 ) 370 371 // Table 30 372 const ( 373 DW_VIRTUALITY_none = 0x00 374 DW_VIRTUALITY_virtual = 0x01 375 DW_VIRTUALITY_pure_virtual = 0x02 376 ) 377 378 // Table 31 379 const ( 380 DW_LANG_C89 = 0x0001 381 DW_LANG_C = 0x0002 382 DW_LANG_Ada83 = 0x0003 383 DW_LANG_C_plus_plus = 0x0004 384 DW_LANG_Cobol74 = 0x0005 385 DW_LANG_Cobol85 = 0x0006 386 DW_LANG_Fortran77 = 0x0007 387 DW_LANG_Fortran90 = 0x0008 388 DW_LANG_Pascal83 = 0x0009 389 DW_LANG_Modula2 = 0x000a 390 // Dwarf3 391 DW_LANG_Java = 0x000b 392 DW_LANG_C99 = 0x000c 393 DW_LANG_Ada95 = 0x000d 394 DW_LANG_Fortran95 = 0x000e 395 DW_LANG_PLI = 0x000f 396 DW_LANG_ObjC = 0x0010 397 DW_LANG_ObjC_plus_plus = 0x0011 398 DW_LANG_UPC = 0x0012 399 DW_LANG_D = 0x0013 400 // Dwarf4 401 DW_LANG_Python = 0x0014 402 // Dwarf5 403 DW_LANG_Go = 0x0016 404 405 DW_LANG_lo_user = 0x8000 406 DW_LANG_hi_user = 0xffff 407 ) 408 409 // Table 32 410 const ( 411 DW_ID_case_sensitive = 0x00 412 DW_ID_up_case = 0x01 413 DW_ID_down_case = 0x02 414 DW_ID_case_insensitive = 0x03 415 ) 416 417 // Table 33 418 const ( 419 DW_CC_normal = 0x01 420 DW_CC_program = 0x02 421 DW_CC_nocall = 0x03 422 DW_CC_lo_user = 0x40 423 DW_CC_hi_user = 0xff 424 ) 425 426 // Table 34 427 const ( 428 DW_INL_not_inlined = 0x00 429 DW_INL_inlined = 0x01 430 DW_INL_declared_not_inlined = 0x02 431 DW_INL_declared_inlined = 0x03 432 ) 433 434 // Table 35 435 const ( 436 DW_ORD_row_major = 0x00 437 DW_ORD_col_major = 0x01 438 ) 439 440 // Table 36 441 const ( 442 DW_DSC_label = 0x00 443 DW_DSC_range = 0x01 444 ) 445 446 // Table 37 447 const ( 448 DW_LNS_copy = 0x01 449 DW_LNS_advance_pc = 0x02 450 DW_LNS_advance_line = 0x03 451 DW_LNS_set_file = 0x04 452 DW_LNS_set_column = 0x05 453 DW_LNS_negate_stmt = 0x06 454 DW_LNS_set_basic_block = 0x07 455 DW_LNS_const_add_pc = 0x08 456 DW_LNS_fixed_advance_pc = 0x09 457 // Dwarf3 458 DW_LNS_set_prologue_end = 0x0a 459 DW_LNS_set_epilogue_begin = 0x0b 460 DW_LNS_set_isa = 0x0c 461 ) 462 463 // Table 38 464 const ( 465 DW_LNE_end_sequence = 0x01 466 DW_LNE_set_address = 0x02 467 DW_LNE_define_file = 0x03 468 DW_LNE_lo_user = 0x80 469 DW_LNE_hi_user = 0xff 470 ) 471 472 // Table 39 473 const ( 474 DW_MACINFO_define = 0x01 475 DW_MACINFO_undef = 0x02 476 DW_MACINFO_start_file = 0x03 477 DW_MACINFO_end_file = 0x04 478 DW_MACINFO_vendor_ext = 0xff 479 ) 480 481 // Table 40. 482 const ( 483 // operand,... 484 DW_CFA_nop = 0x00 485 DW_CFA_set_loc = 0x01 // address 486 DW_CFA_advance_loc1 = 0x02 // 1-byte delta 487 DW_CFA_advance_loc2 = 0x03 // 2-byte delta 488 DW_CFA_advance_loc4 = 0x04 // 4-byte delta 489 DW_CFA_offset_extended = 0x05 // ULEB128 register, ULEB128 offset 490 DW_CFA_restore_extended = 0x06 // ULEB128 register 491 DW_CFA_undefined = 0x07 // ULEB128 register 492 DW_CFA_same_value = 0x08 // ULEB128 register 493 DW_CFA_register = 0x09 // ULEB128 register, ULEB128 register 494 DW_CFA_remember_state = 0x0a 495 DW_CFA_restore_state = 0x0b 496 497 DW_CFA_def_cfa = 0x0c // ULEB128 register, ULEB128 offset 498 DW_CFA_def_cfa_register = 0x0d // ULEB128 register 499 DW_CFA_def_cfa_offset = 0x0e // ULEB128 offset 500 DW_CFA_def_cfa_expression = 0x0f // BLOCK 501 DW_CFA_expression = 0x10 // ULEB128 register, BLOCK 502 DW_CFA_offset_extended_sf = 0x11 // ULEB128 register, SLEB128 offset 503 DW_CFA_def_cfa_sf = 0x12 // ULEB128 register, SLEB128 offset 504 DW_CFA_def_cfa_offset_sf = 0x13 // SLEB128 offset 505 DW_CFA_val_offset = 0x14 // ULEB128, ULEB128 506 DW_CFA_val_offset_sf = 0x15 // ULEB128, SLEB128 507 DW_CFA_val_expression = 0x16 // ULEB128, BLOCK 508 509 DW_CFA_lo_user = 0x1c 510 DW_CFA_hi_user = 0x3f 511 512 // Opcodes that take an addend operand. 513 DW_CFA_advance_loc = 0x1 << 6 // +delta 514 DW_CFA_offset = 0x2 << 6 // +register (ULEB128 offset) 515 DW_CFA_restore = 0x3 << 6 // +register 516 )