https://github.com/extism/extism-dbg
Debugging for Extism plugins
https://github.com/extism/extism-dbg
extism wasm
Last synced: 6 months ago
JSON representation
Debugging for Extism plugins
- Host: GitHub
- URL: https://github.com/extism/extism-dbg
- Owner: extism
- License: bsd-3-clause
- Created: 2023-01-06T01:59:20.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T21:49:18.000Z (12 months ago)
- Last Synced: 2025-03-23T08:42:01.762Z (7 months ago)
- Topics: extism, wasm
- Language: C
- Homepage:
- Size: 1.78 MB
- Stars: 7
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# extism-dbg
Debugging for [Extism](https://github.com/extism/extism) plugins
## Installation
```bash
$ 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:
```bash
$ 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