debug

Documentation

Overview

Package debug contains DebugObjectMapper implementations.

Index

• type InsnMap
  • func (m *InsnMap) FindCall(retAddr uint32) (init bool, funcIndex, callIndex int, stackOffset int32, retOffset uint32)
  • func (m *InsnMap) Mapper(source Teller) obj.ObjectMapper
• type InsnMapping
• type ReadTeller
  • func NewReadTeller(r binary.Reader) ReadTeller
• type Teller
• type TrapMap
  • func (m *TrapMap) FindCall(retAddr uint32) (init bool, funcIndex, callIndex int, stackOffset int32, retOffset uint32)
  • func (TrapMap) PutDataBlock(uint32, int32)
  • func (TrapMap) PutInsnAddr(uint32)
  • func (m *TrapMap) PutTrapSite(retAddr uint32, stackOffset int32)

Types

type InsnMap

type InsnMap struct {
	TrapMap
	Insns []InsnMapping
	// contains filtered or unexported fields
}

InsnMap is an object map which stores all available function, call, trap and instruction information. The Mapper method must be used to obtain an actual ObjectMapper implementation.

func (*InsnMap) FindCall

func (m *InsnMap) FindCall(retAddr uint32,
) (init bool, funcIndex, callIndex int, stackOffset int32, retOffset uint32)

func (*InsnMap) Mapper

func (m *InsnMap) Mapper(source Teller) obj.ObjectMapper

Mapper creates a compile.DebugObjectMapper for the InsnMap.

The source position teller is a special reader which must be used when loading (at least) the code section. See NewReadTeller.

type InsnMapping

type InsnMapping struct {
	ObjectOffset uint32 // Machine code offset in bytes.
	SourceOffset uint32 // WebAssembly code offset in bytes.
	BlockLen     int32  // Length of data block (when SourceOffset is 0).
}

Instruction mapping from machine code to WebAssembly. SourceOffset is zero if ObjectOffset contains non-executable data interleaved with the code.

type ReadTeller

type ReadTeller interface {
	binary.Reader
	Teller
}

ReadTeller is a reader which knows how many bytes have been read.

func NewReadTeller

func NewReadTeller(r binary.Reader) ReadTeller

NewReadTeller wraps a reader into one which tracks the read position.

type Teller

type Teller interface {
	Tell() int64
}

Teller knows the position.

type TrapMap

type TrapMap struct {
	object.CallMap                   // Function calls and recoverable (portable) traps.
	TrapSites      []object.CallSite // Unrecoverable (or nonportable) traps.
}

TrapMap implements compile.DebugObjectMapper. It stores function addresses, and all call and trap sites. Instruction information is not stored.

func (*TrapMap) FindCall

func (m *TrapMap) FindCall(retAddr uint32,
) (init bool, funcIndex, callIndex int, stackOffset int32, retOffset uint32)

func (TrapMap) PutDataBlock

func (TrapMap) PutDataBlock(uint32, int32)

func (TrapMap) PutInsnAddr

func (TrapMap) PutInsnAddr(uint32)

func (*TrapMap) PutTrapSite

func (m *TrapMap) PutTrapSite(retAddr uint32, stackOffset int32)