Crate addr2line

addr2line provides a cross-platform library for retrieving per-address debug information from files with DWARF debug information. Given an address, it can return the file name, line number, and function name associated with that address, as well as the inline call stack leading to that address.

At the lowest level, the library uses a Context to cache parsed information so that multiple lookups are efficient. To create a Context, you first need to open and parse the file using an object file parser such as object, create a gimli::Dwarf, and finally call Context::from_dwarf.

Location information is obtained with Context::find_location or Context::find_location_range. Function information is obtained with Context::find_frames, which returns a frame for each inline function. Each frame contains both name and location.

The library also provides a Loader which internally memory maps the files, uses the object crate to do the parsing, and creates a Context. The Context is not exposed, but the Loader provides the same functionality via Loader::find_location, Loader::find_location_range, and Loader::find_frames. The Loader also provides Loader::find_symbol to use the symbol table instead of DWARF debugging information. The Loader will load Mach-O dSYM files and split DWARF files as needed.

The crate has a CLI wrapper around the library which provides some of the functionality of the addr2line command line tool distributed with GNU binutils.

Re-exports

pub extern crate fallible_iterator;

pub extern crate gimli;

Structs

Context

The state necessary to perform address to line translation.

Frame

A function frame.

FrameIter

An iterator over function frames.

FunctionName

A function name.

Loader

A loader for the DWARF data required for a Context.

Location

A source location.

LocationRangeIter

Iterator over Locations in a range of addresses, returned by Context::find_location_range.

SplitDwarfLoad

This struct contains the information needed to find split DWARF data and to produce a gimli::Dwarf<R> for it.

Enums

LookupResult

Operations that consult debug information may require additional files to be loaded if split DWARF is being used. This enum returns the result of the operation in the Output variant, or information about the split DWARF that is required and a continuation to invoke once it is available in the Load variant.

Traits

LookupContinuation

This trait represents a partially complete operation that can be resumed once a load of needed split DWARF data is completed or abandoned by the API consumer.

Functions

demangle

Demangle a symbol name using the demangling scheme for the given language.

demangle_auto

Apply ‘best effort’ demangling of a symbol name.

Type Aliases

LoaderReader

The type used by Loader for reading DWARF data.