Struct Process 

pub struct Process {
    pub pid: Pid,
    pub debug_syms: bool,
    pub perf_map: bool,
    pub map_files: bool,
    pub vdso: bool,
    /* private fields */
}

Configuration for process based address symbolization.

This type is used in the Source::Process variant.

The corresponding addresses supplied to Symbolizer::symbolize are expected to be absolute addresses (Input::AbsAddr) as valid within the process identified by the pid member.

Notes

Please note that process symbolization is generally a privileged operation and may require the granting of additional capabilities compared to other symbolization sources.

Fields

pid: Pid

The referenced process’ ID.

debug_syms: bool

Whether or not to consult debug symbols to satisfy the request (if present).

On top of this runtime configuration, the crate needs to be built with the dwarf feature to actually consult debug symbols. If neither is satisfied, ELF symbols will be used.

perf_map: bool

Whether to incorporate a process’ perf map file into the symbolization procedure.

Perf map files mostly have relevance in just-in-time compiled languages, where they provide an interface for the runtime to expose addresses of dynamic symbols to profiling tools.

map_files: bool

Whether to work with /proc/<pid>/map_files/ entries or with symbolic paths mentioned in /proc/<pid>/maps instead.

map_files usage is generally strongly encouraged, as symbolic path usage is unlikely to work reliably in mount namespace contexts or when files have been deleted from the file system. However, by using symbolic paths the need for requiring the SYS_ADMIN capability is eliminated.

vdso: bool

Whether or not to symbolize addresses in a vDSO (virtual dynamic shared object).

Implementations

impl Process

pub fn new(pid: Pid) -> Self

Create a new Process object using the provided pid.

debug_syms, perf_map, map_files, and vdso default to true when using this constructor.

Trait Implementations

impl Clone for Process

fn clone(&self) -> Process

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Process

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

Formats the value using the given formatter.

impl From<Process> for Source<'static>

fn from(process: Process) -> Self

Converts to this type from the input type.