debug

Documentation

Index

• type InsnMap
  • func (m InsnMap) FindAddr(retAddr uint32) (init bool, funcIndex, callIndex int, stackOffset int32, retInsnPos uint32)
  • func (m *InsnMap) Mapper(source Teller) obj.ObjectMapper
• type InsnMapping
• type ReadTeller
  • func NewReadTeller(r reader.R) ReadTeller
• type Teller
• type TrapMap
  • func (m TrapMap) FindAddr(retAddr uint32) (init bool, funcIndex, callIndex int, stackOffset int32, retInsnPos 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) FindAddr

func (m InsnMap) FindAddr(retAddr uint32,
) (init bool, funcIndex, callIndex int, stackOffset int32, retInsnPos 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 {
	ObjectPos uint32 // Machine code offset in bytes.
	SourcePos uint32 // WebAssembly code offset in bytes.
	BlockLen  int32  // Length of data block (when SourcePos is 0).
}

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

type ReadTeller

type ReadTeller interface {
	reader.R
	Teller
}

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

func NewReadTeller

func NewReadTeller(r reader.R) 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) FindAddr

func (m TrapMap) FindAddr(retAddr uint32,
) (init bool, funcIndex, callIndex int, stackOffset int32, retInsnPos 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)