extism-dbg

Debugging for Extism plugins

Installation

$ make && sudo make install

This will install extism-dbg and extism-lldb:

• extism-dbg is a minimal Extism host used to wrap the plugin.
• extism-lldb is a shim to use LLDB to debug Extism plugins called from extism-dbg

Usage

The following command will start LLDB with a breakpoint set on the specified plugin function, just type run at the LLDB prompt to start executing the plugin:

$ extism-lldb count-vowels.wasm count_vowels --input @input.txt

Arguments:

1. WebAssembly module or Manifest file
2. Function to call

See the output of extism-lldb --help for a list of options.

• The --source parameter can be used to specify the search path(s) for the original source files
• If the --input parameter starts with @ then the input will be loaded from a file otherwise it will be passed as-is.
• --lldb can be used to specify the LLDB executable
• Any arguments after the function name will be passed to LLDB directly