THIS APPLICATION IS STILL UNDER HEAVY DEVELOPMENT, DO NOT RELY ON IT YET.

A binary that wraps minidump-processor and provides a CLI frontend.

This is specifically designed to provide a compatible interface to mozilla's minidump-stackwalk which is itself similar to google-breakpad's minidump-stackwalk.

(If you need to distinguish them, call this one "rust-minidump-stackwalk")

The easiest way to use this is by cargo installing it:

> cargo install minidump-stackwalk
> minidump-stackwalk --human path/to/minidump.dmp

minidump-stackwalk --help will give you a listing of command line arguments.

Output Formats

minidump-stackwalk defaults to outputting machine-readable JSON in a format expected by Mozilla's servers. For the sake of tooling compatibility, we generally try to only add fields, and not remove them.

If you pass the --human flag, minidump-stackwalk will instead output a report in a more human-friendly format with no particular structure.

(Either way we recommend piping the output to a file, as it will usually be thousands of lines of output you'll want to search through.)

Getting Symbols

minidump-stackwalk can operate without any symbols, but if you provide them you will get richer output in two ways:

• More precise backtraces (using mechanisms like Dwarf CFI or PE32 Unwinding Tables)
• Symbolicated stackframes (backtraces will have proper function names and line numbers)

minidump-stackwalk gets its symbols from google-breakpad symbol files. Symbol files are a plain-text format intended to unify the contents of various platform-specific debuginfo/unwinding formats like PE32 Unwinding Tables, Dwarf CFI, Macho Compact Unwinding Info, etc.

To generate those files from your build artifacts, use either Mozilla's dump_syms (recommended) or google-breakpad's dump_syms.

You can then either provide those symbol files directly with the --symbols-path flag, or indirectly by setting up a symbol server that conforms to mozilla's Tecken protocol and passing a URL to that server with the --symbols-url flag.

Analyzing Firefox Minidumps

If you're trying to analyze firefox minidumps, you'll want to point minidump-stackwalk to Mozilla's Tecken server.

> mkdir /tmp/symbols/cache
> minidump-stackwalk \
    --symbols-url=https://symbols.mozilla.org/ \
    --symbols-cache=/tmp/symbols/cache \
    /path/to/minidump.dmp