WebAssembly Coredump

Monorepo for generating, parsing, debugging WebAssembly coredumps.

See demo for an overview about how to use Wasm coredumps.

Debugging

Think gdb for WebAssembly

See wasmgdb for documentation.

Use Coredump today

Since no Wasm engine support exists today, you an use wasm-coredump-rewriter to inject Coredump support.

Coredump format

See specificiation.

Troubleshooting

Running into stack overflow

Some Wasm binaries have very recursive flow of control, increase the maximum stack size:

$ ulimit -s 160000

lib.rs:

Rust API for building Wasm Coredump.

Examples

let mut coredump_builder = wasm_coredump_builder::CoredumpBuilder::new()
        .executable_name("/usr/bin/true.exe");

{
    let mut thread_builder = wasm_coredump_builder::ThreadBuilder::new()
        .thread_name("main");

    let coredump_frame = wasm_coredump_builder::FrameBuilder::new()
        .codeoffset(123)
        .funcidx(6)
        .build();
    thread_builder.add_frame(coredump_frame);

    coredump_builder.add_thread(thread_builder.build());
}

let coredump = coredump_builder.serialize().unwrap();