Enum TraceScope 

#[non_exhaustive]
pub enum TraceScope {
    LaunchedProcessTree,
    SystemWide,
}

Scope at which observation is negotiated.

running-process exposes two distinct observation tiers because the underlying OS primitives diverge sharply by privilege:

• LaunchedProcessTree — observe the process tree that this crate spawned and any descendants reparented under it. No admin / no entitlements / no kernel driver required. The crate owns the spawn boundary on every platform (Job Object on Windows, subreaper on Linux, kqueue child registration on macOS), so per-platform no-admin primitives are sufficient. This is the scope #539 wires up.
• SystemWide — observe every process on the host. Requires ETW kernel providers on Windows, eBPF/CAP_BPF on Linux, Endpoint Security entitlement on macOS. All of these need admin or signed entitlements and a separate operational story (#469).

The two scopes can coexist; backends for each are detected and reported independently. Marked #[non_exhaustive] per #431 so future scopes (e.g. cgroup-scoped, container-scoped) can land without a major bump.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

LaunchedProcessTree

Observation limited to the process tree this crate spawned. Backends for this scope must operate without admin privileges.

SystemWide

Observation of every process on the host. Backends typically require admin / entitlements / kernel drivers.

Implementations

impl TraceScope

pub const ALL: [TraceScope; 2]

All scopes in stable order.

pub fn as_str(self) -> &'static str

Stable lowercase name for serialization / matrix rendering.

Trait Implementations

impl Clone for TraceScope

fn clone(&self) -> TraceScope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TraceScope

impl Debug for TraceScope

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

Formats the value using the given formatter.

impl Eq for TraceScope

impl Hash for TraceScope

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TraceScope

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TraceScope