Struct ObserverCapabilities 

pub struct ObserverCapabilities { /* private fields */ }

The full capability matrix produced by ObserverCapabilities::negotiate or ObserverCapabilities::negotiate_for_scope.

Each EventCategory appears exactly once for the negotiated TraceScope. Phase 1 reports Lifecycle as Supported in every scope (the spawn/reap path is scope-independent); the rest start out as Unavailable and flip to Supported/Partial as per-OS backends land (#539 for LaunchedProcessTree, #469 for SystemWide).

Implementations

impl ObserverCapabilities

pub fn negotiate() -> Self

Negotiate the capability matrix for the current platform under the historical default scope (TraceScope::SystemWide).

Preserved for backwards compatibility with pre-#539 callers. New callers that know which tier they want should use negotiate_for_scope — the LaunchedProcessTree scope advertises different per-OS backends (no-admin: NT handle snapshot, /proc/<pid>/fd/*, proc_pidinfo) than the SystemWide scope (admin-gated: ETW, eBPF, EndpointSecurity).

pub fn negotiate_for_scope(scope: TraceScope) -> Self

Negotiate the capability matrix for the current platform at the requested TraceScope.

Lifecycle is Supported in every scope (the spawn/reap path is scope-independent and runs in-process with no admin requirement). File/Network/Process start out Unavailable and flip to Supported/Partial as per-OS backends land — the scope × OS dispatch lives in the crate-private detect_*_backend helpers.

pub fn scope(&self) -> TraceScope

The TraceScope this matrix was negotiated for.

pub fn categories(&self) -> &[CategoryCapability]

Return the capability entries in stable EventCategory::ALL order.

pub fn category(&self, category: EventCategory) -> &CategoryCapability

Look up the capability entry for one category.

pub fn support(&self, category: EventCategory) -> CapabilitySupport

Return the negotiated support level for one category.

pub fn is_supported(&self, category: EventCategory) -> bool

Return whether a category is fully Supported.

pub fn to_table_rows(&self) -> Vec<[String; 4]>

Return the capability matrix as four fixed-width rows suitable for downstream UX (e.g. a clud CLI flag — see Phase 4 of #221 / #431).

Each row is [category, support, backend, reason]. Row order matches EventCategory::ALL, so consumers can rely on a stable layout. The strings are owned so callers can paint colors / pad columns without borrowing from self.

pub fn render_summary(&self) -> String

Render the capability matrix as a single human-readable string.

The output is deterministic per scope+category set so a UI can snapshot or diff it. The first line names the negotiated TraceScope so a diff between scopes is obvious. Layout:

observer capabilities (scope=system-wide):
  lifecycle    supported    portable-lifecycle  started/exited emitted from the crate spawn and reap path
  file         unavailable  etw                 Phase 3: Windows ETW file backend not yet implemented
  network      unavailable  etw                 Phase 3: Windows ETW network backend not yet implemented
  process      unavailable  etw                 Phase 3: Windows ETW process backend not yet implemented

Phase 4 (#431) consumers like the clud CLI use this to show the actually negotiated matrix rather than claiming syscall coverage the active backends do not provide.

Trait Implementations

impl Clone for ObserverCapabilities

fn clone(&self) -> ObserverCapabilities

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObserverCapabilities

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

Formats the value using the given formatter.

impl Eq for ObserverCapabilities

impl PartialEq for ObserverCapabilities

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ObserverCapabilities