wazero

Documentation

Index

• Variables
• func NewVM(ctx context.Context, options ...VMOptions) api.WasmVM
• type Instance
  • func NewInstance(ctx context.Context, vm *VM, module *Module, options ...InstanceOptions) *Instance
  • func (i *Instance) Acquire() bool
  • func (i *Instance) GetByte(addr uint64) (byte, error)
  • func (i *Instance) GetData() interface{}
  • func (i *Instance) GetExportsFunc(funcName string) (pwapi.WasmFunction, error)
  • func (i *Instance) GetExportsMem(memName string) ([]byte, error)
  • func (i *Instance) GetMemory(addr uint64, size uint64) ([]byte, error)
  • func (i *Instance) GetModule() pwapi.WasmModule
  • func (i *Instance) GetUint32(addr uint64) (uint32, error)
  • func (i *Instance) GetWasmFunction(f api.Function) pwapi.WasmFunction
  • func (i *Instance) HandleError(err error)
  • func (i *Instance) Lock(data interface{})
  • func (i *Instance) Malloc(size int32) (uint64, error)
  • func (i *Instance) PutByte(addr uint64, b byte) error
  • func (i *Instance) PutMemory(addr uint64, size uint64, content []byte) error
  • func (i *Instance) PutUint32(addr uint64, value uint32) error
  • func (i *Instance) Release()
  • func (i *Instance) SetData(data interface{})
  • func (i *Instance) Start() error
  • func (i *Instance) Stop()
  • func (i *Instance) Unlock()
• type InstanceOptions
  • func InstanceWithLogger(logger logr.Logger) InstanceOptions
  • func InstanceWithMallocFunctionNames(names ...string) InstanceOptions
  • func InstanceWithStartFunctionNames(names ...string) InstanceOptions
• type Module
  • func NewModule(ctx context.Context, vm *VM, module wazero.CompiledModule, ...) *Module
  • func (m *Module) Close(ctx context.Context) error
  • func (m *Module) GetABINameList() []string
  • func (m *Module) Init()
  • func (m *Module) NewInstance() (api.WasmInstance, error)
• type ModuleOptions
  • func ModuleWithLogger(logger logr.Logger) ModuleOptions
• type VM
  • func (w *VM) Close() (err error)
  • func (w *VM) Init()
  • func (w *VM) Name() string
  • func (w *VM) NewModule(wasmBytes []byte) (api.WasmModule, error)
• type VMOptions
  • func VMWithLogger(logger logr.Logger) VMOptions

Variables

var (
	ErrInstanceNotStart       = errors.New("instance has not started")
	ErrInstanceAlreadyStart   = errors.New("instance has already started")
	ErrOutOfMemory            = errors.New("out of memory")
	ErrUnableToReadMemory     = errors.New("unable to read memory")
	ErrFuncNotExported        = errors.New("function is not exported")
	ErrInvalidReturnAddress   = errors.New("invalid return address")
	ErrMallocFunctionNotFound = errors.New("could not find memory allocate function")
)

Functions

func NewVM

func NewVM(ctx context.Context, options ...VMOptions) api.WasmVM

Types

type Instance

type Instance struct {
	// contains filtered or unexported fields
}

func NewInstance

func NewInstance(ctx context.Context, vm *VM, module *Module, options ...InstanceOptions) *Instance

func (*Instance) Acquire

func (i *Instance) Acquire() bool

func (*Instance) GetByte

func (i *Instance) GetByte(addr uint64) (byte, error)

func (*Instance) GetData

func (i *Instance) GetData() interface{}

func (*Instance) GetExportsFunc

func (i *Instance) GetExportsFunc(funcName string) (pwapi.WasmFunction, error)

func (*Instance) GetExportsMem

func (i *Instance) GetExportsMem(memName string) ([]byte, error)

func (*Instance) GetMemory

func (i *Instance) GetMemory(addr uint64, size uint64) ([]byte, error)

func (*Instance) GetModule

func (i *Instance) GetModule() pwapi.WasmModule

func (*Instance) GetUint32

func (i *Instance) GetUint32(addr uint64) (uint32, error)

func (*Instance) GetWasmFunction

func (i *Instance) GetWasmFunction(f api.Function) pwapi.WasmFunction

func (*Instance) HandleError

func (i *Instance) HandleError(err error)

func (*Instance) Lock

func (i *Instance) Lock(data interface{})

func (*Instance) Malloc

func (i *Instance) Malloc(size int32) (uint64, error)

func (*Instance) PutByte

func (i *Instance) PutByte(addr uint64, b byte) error

func (*Instance) PutMemory

func (i *Instance) PutMemory(addr uint64, size uint64, content []byte) error

func (*Instance) PutUint32

func (i *Instance) PutUint32(addr uint64, value uint32) error

func (*Instance) Release

func (i *Instance) Release()

func (*Instance) SetData

func (i *Instance) SetData(data interface{})

func (*Instance) Start

func (i *Instance) Start() error

Start makes a new namespace which has the module dependencies of the guest.

func (*Instance) Stop

func (i *Instance) Stop()

func (*Instance) Unlock

func (i *Instance) Unlock()

type InstanceOptions

type InstanceOptions func(instance *Instance)

func InstanceWithLogger

func InstanceWithLogger(logger logr.Logger) InstanceOptions

func InstanceWithMallocFunctionNames

func InstanceWithMallocFunctionNames(names ...string) InstanceOptions

func InstanceWithStartFunctionNames

func InstanceWithStartFunctionNames(names ...string) InstanceOptions

type Module

type Module struct {
	// contains filtered or unexported fields
}

func NewModule

func NewModule(ctx context.Context, vm *VM, module wazero.CompiledModule, runtime wazero.Runtime, wasmBytes []byte, options ...ModuleOptions) *Module

func (*Module) Close

func (m *Module) Close(ctx context.Context) error

func (*Module) GetABINameList

func (m *Module) GetABINameList() []string

func (*Module) Init

func (m *Module) Init()

func (*Module) NewInstance

func (m *Module) NewInstance() (api.WasmInstance, error)

type ModuleOptions

type ModuleOptions func(module *Module)

func ModuleWithLogger

func ModuleWithLogger(logger logr.Logger) ModuleOptions

type VM

type VM struct {
	// contains filtered or unexported fields
}

func (*VM) Close

func (w *VM) Close() (err error)

Close implements io.Closer

func (*VM) Init

func (w *VM) Init()

func (*VM) Name

func (w *VM) Name() string

func (*VM) NewModule

func (w *VM) NewModule(wasmBytes []byte) (api.WasmModule, error)

type VMOptions

type VMOptions func(vm *VM)

func VMWithLogger

func VMWithLogger(logger logr.Logger) VMOptions