Struct addr2line::Options

pub struct Options { /* fields omitted */ }

A builder for configuring a Mapping.

use addr2line::Options;

let mapping = Options::default()
    .with_functions()
    .build("path/to/some/executable")?;

If with_functions is not added to these options, then Mapping::locate() will always return None for the function name.

Likewise, if with_demangling is not added to these options, then all function names (if any) returned by Mapping::locate() will not be demangled.

Methods

impl Options

fn with_functions(self) -> Self

Make the Mapping also include debug information for functions, enabling Mapping::locate() to also indicate what function a given address appears in. This comes at some parsing and lookup cost.

fn with_demangling(self) -> Self

Make the Mapping attempt to demangle Rust and/or C++ symbols. This option implies with_functions.

fn build<P>(self, file_path: P) -> Result<Mapping> where
    P: AsRef<Path>, 

Finish configuration and build the Mapping.

The target file will be memmap'd, and then gimli is used to parse out the necessary debug symbols, without copying data when possible.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Options

impl Default for Options

fn default() -> Options

Returns the "default value" for a type.