Documentation
¶
Overview ¶
Package dwarf generates DWARF debugging information. DWARF generation is split between the compiler and the linker, this package contains the shared code.
Index ¶
- Constants
- func AppendSleb128(b []byte, v int64) []byte
- func AppendUleb128(b []byte, v uint64) []byte
- func EnableLogging(doit bool)
- func GetAbbrev() []byte
- func HasChildren(die *DWDie) bool
- func PutAbstractFunc(ctxt Context, s *FnState) error
- func PutAttrs(ctxt Context, s Sym, abbrev int, attr *DWAttr)
- func PutConcreteFunc(ctxt Context, s *FnState) error
- func PutDefaultFunc(ctxt Context, s *FnState) error
- func PutInlinedFunc(ctxt Context, s *FnState, callersym Sym, callIdx int) error
- func PutIntConst(ctxt Context, info, typ Sym, name string, val int64)
- func PutRanges(ctxt Context, sym Sym, base Sym, ranges []Range)
- func Sleb128put(ctxt Context, s Sym, v int64)
- func Uleb128put(ctxt Context, s Sym, v int64)
- type Context
- type DWAttr
- type DWDie
- type FnState
- type InlCall
- type InlCalls
- type Range
- type Scope
- type Sym
- type Var
- type VarsByOffset
Constants ¶
const ( DW_AT_go_kind = 0x2900 DW_AT_go_key = 0x2901 DW_AT_go_elem = 0x2902 // Attribute for DW_TAG_member of a struct type. // Nonzero value indicates the struct field is an embedded field. DW_AT_go_embedded_field = 0x2903 DW_AT_go_runtime_type = 0x2904 DW_AT_internal_location = 253 // params and locals; not emitted )
Go-specific type attributes.
const ( DW_ABRV_NULL = iota DW_ABRV_COMPUNIT DW_ABRV_COMPUNIT_TEXTLESS DW_ABRV_FUNCTION DW_ABRV_FUNCTION_ABSTRACT DW_ABRV_FUNCTION_CONCRETE DW_ABRV_INLINED_SUBROUTINE DW_ABRV_INLINED_SUBROUTINE_RANGES DW_ABRV_VARIABLE DW_ABRV_INT_CONSTANT DW_ABRV_AUTO DW_ABRV_AUTO_LOCLIST DW_ABRV_AUTO_ABSTRACT DW_ABRV_AUTO_CONCRETE DW_ABRV_AUTO_CONCRETE_LOCLIST DW_ABRV_PARAM DW_ABRV_PARAM_LOCLIST DW_ABRV_PARAM_ABSTRACT DW_ABRV_PARAM_CONCRETE DW_ABRV_PARAM_CONCRETE_LOCLIST DW_ABRV_LEXICAL_BLOCK_RANGES DW_ABRV_LEXICAL_BLOCK_SIMPLE DW_ABRV_STRUCTFIELD DW_ABRV_FUNCTYPEPARAM DW_ABRV_DOTDOTDOT DW_ABRV_ARRAYRANGE DW_ABRV_NULLTYPE DW_ABRV_BASETYPE DW_ABRV_ARRAYTYPE DW_ABRV_CHANTYPE DW_ABRV_FUNCTYPE DW_ABRV_IFACETYPE DW_ABRV_MAPTYPE DW_ABRV_PTRTYPE DW_ABRV_BARE_PTRTYPE // only for void*, no DW_AT_type attr to please gdb 6. DW_ABRV_SLICETYPE DW_ABRV_STRINGTYPE DW_ABRV_STRUCTTYPE DW_ABRV_TYPEDECL DW_NABRV )
Index into the abbrevs table below. Keep in sync with ispubname() and ispubtype() in ld/dwarf.go. ispubtype considers >= NULLTYPE public
const ( DW_TAG_array_type = 0x01 DW_TAG_class_type = 0x02 DW_TAG_entry_point = 0x03 DW_TAG_enumeration_type = 0x04 DW_TAG_formal_parameter = 0x05 DW_TAG_imported_declaration = 0x08 DW_TAG_label = 0x0a DW_TAG_lexical_block = 0x0b DW_TAG_member = 0x0d DW_TAG_pointer_type = 0x0f DW_TAG_reference_type = 0x10 DW_TAG_compile_unit = 0x11 DW_TAG_string_type = 0x12 DW_TAG_structure_type = 0x13 DW_TAG_subroutine_type = 0x15 DW_TAG_typedef = 0x16 DW_TAG_union_type = 0x17 DW_TAG_unspecified_parameters = 0x18 DW_TAG_variant = 0x19 DW_TAG_common_block = 0x1a DW_TAG_common_inclusion = 0x1b DW_TAG_inheritance = 0x1c DW_TAG_inlined_subroutine = 0x1d DW_TAG_module = 0x1e DW_TAG_ptr_to_member_type = 0x1f DW_TAG_set_type = 0x20 DW_TAG_subrange_type = 0x21 DW_TAG_with_stmt = 0x22 DW_TAG_access_declaration = 0x23 DW_TAG_base_type = 0x24 DW_TAG_catch_block = 0x25 DW_TAG_const_type = 0x26 DW_TAG_constant = 0x27 DW_TAG_enumerator = 0x28 DW_TAG_file_type = 0x29 DW_TAG_friend = 0x2a DW_TAG_namelist = 0x2b DW_TAG_namelist_item = 0x2c DW_TAG_packed_type = 0x2d DW_TAG_subprogram = 0x2e DW_TAG_template_type_parameter = 0x2f DW_TAG_template_value_parameter = 0x30 DW_TAG_thrown_type = 0x31 DW_TAG_try_block = 0x32 DW_TAG_variant_part = 0x33 DW_TAG_variable = 0x34 DW_TAG_volatile_type = 0x35 // Dwarf3 DW_TAG_dwarf_procedure = 0x36 DW_TAG_restrict_type = 0x37 DW_TAG_interface_type = 0x38 DW_TAG_namespace = 0x39 DW_TAG_imported_module = 0x3a DW_TAG_unspecified_type = 0x3b DW_TAG_partial_unit = 0x3c DW_TAG_imported_unit = 0x3d DW_TAG_condition = 0x3f // Dwarf4 DW_TAG_type_unit = 0x41 DW_TAG_rvalue_reference_type = 0x42 DW_TAG_template_alias = 0x43 // User defined DW_TAG_lo_user = 0x4080 DW_TAG_hi_user = 0xffff )
Table 18
const ( DW_CHILDREN_no = 0x00 DW_CHILDREN_yes = 0x01 )
Table 19
const ( DW_CLS_ADDRESS = 0x01 + iota DW_CLS_BLOCK DW_CLS_CONSTANT DW_CLS_FLAG DW_CLS_PTR // lineptr, loclistptr, macptr, rangelistptr DW_CLS_REFERENCE DW_CLS_ADDRLOC DW_CLS_STRING // Go-specific internal hackery. DW_CLS_GO_TYPEREF )
Not from the spec, but logically belongs here
const ( DW_AT_sibling = 0x01 // reference DW_AT_location = 0x02 // block, loclistptr DW_AT_name = 0x03 // string DW_AT_ordering = 0x09 // constant DW_AT_byte_size = 0x0b // block, constant, reference DW_AT_bit_offset = 0x0c // block, constant, reference DW_AT_bit_size = 0x0d // block, constant, reference DW_AT_stmt_list = 0x10 // lineptr DW_AT_low_pc = 0x11 // address DW_AT_high_pc = 0x12 // address DW_AT_language = 0x13 // constant DW_AT_discr = 0x15 // reference DW_AT_discr_value = 0x16 // constant DW_AT_visibility = 0x17 // constant DW_AT_import = 0x18 // reference DW_AT_string_length = 0x19 // block, loclistptr DW_AT_common_reference = 0x1a // reference DW_AT_comp_dir = 0x1b // string DW_AT_const_value = 0x1c // block, constant, string DW_AT_containing_type = 0x1d // reference DW_AT_default_value = 0x1e // reference DW_AT_inline = 0x20 // constant DW_AT_is_optional = 0x21 // flag DW_AT_lower_bound = 0x22 // block, constant, reference DW_AT_producer = 0x25 // string DW_AT_prototyped = 0x27 // flag DW_AT_return_addr = 0x2a // block, loclistptr DW_AT_start_scope = 0x2c // constant DW_AT_bit_stride = 0x2e // constant DW_AT_upper_bound = 0x2f // block, constant, reference DW_AT_abstract_origin = 0x31 // reference DW_AT_accessibility = 0x32 // constant DW_AT_address_class = 0x33 // constant DW_AT_artificial = 0x34 // flag DW_AT_base_types = 0x35 // reference DW_AT_calling_convention = 0x36 // constant DW_AT_count = 0x37 // block, constant, reference DW_AT_data_member_location = 0x38 // block, constant, loclistptr DW_AT_decl_column = 0x39 // constant DW_AT_decl_file = 0x3a // constant DW_AT_decl_line = 0x3b // constant DW_AT_declaration = 0x3c // flag DW_AT_discr_list = 0x3d // block DW_AT_encoding = 0x3e // constant DW_AT_external = 0x3f // flag DW_AT_frame_base = 0x40 // block, loclistptr DW_AT_friend = 0x41 // reference DW_AT_identifier_case = 0x42 // constant DW_AT_macro_info = 0x43 // macptr DW_AT_namelist_item = 0x44 // block DW_AT_priority = 0x45 // reference DW_AT_segment = 0x46 // block, loclistptr DW_AT_specification = 0x47 // reference DW_AT_static_link = 0x48 // block, loclistptr DW_AT_type = 0x49 // reference DW_AT_use_location = 0x4a // block, loclistptr DW_AT_variable_parameter = 0x4b // flag DW_AT_virtuality = 0x4c // constant DW_AT_vtable_elem_location = 0x4d // block, loclistptr // Dwarf3 DW_AT_allocated = 0x4e // block, constant, reference DW_AT_associated = 0x4f // block, constant, reference DW_AT_data_location = 0x50 // block DW_AT_byte_stride = 0x51 // block, constant, reference DW_AT_entry_pc = 0x52 // address DW_AT_use_UTF8 = 0x53 // flag DW_AT_extension = 0x54 // reference DW_AT_ranges = 0x55 // rangelistptr DW_AT_trampoline = 0x56 // address, flag, reference, string DW_AT_call_column = 0x57 // constant DW_AT_call_file = 0x58 // constant DW_AT_call_line = 0x59 // constant DW_AT_description = 0x5a // string DW_AT_binary_scale = 0x5b // constant DW_AT_decimal_scale = 0x5c // constant DW_AT_small = 0x5d // reference DW_AT_decimal_sign = 0x5e // constant DW_AT_digit_count = 0x5f // constant DW_AT_picture_string = 0x60 // string DW_AT_mutable = 0x61 // flag DW_AT_threads_scaled = 0x62 // flag DW_AT_explicit = 0x63 // flag DW_AT_object_pointer = 0x64 // reference DW_AT_endianity = 0x65 // constant DW_AT_elemental = 0x66 // flag DW_AT_pure = 0x67 // flag DW_AT_recursive = 0x68 // flag DW_AT_lo_user = 0x2000 // --- DW_AT_hi_user = 0x3fff // --- )
Table 20
const ( DW_FORM_addr = 0x01 // address DW_FORM_block2 = 0x03 // block DW_FORM_block4 = 0x04 // block DW_FORM_data2 = 0x05 // constant DW_FORM_data4 = 0x06 // constant, lineptr, loclistptr, macptr, rangelistptr DW_FORM_data8 = 0x07 // constant, lineptr, loclistptr, macptr, rangelistptr DW_FORM_string = 0x08 // string DW_FORM_block = 0x09 // block DW_FORM_block1 = 0x0a // block DW_FORM_data1 = 0x0b // constant DW_FORM_flag = 0x0c // flag DW_FORM_sdata = 0x0d // constant DW_FORM_strp = 0x0e // string DW_FORM_udata = 0x0f // constant DW_FORM_ref_addr = 0x10 // reference DW_FORM_ref1 = 0x11 // reference DW_FORM_ref2 = 0x12 // reference DW_FORM_ref4 = 0x13 // reference DW_FORM_ref8 = 0x14 // reference DW_FORM_ref_udata = 0x15 // reference DW_FORM_indirect = 0x16 // (see Section 7.5.3) // Dwarf4 DW_FORM_sec_offset = 0x17 // lineptr, loclistptr, macptr, rangelistptr DW_FORM_exprloc = 0x18 // exprloc DW_FORM_flag_present = 0x19 // flag DW_FORM_ref_sig8 = 0x20 // reference )
Table 21
const ( DW_OP_addr = 0x03 // 1 constant address (size target specific) DW_OP_deref = 0x06 // 0 DW_OP_const1u = 0x08 // 1 1-byte constant DW_OP_const1s = 0x09 // 1 1-byte constant DW_OP_const2u = 0x0a // 1 2-byte constant DW_OP_const2s = 0x0b // 1 2-byte constant DW_OP_const4u = 0x0c // 1 4-byte constant DW_OP_const4s = 0x0d // 1 4-byte constant DW_OP_const8u = 0x0e // 1 8-byte constant DW_OP_const8s = 0x0f // 1 8-byte constant DW_OP_constu = 0x10 // 1 ULEB128 constant DW_OP_consts = 0x11 // 1 SLEB128 constant DW_OP_dup = 0x12 // 0 DW_OP_drop = 0x13 // 0 DW_OP_over = 0x14 // 0 DW_OP_pick = 0x15 // 1 1-byte stack index DW_OP_swap = 0x16 // 0 DW_OP_rot = 0x17 // 0 DW_OP_xderef = 0x18 // 0 DW_OP_abs = 0x19 // 0 DW_OP_and = 0x1a // 0 DW_OP_div = 0x1b // 0 DW_OP_minus = 0x1c // 0 DW_OP_mod = 0x1d // 0 DW_OP_mul = 0x1e // 0 DW_OP_neg = 0x1f // 0 DW_OP_not = 0x20 // 0 DW_OP_or = 0x21 // 0 DW_OP_plus = 0x22 // 0 DW_OP_plus_uconst = 0x23 // 1 ULEB128 addend DW_OP_shl = 0x24 // 0 DW_OP_shr = 0x25 // 0 DW_OP_shra = 0x26 // 0 DW_OP_xor = 0x27 // 0 DW_OP_skip = 0x2f // 1 signed 2-byte constant DW_OP_bra = 0x28 // 1 signed 2-byte constant DW_OP_eq = 0x29 // 0 DW_OP_ge = 0x2a // 0 DW_OP_gt = 0x2b // 0 DW_OP_le = 0x2c // 0 DW_OP_lt = 0x2d // 0 DW_OP_ne = 0x2e // 0 DW_OP_lit0 = 0x30 // 0 ... DW_OP_lit31 = 0x4f // 0 literals 0..31 = (DW_OP_lit0 + literal) DW_OP_reg0 = 0x50 // 0 .. DW_OP_reg31 = 0x6f // 0 reg 0..31 = (DW_OP_reg0 + regnum) DW_OP_breg0 = 0x70 // 1 ... DW_OP_breg31 = 0x8f // 1 SLEB128 offset base register 0..31 = (DW_OP_breg0 + regnum) DW_OP_regx = 0x90 // 1 ULEB128 register DW_OP_fbreg = 0x91 // 1 SLEB128 offset DW_OP_bregx = 0x92 // 2 ULEB128 register followed by SLEB128 offset DW_OP_piece = 0x93 // 1 ULEB128 size of piece addressed DW_OP_deref_size = 0x94 // 1 1-byte size of data retrieved DW_OP_xderef_size = 0x95 // 1 1-byte size of data retrieved DW_OP_nop = 0x96 // 0 DW_OP_push_object_address = 0x97 // 0 DW_OP_call2 = 0x98 // 1 2-byte offset of DIE DW_OP_call4 = 0x99 // 1 4-byte offset of DIE DW_OP_call_ref = 0x9a // 1 4- or 8-byte offset of DIE DW_OP_form_tls_address = 0x9b // 0 DW_OP_call_frame_cfa = 0x9c // 0 DW_OP_bit_piece = 0x9d // 2 DW_OP_lo_user = 0xe0 DW_OP_hi_user = 0xff )
Table 24 (#operands, notes)
const ( DW_ATE_address = 0x01 DW_ATE_boolean = 0x02 DW_ATE_complex_float = 0x03 DW_ATE_float = 0x04 DW_ATE_signed = 0x05 DW_ATE_signed_char = 0x06 DW_ATE_unsigned = 0x07 DW_ATE_unsigned_char = 0x08 DW_ATE_imaginary_float = 0x09 DW_ATE_packed_decimal = 0x0a DW_ATE_numeric_string = 0x0b DW_ATE_edited = 0x0c DW_ATE_signed_fixed = 0x0d DW_ATE_unsigned_fixed = 0x0e DW_ATE_decimal_float = 0x0f DW_ATE_lo_user = 0x80 DW_ATE_hi_user = 0xff )
Table 25
const ( DW_DS_unsigned = 0x01 DW_DS_leading_overpunch = 0x02 DW_DS_trailing_overpunch = 0x03 DW_DS_leading_separate = 0x04 DW_DS_trailing_separate = 0x05 )
Table 26
const ( DW_END_default = 0x00 DW_END_big = 0x01 DW_END_little = 0x02 DW_END_lo_user = 0x40 DW_END_hi_user = 0xff )
Table 27
const ( DW_ACCESS_public = 0x01 DW_ACCESS_protected = 0x02 DW_ACCESS_private = 0x03 )
Table 28
const ( DW_VIS_local = 0x01 DW_VIS_exported = 0x02 DW_VIS_qualified = 0x03 )
Table 29
const ( DW_VIRTUALITY_none = 0x00 DW_VIRTUALITY_virtual = 0x01 DW_VIRTUALITY_pure_virtual = 0x02 )
Table 30
const ( 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 // Dwarf3 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 // Dwarf4 DW_LANG_Python = 0x0014 // Dwarf5 DW_LANG_Go = 0x0016 DW_LANG_lo_user = 0x8000 DW_LANG_hi_user = 0xffff )
Table 31
const ( DW_ID_case_sensitive = 0x00 DW_ID_up_case = 0x01 DW_ID_down_case = 0x02 DW_ID_case_insensitive = 0x03 )
Table 32
const ( DW_CC_normal = 0x01 DW_CC_program = 0x02 DW_CC_nocall = 0x03 DW_CC_lo_user = 0x40 DW_CC_hi_user = 0xff )
Table 33
const ( DW_INL_not_inlined = 0x00 DW_INL_inlined = 0x01 DW_INL_declared_not_inlined = 0x02 DW_INL_declared_inlined = 0x03 )
Table 34
const ( DW_ORD_row_major = 0x00 DW_ORD_col_major = 0x01 )
Table 35
const ( DW_DSC_label = 0x00 DW_DSC_range = 0x01 )
Table 36
const ( DW_LNS_copy = 0x01 DW_LNS_advance_pc = 0x02 DW_LNS_advance_line = 0x03 DW_LNS_set_file = 0x04 DW_LNS_set_column = 0x05 DW_LNS_negate_stmt = 0x06 DW_LNS_set_basic_block = 0x07 DW_LNS_const_add_pc = 0x08 DW_LNS_fixed_advance_pc = 0x09 // Dwarf3 DW_LNS_set_prologue_end = 0x0a DW_LNS_set_epilogue_begin = 0x0b DW_LNS_set_isa = 0x0c )
Table 37
const ( DW_LNE_end_sequence = 0x01 DW_LNE_set_address = 0x02 DW_LNE_define_file = 0x03 DW_LNE_lo_user = 0x80 DW_LNE_hi_user = 0xff )
Table 38
const ( DW_MACINFO_define = 0x01 DW_MACINFO_undef = 0x02 DW_MACINFO_start_file = 0x03 DW_MACINFO_end_file = 0x04 DW_MACINFO_vendor_ext = 0xff )
Table 39
const ( // operand,... DW_CFA_nop = 0x00 DW_CFA_set_loc = 0x01 // address DW_CFA_advance_loc1 = 0x02 // 1-byte delta DW_CFA_advance_loc2 = 0x03 // 2-byte delta DW_CFA_advance_loc4 = 0x04 // 4-byte delta DW_CFA_offset_extended = 0x05 // ULEB128 register, ULEB128 offset DW_CFA_restore_extended = 0x06 // ULEB128 register DW_CFA_undefined = 0x07 // ULEB128 register DW_CFA_same_value = 0x08 // ULEB128 register DW_CFA_register = 0x09 // ULEB128 register, ULEB128 register DW_CFA_remember_state = 0x0a DW_CFA_restore_state = 0x0b DW_CFA_def_cfa = 0x0c // ULEB128 register, ULEB128 offset DW_CFA_def_cfa_register = 0x0d // ULEB128 register DW_CFA_def_cfa_offset = 0x0e // ULEB128 offset DW_CFA_def_cfa_expression = 0x0f // BLOCK DW_CFA_expression = 0x10 // ULEB128 register, BLOCK DW_CFA_offset_extended_sf = 0x11 // ULEB128 register, SLEB128 offset DW_CFA_def_cfa_sf = 0x12 // ULEB128 register, SLEB128 offset DW_CFA_def_cfa_offset_sf = 0x13 // SLEB128 offset DW_CFA_val_offset = 0x14 // ULEB128, ULEB128 DW_CFA_val_offset_sf = 0x15 // ULEB128, SLEB128 DW_CFA_val_expression = 0x16 // ULEB128, BLOCK DW_CFA_lo_user = 0x1c DW_CFA_hi_user = 0x3f // Opcodes that take an addend operand. DW_CFA_advance_loc = 0x1 << 6 // +delta DW_CFA_offset = 0x2 << 6 // +register (ULEB128 offset) DW_CFA_restore = 0x3 << 6 // +register )
Table 40.
const AbstractFuncSuffix = "$abstract"
Used to form the symbol name assigned to the DWARF 'abstract subprogram" info entry for a function
const CUInfoPrefix = "go.cuinfo."
CUInfoPrefix is the prefix for symbols containing information to populate the DWARF compilation unit info entries.
const ConstInfoPrefix = "go.constinfo."
ConstInfoPrefix is the prefix for all symbols containing DWARF info entries that contain constants.
const InfoPrefix = "go.info."
InfoPrefix is the prefix for all the symbols containing DWARF info entries.
const IsStmtPrefix = "go.isstmt."
IsStmtPrefix is the prefix for all the symbols containing DWARF is_stmt info for the line number table.
const LocPrefix = "go.loc."
RangePrefix is the prefix for all the symbols containing DWARF location lists.
const RangePrefix = "go.range."
RangePrefix is the prefix for all the symbols containing DWARF range lists.
Variables ¶
This section is empty.
Functions ¶
func AppendSleb128 ¶
AppendSleb128 appends v to b using DWARF's signed LEB128 encoding.
func AppendUleb128 ¶
AppendUleb128 appends v to b using DWARF's unsigned LEB128 encoding.
func EnableLogging ¶
func EnableLogging(doit bool)
func GetAbbrev ¶
func GetAbbrev() []byte
GetAbbrev returns the contents of the .debug_abbrev section.
func HasChildren ¶
HasChildren reports whether 'die' uses an abbrev that supports children.
func PutAbstractFunc ¶
Emit DWARF attributes and child DIEs for an 'abstract' subprogram. The abstract subprogram DIE for a function contains its location-independent attributes (name, type, etc). Other instances of the function (any inlined copy of it, or the single out-of-line 'concrete' instance) will contain a pointer back to this abstract DIE (as a space-saving measure, so that name/type etc doesn't have to be repeated for each inlined copy).
func PutAttrs ¶
PutAttrs writes the attributes for a DIE to symbol 's'.
Note that we can (and do) add arbitrary attributes to a DIE, but only the ones actually listed in the Abbrev will be written out.
func PutConcreteFunc ¶
Emit DWARF attributes and child DIEs for a 'concrete' subprogram, meaning the out-of-line copy of a function that was inlined at some point during the compilation of its containing package. The first attribute for a concrete DIE is a reference to the 'abstract' DIE for the function (which holds location-independent attributes such as name, type), then the remainder of the attributes are specific to this instance (location, frame base, etc).
func PutDefaultFunc ¶
Emit DWARF attributes and child DIEs for a subprogram. Here 'default' implies that the function in question was not inlined when its containing package was compiled (hence there is no need to emit an abstract version for it to use as a base for inlined routine records).
func PutInlinedFunc ¶
Emit DWARF attributes and child DIEs for an inlined subroutine. The first attribute of an inlined subroutine DIE is a reference back to its corresponding 'abstract' DIE (containing location-independent attributes such as name, type, etc). Inlined subroutine DIEs can have other inlined subroutine DIEs as children.
func PutIntConst ¶
PutIntConst writes a DIE for an integer constant
func PutRanges ¶
PutRanges writes a range table to sym. All addresses in ranges are relative to some base address. If base is not nil, then they're relative to the start of base. If base is nil, then the caller must arrange a base address some other way (such as a DW_AT_low_pc attribute).
func Sleb128put ¶
Sleb128put appends v to s using DWARF's signed LEB128 encoding.
func Uleb128put ¶
Uleb128put appends v to s using DWARF's unsigned LEB128 encoding.
Types ¶
type Context ¶
type Context interface {
PtrSize() int
AddInt(s Sym, size int, i int64)
AddBytes(s Sym, b []byte)
AddAddress(s Sym, t interface{}, ofs int64)
AddSectionOffset(s Sym, size int, t interface{}, ofs int64)
AddDWARFAddrSectionOffset(s Sym, t interface{}, ofs int64)
CurrentOffset(s Sym) int64
RecordDclReference(from Sym, to Sym, dclIdx int, inlIndex int)
RecordChildDieOffsets(s Sym, vars []*Var, offsets []int32)
AddString(s Sym, v string)
AddFileRef(s Sym, f interface{})
Logf(format string, args ...interface{})
}
A Context specifies how to add data to a Sym.
type DWAttr ¶
type DWAttr struct {
Link *DWAttr
Atr uint16 // DW_AT_
Cls uint8 // DW_CLS_
Value int64
Data interface{}
}
DWAttr represents an attribute of a DWDie.
For DW_CLS_string and _block, value should contain the length, and data the data, for _reference, value is 0 and data is a DWDie* to the referenced instance, for all others, value is the whole thing and data is null.
type FnState ¶
type FnState struct {
Name string
Importpath string
Info Sym
Filesym Sym
Loc Sym
Ranges Sym
Absfn Sym
StartPC Sym
Size int64
External bool
Scopes []Scope
InlCalls InlCalls
}
This container is used by the PutFunc* variants below when creating the DWARF subprogram DIE(s) for a function.
type InlCall ¶
type InlCall struct {
// index into ctx.InlTree describing the call inlined here
InlIndex int
// Symbol of file containing inlined call site (really *obj.LSym).
CallFile Sym
// Line number of inlined call site.
CallLine uint32
// Dwarf abstract subroutine symbol (really *obj.LSym).
AbsFunSym Sym
// Indices of child inlines within Calls array above.
Children []int
// entries in this list are PAUTO's created by the inliner to
// capture the promoted formals and locals of the inlined callee.
InlVars []*Var
// PC ranges for this inlined call.
Ranges []Range
// Root call (not a child of some other call).
Root bool
}
type Range ¶
type Range struct {
Start, End int64
}
A Range represents a half-open interval [Start, End).
type Scope ¶
A Scope represents a lexical scope. All variables declared within a scope will only be visible to instructions covered by the scope. Lexical scopes are contiguous in source files but can end up being compiled to discontiguous blocks of instructions in the executable. The Ranges field lists all the blocks of instructions that belong in this scope.
func (*Scope) UnifyRanges ¶
UnifyRanges merges the list of ranges of c into the list of ranges of s
type Var ¶
type Var struct {
Name string
Abbrev int // Either DW_ABRV_AUTO[_LOCLIST] or DW_ABRV_PARAM[_LOCLIST]
IsReturnValue bool
IsInlFormal bool
StackOffset int32
// This package can't use the ssa package, so it can't mention ssa.FuncDebug,
// so indirect through a closure.
PutLocationList func(listSym, startPC Sym)
Scope int32
Type Sym
DeclFile string
DeclLine uint
DeclCol uint
InlIndex int32 // subtract 1 to form real index into InlTree
ChildIndex int32 // child DIE index in abstract function
IsInAbstract bool // variable exists in abstract function
}
A Var represents a local variable or a function parameter.
type VarsByOffset ¶
type VarsByOffset []*Var
VarsByOffset attaches the methods of sort.Interface to []*Var, sorting in increasing StackOffset.
func (VarsByOffset) Len ¶
func (s VarsByOffset) Len() int
func (VarsByOffset) Less ¶
func (s VarsByOffset) Less(i, j int) bool
func (VarsByOffset) Swap ¶
func (s VarsByOffset) Swap(i, j int)
Source Files