Struct Anchor 

pub struct Anchor {
    pub name: String,
    pub thread: ThreadRef,
    pub position: Position,
    pub location: CodeLocation,
    pub from: Option<String>,
}

A fully normalized anchor: a named, deterministic per-thread stop point.

Fields

name: String

The event name (map key), for diagnostics and edge references.

thread: ThreadRef

The thread this anchor is on.

position: Position

The deterministic position selector.

location: CodeLocation

Optional human-legible / debug-info-resolved code location.

from: Option<String>

For a relative anchor, the event on the same thread after which its occurrences are counted (from).

Implementations

impl Anchor

pub fn is_syscall_occurrence(&self) -> bool

True for an enforced syscall-occurrence anchor: a Position::Syscall with no phase, the prehook phase or the posthook phase. Its occurrences are counted at the prehook of each matching syscall entry. It fires at the prehook of the thread’s nth matching entry, or, for the posthook phase (Anchor::fires_at_posthook), when that entry completes. The polling phase is not enforced.

pub fn fires_at_posthook(&self) -> bool

True for a syscall-occurrence anchor that fires when its syscall completes: after the call’s effect and result, before the guest resumes (https://github.com/rrnewton/hermit/issues/3929). An edge whose BEFORE anchor fires at the posthook orders that syscall’s completed effect, not just its entry.

pub fn occurrence_key(&self) -> Option<OccurrenceKey>

The per-thread counter this anchor’s occurrences are counted in: its syscall number, fd and futex operation, or None for any other kind of anchor.

pub fn syscall_occurrence_matches(&self, sysno: Sysno, args: [usize; 2]) -> bool

True when this is an enforced syscall-occurrence anchor and a call to sysno with first two arguments args is one of the calls it counts.

Trait Implementations

impl Clone for Anchor

fn clone(&self) -> Anchor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Anchor

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

Formats the value using the given formatter.

impl Display for Anchor

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

Formats the value using the given formatter.

impl Eq for Anchor

impl PartialEq for Anchor

fn eq(&self, other: &Anchor) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Anchor