NAME

wasm-interp — decode and run a WebAssembly binary file

SYNOPSIS

DESCRIPTION

wasm-interp Read a file in the wasm binary format, and run it in a stack-based interpreter.

The options are as follows:

--help

Print a help message

--version

Print version information

-v, --verbose

Use multiple times for more info

--enable-exceptions

Enable Experimental exception handling

--disable-mutable-globals

Disable Import/export mutable globals

--disable-saturating-float-to-int

Disable Saturating float-to-int operators

--disable-sign-extension

Disable Sign-extension operators

--disable-simd

Disable SIMD support

--enable-threads

Enable Threading support

--enable-function-references

Enable Typed function references

--disable-multi-value

Disable Multi-value

--enable-tail-call

Enable Tail-call support

--disable-bulk-memory

Disable Bulk-memory operations

--disable-reference-types

Disable Reference types (externref)

--enable-annotations

Enable Custom annotation syntax

--enable-code-metadata

Enable Code metadata

--enable-gc

Enable Garbage collection

--enable-memory64

Enable 64-bit memory

--enable-multi-memory

Enable Multi-memory

--enable-extended-const

Enable Extended constant expressions

--enable-all

Enable all features

-V, --value-stack-size=SIZE

Size in elements of the value stack

-C, --call-stack-size=SIZE

Size in elements of the call stack

-t, --trace

Trace execution

--wasi

Assume input module is WASI compliant (Export WASI API the the module and invoke _start function)

-e, --env=ENV

Pass the given environment string in the WASI runtime

-d, --dir=DIR

Pass the given directory the the WASI runtime

--run-all-exports

Run all the exported functions, in order. Useful for testing

--host-print

Include an importable function named "host.print" for printing to stdout

--dummy-import-func

Provide a dummy implementation of all imported functions. The function will log the call and return an appropriate zero value.

EXAMPLES

Parse binary file test.wasm, and type-check it

Parse test.wasm and run all its exported functions

Parse test.wasm, run the exported functions and trace the output

Parse test.wasm and run all its exported functions, setting the value stack size to 100 elements

SEE ALSO

wasm-decompile(1), wasm-objdump(1), wasm-opcodecnt(1), wasm-strip(1), wasm-validate(1), wasm2c(1), wasm2wat(1), wast2json(1), wat-desugar(1), wat2wasm(1), spectest-interp(1)

BUGS

If you find a bug, please report it at
https://github.com/WebAssembly/wabt/issues.