An optimizied cache file for fast and memory efficient lookup of symbols and stack frames in debugging information

40 stable releases (5 major)

✓ Uses Rust 2018 edition

new 6.0.4 Mar 20, 2019
5.7.8 Jan 8, 2019
5.7.6 Dec 19, 2018
5.7.1 Nov 28, 2018
1.1.5 Dec 2, 2017

#6 in #symbolication

Download history 7/week @ 2018-12-05 76/week @ 2018-12-12 296/week @ 2018-12-19 2/week @ 2018-12-26 70/week @ 2019-01-02 53/week @ 2019-01-09 25/week @ 2019-01-16 2/week @ 2019-01-23 2/week @ 2019-01-30 1/week @ 2019-02-06 37/week @ 2019-02-20 72/week @ 2019-02-27 8/week @ 2019-03-06 75/week @ 2019-03-13

228 downloads per month
Used in 1 crate

MIT license

5.5K SLoC


Symbolic is a library written in Rust which is used at Sentry to implement symbolication of native stack traces, sourcemap handling for minified JavaScript and more. It consists of multiple largely independent crates which are bundled together into a C and Python library so it can be used independently of Rust.

What's in the package

Currently it provides the following functionality:

  • Symbolication based on custom cache files (symcache)
  • Symbol cache file generators from:
    • Mach and ELF symbol tables
    • Mach and ELF embedded DWARF data
    • Breakpad Symbol files
  • Demangling support
    • Swift
    • C++
    • Rust
  • JavaScript sourcemap expansion
    • Basic token mapping
    • Heuristics to find original function names based on minified sources
    • Indexed sourcemap to sourcemap merging
  • Proguard function mappings
  • Minidump / Breakpad processing
    • Generate Breakpad symbol files from Mach and ELF
    • Process Minidumps to resolve process state
  • Convenient C and Python library
  • Processing of Unreal Engine 4 native crash reports
    • Extract and process minidumps
    • Expose logs and UE4 context information

Source Crates

A lot of functionality exposed by this library come from independent Rust crates for better use:

Additionally we use the following C++ libraries to fill in gaps:

Building and Development

Symbolic comes as a python library with prebuilt wheels for linux and macOS. On other operating systems or when using as rust library, you need to build symbolic manually. This always requires the latest stable Rust and Cargo, as well as a C++11 compiler.


Symbolic is licensed under the MIT license. It uses some Apache2 licensed code from Apple for the Swift demangling.


~170K SLoC