sys

Documentation

Overview

Package sys includes constants and types used by both public and internal APIs.

Index

• type ClockResolution
• type ExitError
  • func NewExitError(moduleName string, exitCode uint32) *ExitError
  • func (e *ExitError) Error() string
  • func (e *ExitError) ExitCode() uint32
  • func (e *ExitError) Is(err error) bool
  • func (e *ExitError) ModuleName() string
• type Nanosleep
• type Nanotime
• type Walltime

Types

type ClockResolution

type ClockResolution uint32

ClockResolution is a positive granularity of clock precision in nanoseconds. For example, if the resolution is 1us, this returns 1000.

Note: Some implementations return arbitrary resolution because there's no perfect alternative. For example, according to the source in time.go, windows monotonic resolution can be 15ms. See /RATIONALE.md.

type ExitError

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

ExitError is returned to a caller of api.Function still running when api.Module CloseWithExitCode was invoked. ExitCode zero value means success, while any other value is an error.

Here's an example of how to get the exit code:

main := module.ExportedFunction("main")
if err := main(ctx); err != nil {
	if exitErr, ok := err.(*sys.ExitError); ok {
		// If your main function expects to exit, this could be ok if Code == 0
	}
--snip--

Note: While possible the reason of this was "proc_exit" from "wasi_snapshot_preview1", it could be from other host functions, for example an AssemblyScript's abort handler, or any arbitrary caller of CloseWithExitCode.

See https://github.com/WebAssembly/WASI/blob/main/phases/snapshot/docs.md#proc_exit and https://www.assemblyscript.org/concepts.html#special-imports

func NewExitError

func NewExitError(moduleName string, exitCode uint32) *ExitError

func (*ExitError) Error

func (e *ExitError) Error() string

Error implements the error interface.

func (*ExitError) ExitCode

func (e *ExitError) ExitCode() uint32

ExitCode returns zero on success, and an arbitrary value otherwise.

func (*ExitError) Is

func (e *ExitError) Is(err error) bool

Is allows use via errors.Is

func (*ExitError) ModuleName

func (e *ExitError) ModuleName() string

ModuleName is the api.Module that was closed.

type Nanosleep

type Nanosleep func(ctx context.Context, ns int64)

Nanosleep puts the current goroutine to sleep for at least ns nanoseconds.

type Nanotime

type Nanotime func(context.Context) int64

Nanotime returns nanoseconds since an arbitrary start point, used to measure elapsed time. This is sometimes referred to as a tick or monotonic time.

Note: There are no constraints on the value return except that it increments. For example, -1 is a valid if the next value is >= 0.

type Walltime

type Walltime func(context.Context) (sec int64, nsec int32)

Walltime returns the current time in epoch seconds with a nanosecond fraction.