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