Rust Shell R
Switch branches/tags
Clone or download
Latest commit ca23d98 Jul 10, 2018

README.md

addr2line

Build Status Coverage Status

A cross-platform library for retrieving per-address debug information from executables with DWARF debug symbols.

addr2line uses gimli to parse the debug symbols of an executable, and exposes an interface for finding the source file, line number, and wrapping function for instruction addresses within the target program. These lookups can either be performed programmatically through Context::find_location and Context::find_frames, or via the included example binary, addr2line (named and modelled after the equivalent utility from GNU binutils).

Quickstart

Performance

The library aims to perform similarly to equivalent existing tools such as addr2line from binutils, eu-addr2line from elfutils, and llvm-symbolize from the llvm project.

Currently the library optimizes for memory over for speed when parsing line number sequences. In particular, the algorithm used can be slow for large line sequences, but uses much less memory. Note that LLVM generates one line sequence per function, but gcc can include multiple functions in each line sequence.

We haven't done extensive benchmarking (yet), but the runtime and memory use results we observe for one relatively large Rust application are quite promising:

addr2line runtime addr2line memory

License

Licensed under either of

at your option.

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.