Struct rstack::TraceOptions

pub struct TraceOptions { /* private fields */ }

Options controlling the behavior of tracing.

Implementations

impl TraceOptions

pub fn new() -> TraceOptions

Returns a new TraceOptions with default settings.

pub fn snapshot(&mut self, snapshot: bool) -> &mut TraceOptions

If set, the threads of the process will be traced in a consistent snapshot.

A snapshot-mode trace ensures a consistent view of all threads, but requires that all threads be paused for the entire duration of the trace.

Defaults to false.

pub fn thread_names(&mut self, thread_names: bool) -> &mut TraceOptions

If set, the names of the process’s threads will be recorded.

Defaults to false.

pub fn symbols(&mut self, symbols: bool) -> &mut TraceOptions

If set, information about the symbol at each frame will be recorded.

Defaults to false.

pub fn ptrace_attach(&mut self, ptrace_attach: bool) -> &mut TraceOptions

If set, rstack will automatically attach to threads via ptrace.

If disabled, the calling process must already be attached to all traced threads, and the threads must be in the stopped state.

Defaults to true.

pub fn trace(&self, pid: u32) -> Result<Process>

Traces the threads of the specified process.

Trait Implementations

impl Clone for TraceOptions

fn clone(&self) -> TraceOptions

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TraceOptions

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

Formats the value using the given formatter.

impl Default for TraceOptions

fn default() -> TraceOptions

Returns the “default value” for a type.