Skip to content
GitHub no longer supports this web browser. Learn more about the browsers we support.
A minidump parser written in Rust
Rust Shell
Branch: master
Clone or download
Cannot retrieve the latest commit at this time.
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
breakpad-symbols
examples
minidump-common
minidump-processor
minidump-tools
scripts
src
testdata
tests
.gitignore
.travis.yml
Cargo.toml
LICENSE
README.md
bindgen.sh

README.md

Build Status crates.io

Overview

This Rust crate implements a parser for the minidump file format.

It's fairly heavily modeled after the Google Breakpad library, and much of it was written as a means to learn Rust, so there are some rough edges, but it implements most of the functionality necessary to work with minidumps.

Documentation for master

Examples

Print the raw details of the exception stream from a minidump:

extern crate minidump;

use minidump::{Error, Minidump, MinidumpException, MinidumpStream};
use std::io::{self, Write};

fn work() -> Result<(), Error> {
  let mut dump = minidump::Minidump::read_path("testdata/test.dmp")?;
  let exception: MinidumpException = dump.get_stream()?;
  drop(exception.print(&mut io::stdout()));
  Ok(())
}

fn main() {
    work().unwrap();
}

If you want to extract stack traces you should use minidump-processor.

Sub-crates

The functionality here has been broken out into several sub-crates:

  • minidump-common crates.io contains the definitions of basic minidump structs, and traits that are shared among several crates.
  • breakpad-symbols crates.io contains a parser for Breakpad's text format .sym files and interfaces for resolving functions and source line info by address from symbol files.
  • minidump-processor crates.io contains the pieces necessary to generate symbolicated stack traces from a minidump. It provides a minidump_stackwalk binary which should function similarly to the one provided in Breakpad.

License

This software is provided under the MIT license. See LICENSE.

You can’t perform that action at this time.