Enum DegradationReason 

pub enum DegradationReason {
    None,
    MissingCapBpf,
    MissingCapPerfmon,
    MissingBpfCapabilities,
    EbpfFeatureDisabled,
    KernelUnsupported,
    BpfPermissionDenied,
    KprobeAttachFailed(String),
    BtfUnavailable,
    EbpfLoadFailed(String),
    BinaryOnNosuidMount,
}

Reasons why process detection may be degraded from optimal

Variants

None

No degradation - optimal method available

MissingCapBpf

Missing CAP_BPF capability (Linux 5.8+)

MissingCapPerfmon

Missing CAP_PERFMON capability (Linux 5.8+)

MissingBpfCapabilities

Missing both CAP_BPF and CAP_PERFMON (and no CAP_SYS_ADMIN fallback)

EbpfFeatureDisabled

eBPF feature not compiled in

KernelUnsupported

Kernel doesn’t support required eBPF features (e.g. ENOSYS from bpf(2))

BpfPermissionDenied

BPF syscall denied despite caps - typically AppArmor, kernel lockdown, or unprivileged_bpf_disabled interactions

KprobeAttachFailed(String)

Failed to attach a kprobe (e.g. symbol missing from kernel). The String carries the symbol name where known.

BtfUnavailable

Kernel BTF unavailable / CO-RE relocation failed (no /sys/kernel/btf/vmlinux)

EbpfLoadFailed(String)

Generic eBPF load failure carrying the truncated libbpf error text

BinaryOnNosuidMount

Binary lives on a filesystem mounted with nosuid, which makes the kernel silently ignore file capabilities set via setcap. Common when the binary is under /home, /tmp, or a removable mount.

Implementations

impl DegradationReason

pub fn description(&self) -> Cow<'_, str>

Get human-readable description of what’s needed

pub fn unavailable_feature(&self) -> Option<&str>

Get the name of the unavailable feature

Trait Implementations

impl Clone for DegradationReason

fn clone(&self) -> DegradationReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DegradationReason

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

Formats the value using the given formatter.

impl Default for DegradationReason

fn default() -> DegradationReason

Returns the “default value” for a type.

impl PartialEq for DegradationReason

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for DegradationReason