Struct SymbolizerBuilder 

pub struct SymbolizerBuilder<'a> { /* private fields */ }

Configures a Symbolizer.

Implementations

impl<'a> SymbolizerBuilder<'a>

pub fn for_modules(modules: &'a [ModuleRecord]) -> Self

Configure symbolization for a module list.

pub fn disable_perf_maps(self) -> Self

Disable Python perf-map lookup.

pub fn perf_maps_for(self, processes: impl IntoIterator<Item = Pid>) -> Self

Restrict Python perf-map lookup to selected processes.

pub fn perf_map_dir(self, directory: impl Into<PathBuf>) -> Self

Read preserved perf-PID.map files from directory.

pub fn native<S>(self, factory: impl FnMut(Pid) -> S + 'static) -> Self

where S: NativeSymbolizer + 'static,

Use a caller-supplied native symbolizer factory.

The factory runs lazily, at most once per process id, when a resolve call first needs native symbols for that process.

pub fn try_native<S, E>( self, factory: impl FnMut(Pid) -> Result<S, E> + 'static, ) -> Self

where S: NativeSymbolizer + 'static, E: Error + Send + Sync + 'static,

Use a caller-supplied native symbolizer factory that may fail.

The factory runs lazily and its first successful result is retained per process id. A factory error is returned by that resolve call; a later resolve may retry construction.

pub fn kernel_symbols(self, source: KernelSymbolSource) -> Self

Select the kernel symbol source.

A preserved file should contain the same address-bearing kallsyms data that was visible on the recording host. This avoids accidentally resolving a cross-host profile against the analysis host’s kernel.

pub fn stack_cache(self, stack_cache: StackCache) -> Self

Select the owner of resolved-stack caching.

pub fn build(self) -> Result<Symbolizer>

Build the configured symbolizer.

Errors

Returns an invalid-input error for duplicate module IDs, or an I/O error when an explicit kernel symbol file cannot be loaded.

impl SymbolizerBuilder<'static>

pub fn from_modules(modules: Vec<ModuleRecord>) -> Self

Configure symbolization by transferring ownership of a module table.

This avoids copying the table when it was assembled by the caller.

Trait Implementations

impl Debug for SymbolizerBuilder<'_>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.