Struct addr2line::Options

pub struct Options { /* fields omitted */ }

A builder for configuring a Mapping or BufferMapping.

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 a 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.

fn build_from_buffer<'input>(
    self,
    buffer: &'input [u8]
) -> Result<BufferMapping<'input>>

Finish configuration and build a BufferMapping.

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.