Skip to main content

ObserverCapabilities

Struct ObserverCapabilities 

Source
pub struct ObserverCapabilities { /* private fields */ }
Expand description

The full capability matrix produced by ObserverCapabilities::negotiate.

Each EventCategory appears exactly once. Phase 1 reports Lifecycle as Supported and the rest as Unavailable.

Implementations§

Source§

impl ObserverCapabilities

Source

pub fn negotiate() -> Self

Negotiate the capability matrix for the current platform.

Phase 1 reports Lifecycle as Supported (portable, OS-agnostic). Phase 3 categories (File, Network, Process) currently report Unavailable, but the backend name and reason are now per-OS via #[cfg]-gated detection helpers (#430). This keeps the ObserverCapabilities::negotiate() contract stable for Phase 4 downstream UX while letting Phase 3 light each backend up independently — flipping UnavailableSupported per backend lands without touching this function’s shape.

Source

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

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

Source

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

Look up the capability entry for one category.

Source

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

Return the negotiated support level for one category.

Source

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

Return whether a category is fully Supported.

Source

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.

Source

pub fn render_summary(&self) -> String

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

The output is deterministic per category set so a UI can snapshot or diff it. Layout:

observer capabilities:
  lifecycle    supported    portable-lifecycle  started/exited emitted from the crate spawn and reap path
  file         unavailable  none                requires Phase 3 platform backend (seccomp/eBPF/ETW)
  network      unavailable  none                requires Phase 3 platform backend (seccomp/eBPF/ETW)
  process      unavailable  none                requires Phase 3 platform backend (seccomp/eBPF/ETW)

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§

Source§

impl Clone for ObserverCapabilities

Source§

fn clone(&self) -> ObserverCapabilities

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ObserverCapabilities

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for ObserverCapabilities

Source§

impl PartialEq for ObserverCapabilities

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl StructuralPartialEq for ObserverCapabilities

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> TryClone for T
where T: Clone,

Source§

fn try_clone(&self) -> Result<T, Error>

Clones self, possibly returning an error.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.