Enum HookSupport 

#[non_exhaustive]
pub enum HookSupport {
    FeatureDisabled,
    Available,
    Unavailable {
        reason: &'static str,
    },
}

Per-OS support level the hook tier reports back to consumers.

Mirrors the CapabilitySupport shape in [running_process::observer] but specialized for the hook-feature-flag distinction — knowing the feature is enabled in this build is orthogonal to knowing the host kernel supports the per-OS injection vehicle.

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.

FeatureDisabled

The embed-helper Cargo feature was off at build time. No sidecar binary is embedded; the consumer must rebuild with the feature on to use hooks. This is the default for the published crate so static AV exposure stays at zero.

Available

The feature is enabled and the per-OS injection vehicle is available on this host. Hooks will install on attach.

Unavailable

The feature is enabled but the per-OS injection vehicle is unavailable (e.g. macOS SIP-protected target binary, hardened-runtime without the required entitlement, or a platform without an injector implementation yet). Carries a stable lowercase reason string so consumers can surface it.

Fields

reason: &'static str

Why the injection vehicle isn’t available right now.

Implementations

impl HookSupport

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

Stable lowercase short name for serialization / matrix rendering — matches the as_str() convention in [running_process::observer].

Trait Implementations

impl Clone for HookSupport

fn clone(&self) -> HookSupport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HookSupport

impl Debug for HookSupport

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

Formats the value using the given formatter.

impl Eq for HookSupport

impl PartialEq for HookSupport

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HookSupport