github
/
cranelift
mirror of https://github.com/bytecodealliance/wasmtime.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
8926 Commits
49 Branches
140 Tags
128 MiB
 
 
 
Tree: 98831fe4e2
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '98831fe4e2'
${ noResults }
cranelift/docs/examples-debugging.md

1.0 KiB
Raw Blame History

Debugging WebAssembly

The following steps describe a common way to debug a WebAssembly module in Wasmtime:

  1. Compile your WebAssembly with debug info enabled, usually -g; for example:

    clang foo.c -g -o foo.wasm

  2. Run Wasmtime with the debug info enabled; this is -g from the CLI and Config::debug_info(true) in an embedding (e.g. see debugging in a Rust embedding)

  3. Use a supported debugger:

    lldb -- wasmtime run -g foo.wasm

    gdb --args wasmtime run -g foo.wasm

If you run into trouble, the following discussions might help:

  • On MacOS with LLDB you may need to run: settings set plugin.jit-loader.gdb.enable on (#1953)
  • With LLDB, call __vmctx.set() to set the current context before calling any dereference operators (#1482): 
    (lldb) p __vmctx->set()
(lldb) p *foo