Documentation
¶
Index ¶
- type Debuglet
- func (d *Debuglet) Close(ctx context.Context) error
- func (d *Debuglet) GetSCIONAddr() string
- func (d *Debuglet) ID() uuid.UUID
- func (d *Debuglet) InitRuntime(ctx context.Context, wasmBytes []byte) error
- func (d *Debuglet) Registry() *socket.SocketRegistry
- func (d *Debuglet) Run(ctx context.Context, outputCh chan<- []byte, args []string) error
- func (d *Debuglet) StartServers(ctx context.Context, req StartServersReq) error
- type StartServersReq
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Debuglet ¶
type Debuglet struct {
// contains filtered or unexported fields
}
Debuglet is the engine that loads, initialises, and runs a single WASM debuglet module. One Debuglet instance corresponds to one session.
func New ¶
func New(logger *zap.Logger, debugletID uuid.UUID, transactionID string, policy scheduler.Policy, operator netpolicy.Operator, schedule *tesla.KeySchedule, limiter *app.Limiter, pc ratelimit.PacketCount, iface *net.Interface, portManager *socket.PortManager) *Debuglet
New creates a ready-to-initialise Debuglet backed by a wazero Runtime. operator is the executor's network policy; together with the run's declared destinations it decides every transport the guest can use.
func (*Debuglet) Close ¶
Close terminates owned I/O and runtime resources exactly once. It does not wait for Run or its caller's watcher: the executor joins those separately. The context reaches wazero; it cannot force an arbitrary socket Close to end.
func (*Debuglet) GetSCIONAddr ¶
GetSCIONAddr returns the local SCION address of the server listener started during Init.
func (*Debuglet) InitRuntime ¶
InitRuntime starts the network servers and compiles and instantiates the WASM module. It must be called exactly once before Run.
func (*Debuglet) Registry ¶
func (d *Debuglet) Registry() *socket.SocketRegistry
func (*Debuglet) Run ¶
Run executes the debuglet's "_start" WASM export, streams stdout/stderr back through outputCh, and returns any execution error. The outputCh channel is closed when the debuglet finishes execution.
func (*Debuglet) StartServers ¶
func (d *Debuglet) StartServers(ctx context.Context, req StartServersReq) error
startServers starts the network listeners required by this debuglet instance. Currently only the SCION/UDP listener is active; TCP and plain UDP are reserved for future use.
type StartServersReq ¶
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package netpolicy holds the one network policy the executor applies to guest traffic: which transports a guest may use, which destinations it may reach, and on which ports.
|
Package netpolicy holds the one network policy the executor applies to guest traffic: which transports a guest may use, which destinations it may reach, and on which ports. |
|
Package wasm contains the WASM host function implementations that are imported by WASM modules at runtime.
|
Package wasm contains the WASM host function implementations that are imported by WASM modules at runtime. |