Struct State 

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

Runtime state shared with progress callbacks and handlers.

Implementations

impl<'a> State<'a>

pub fn new(pid: Pid, dwarf: Option<&'a Dwarf<'a>>) -> Self

Create a new runtime State for the given pid.

Arguments

• pid - The PID of the traced process.
• dwarf - Optional DWARF info used for source lookups.

Returns

A freshly-initialized State ready for tracing.

pub fn pid(&self) -> Pid

Return the PID associated with this state.

Returns

The Pid belonging to the traced process.

pub fn addr2line(&self, addr: u64) -> Result<Option<LineInfo>>

Resolve an address to DWARF line information when available.

Arguments

• addr - The target runtime address to resolve.

Returns

Ok(Some(LineInfo)) when DWARF had a mapping, Ok(None) when no mapping is available.

Errors

Returns Err if a DWARF lookup failure occurs during address resolution.

pub fn initial_layout(&self) -> Layout

Return the initial layout computed from available DWARF.

Returns

The initial Layout chosen based on whether DWARF is available.

pub fn layout(&self) -> &Layout

Return the currently active layout.

Returns

A reference to the current Layout.

pub fn set_layout(&mut self, layout: Layout)

Set the active layout.

Arguments

• layout - The new Layout to activate.

pub fn set_requested_layout(&mut self, layout: Layout)

Request a new layout which will be applied by the tracer loop.

Arguments

• layout - The requested Layout which will be applied asynchronously by the tracer loop.

pub fn take_requested_layout(&mut self) -> Option<Layout>

Take and return any requested layout.

Returns

Some(Layout) when a layout was requested, otherwise None.

pub fn breakpoint_mgr(&mut self) -> &mut Manager

Mutable access to the breakpoint manager owned by the state.

Returns

A mutable reference to the internal breakpoint::Manager.

pub fn print_breakpoints(&self)

Print the currently registered breakpoints to stdout.

This function writes the breakpoint manager’s display representation to stdout.

pub fn prev_rip(&self) -> Option<u64>

Return the previous RIP (if set).

Returns

The previous RIP value if one has been recorded.

pub fn set_prev_rip(&mut self, rip: u64)

Set the previous RIP value.

Arguments

• rip - The RIP value to record as previous.

pub fn printed(&self) -> Option<&String>

Return the last printed text (if any).

Returns

An optional reference to the last printed string.

pub fn set_printed(&mut self, printed: Option<String>)

Set the last printed text.

Arguments

• printed - Optional string to record as the last printed text.

pub fn execution(&self) -> &Execution

Return the current execution state.

Returns

A reference to the Execution enum representing the current execution state.

pub fn set_execution(&mut self, execution: Execution)

Update the execution state.

Arguments

• execution - The new Execution state to apply.

pub fn mode(&self) -> &Mode

Return the current tracing mode.

Returns

A reference to the current Mode used for tracing.

pub fn set_mode(&mut self, mode: Mode)

Set the tracing mode.

Arguments

• mode - The new Mode to set for tracing.