Enum EbpfMonitorError 

pub enum EbpfMonitorError {
    Unsupported {
        host: &'static str,
    },
    FeatureDisabled,
    ObjectMissing {
        path: String,
    },
    Setns {
        source: Error,
    },
    LoadFailed {
        message: String,
    },
    AttachFailed {
        iface: String,
        message: String,
    },
    RingBufferOpenFailed {
        message: String,
    },
}

Errors returned by EbpfFlowMonitor::start.

All variants are non-fatal at the supervisor level: the per-flow activation path (per_flow::activate_per_flow_listener) catches them, logs a tracing::warn, and falls back to the nflog listener so the cell still emits network_flow_decision events on the existing path.

Variants

Unsupported

Host platform is not Linux. eBPF requires Linux kernel support.

Fields

host: &'static str

FeatureDisabled

Linux host but the crate was built without the ebpf-aya Cargo feature. The supervisor binary ships with the feature off by default so macOS / non-eBPF Linux builds don’t pay for a kernel dependency they cannot use.

ObjectMissing

The BPF object file referenced by CELLOS_EBPF_OBJECT_PATH (or the default path) was not present on disk. Real deployments pre-build cellos-supervisor-ebpf via cargo bpf and stage the resulting object alongside the supervisor binary; the env var lets operators override the location.

Fields

path: String

Setns

setns(2) into the cell’s network namespace failed. Usually EPERM (missing CAP_SYS_ADMIN) or ENOENT (cell already torn down).

Fields

source: Error

LoadFailed

Loading the BPF object via aya failed. Surfaces verifier rejections, license issues, missing program sections, etc.

Fields

message: String

AttachFailed

Attaching the loaded program to the tap interface via tc clsact failed. Usually ENODEV (tap iface missing) or EEXIST (clsact qdisc collision with an operator-provisioned qdisc on the same interface).

Fields

iface: String

message: String

RingBufferOpenFailed

Opening the ring-buffer map for draining failed.

Fields

message: String

Trait Implementations

impl Debug for EbpfMonitorError

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

Formats the value using the given formatter.

impl Display for EbpfMonitorError

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

Formats the value using the given formatter.

impl Error for EbpfMonitorError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.