WABT(1)

💅 WABT(1) 💅

okay bestie, welcome to the General Commands Manual page for WABT(1) — the main character here is wasm-interp, and she is ready to decode and run your WebAssembly binary file. no cap. 🦋

---

🌸 NAME 🌸

wasm-interp — decode and run a WebAssembly binary file

✨ SYNOPSIS ✨

wasm-interp [options] filename [arg]...

🎀 DESCRIPTION 🎀

So like, wasm-interp reads a file in the wasm binary format, and then it runs a stack-based interpreter in it. literally the whole vibe. 💖

The options are as follows, and yes bestie, every single one is included — no skips, fr fr:

• --help — print this help message
• --version — print version information
• -v, --verbose — use multiple times for more info
• --disable-exceptions — disable 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
• --disable-tail-call — disable Tail-call support
• --disable-bulk-memory — disable Bulk-memory operations
• --disable-reference-types — disable Reference types (externref)
• --disable-annotations — disable Custom annotation syntax
• --enable-code-metadata — enable Code metadata
• --enable-gc — enable Garbage collection
• --disable-memory64 — disable 64-bit memory
• --disable-multi-memory — disable Multi-memory
• --disable-extended-const — disable Extended constant expressions
• --disable-relaxed-simd — disable Relaxed SIMD
• --enable-custom-page-sizes — enable Custom page sizes
• --enable-compact-imports — enable Compact import section
• --enable-wide-arithmetic — enable Wide arithmetic
• --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
• -r, --run-export=FUNCTION — run an exported function by name
• -a, --argument=ARGUMENT — add an argument to an exported function execution
• --wasi — assume the input module is WASI compliant (export the WASI API from the module and invoke the _start function)
• -e, --env=ENV — pass the given environment string in the WASI runtime
• -d, --dir=DIR — pass the given directory to 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

🔥 EXAMPLES 🔥

parse binary file test.wasm, and type-check it:

$ wasm-interp test.wasm

parse test.wasm and run all its exported functions:

$ wasm-interp test.wasm --run-all-exports

parse test.wasm, run the exported functions and trace the output:

$ wasm-interp test.wasm --run-all-exports --trace

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

$ wasm-interp test.wasm -V 100 --run-all-exports

parse test.wasm, run specific exported function by name with argument:

$ wasm-interp test.wasm -r func_sum -a i32:8 -a i32:5

🦋 SEE ALSO 🦋

go be nosy with wasm-objdump(1), wasm-stats(1), wasm-strip(1), wasm-validate(1), wasm2c(1), wasm2wat(1), wast2json(1), wat-desugar(1), wat2wasm(1), and spectest-interp(1). the whole friend group is here. 💜

🐛 BUGS 🐛

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

---

this little masterpiece is from Debian, dated $Mdocdate$, and it’s the WABT(1) page — mwah, bye bestie 💋✨