19 breaking releases

✓ Uses Rust 2018 edition

0.20.0 Jan 11, 2020
0.19.0 Jul 8, 2019
0.18.0 Apr 25, 2019
0.17.0 Feb 21, 2019
0.3.0 Jul 27, 2016

#7 in Parser implementations

Download history 5599/week @ 2019-11-10 6549/week @ 2019-11-17 4832/week @ 2019-11-24 6508/week @ 2019-12-01 6042/week @ 2019-12-08 6150/week @ 2019-12-15 2801/week @ 2019-12-22 4268/week @ 2019-12-29 9335/week @ 2020-01-05 8011/week @ 2020-01-12 6463/week @ 2020-01-19 6217/week @ 2020-01-26 7783/week @ 2020-02-02 5832/week @ 2020-02-09 7098/week @ 2020-02-16

22,949 downloads per month
Used in 48 crates (18 directly)


30K SLoC


Build Status Coverage Status

gimli is a blazing fast library for consuming the DWARF debugging format.

  • Zero copy: everything is just a reference to the original input buffer. No copies of the input data get made.

  • Lazy: you can iterate compilation units without parsing their contents. Parse only as many debugging information entry (DIE) trees as you iterate over. gimli also uses DW_AT_sibling references to avoid parsing a DIE's children to find its next sibling, when possible.

  • Cross-platform: gimli makes no assumptions about what kind of object file you're working with. The flipside to that is that it's up to you to provide an ELF loader on Linux or Mach-O loader on macOS.

    • Unsure which object file parser to use? Try the cross-platform object crate. See the examples/ directory for usage with gimli.


Add this to your Cargo.toml:

gimli = "0.20.0"

The minimum supported Rust version is 1.36.0.



Licensed under either of

at your option.


See CONTRIBUTING.md for hacking.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.