#dwarf #elf #symbolicate #file-line #load-file #atos

no-std addr2line

A cross-platform symbolication library written in Rust, using gimli

28 releases (breaking)

new 0.22.0 Apr 11, 2024
0.21.0 Aug 13, 2023
0.20.0 Apr 16, 2023
0.19.0 Nov 24, 2022
0.1.0 Dec 3, 2016

#15 in Debugging

Download history 649747/week @ 2023-12-21 725458/week @ 2023-12-28 1072101/week @ 2024-01-04 1093363/week @ 2024-01-11 1178868/week @ 2024-01-18 1118732/week @ 2024-01-25 1182047/week @ 2024-02-01 1222576/week @ 2024-02-08 1184322/week @ 2024-02-15 1259522/week @ 2024-02-22 1306647/week @ 2024-02-29 1261670/week @ 2024-03-07 1300668/week @ 2024-03-14 1339561/week @ 2024-03-21 1289455/week @ 2024-03-28 1077517/week @ 2024-04-04

5,238,845 downloads per month
Used in 28,610 crates (32 directly)

Apache-2.0 OR MIT



Coverage Status

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

addr2line uses gimli to parse the debug information, 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).



addr2line optimizes for speed over memory by caching parsed information. The DWARF information is parsed lazily where possible.

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, and in the past some benchmarking was done that indicates a comparable performance.


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.


~76K SLoC