Enum KernelError 

#[non_exhaustive]
pub enum KernelError {
    ProcessNotFound {
        pid: u64,
    },
    InvalidStateTransition {
        pid: u64,
        from: ProcessState,
        to: ProcessState,
    },
    ProcessTableFull {
        max: u32,
    },
    Service(String),
    Boot(String),
    BootRefused(String),
    Ipc(String),
    MessageTooLarge {
        size: usize,
        limit: usize,
    },
    WrongState {
        expected: String,
        actual: String,
    },
    CapabilityDenied {
        pid: u64,
        action: String,
        reason: String,
    },
    ResourceLimitExceeded {
        pid: u64,
        resource: String,
        current: u64,
        limit: u64,
    },
    SpawnFailed {
        agent_id: String,
        reason: String,
    },
    BackendNotAvailable {
        backend: String,
        reason: String,
    },
    Timeout {
        operation: String,
        duration_ms: u64,
    },
    Config(String),
    QuotaExceeded {
        agent_id: String,
        current_bytes: u64,
        limit_bytes: u64,
    },
    GovernanceDenied(String),
    Mesh(String),
    Other(Box<dyn Error + Send + Sync>),
}

Kernel-level errors.

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.

ProcessNotFound

Process not found in the process table.

Fields

pid: u64

The PID that was looked up.

InvalidStateTransition

Invalid process state transition.

Fields

pid: u64

The affected PID.

from: ProcessState

Current state.

to: ProcessState

Requested state.

ProcessTableFull

Process table has reached maximum capacity.

Fields

max: u32

Maximum number of processes allowed.

Service(String)

Service-related error.

Boot(String)

Boot sequence error.

BootRefused(String)

Boot refused for a reason retrying cannot fix (chain lock held, legacy chain adoption refused, unusable boot configuration). The daemon exits 78 on this so service managers do not restart-loop it.

Ipc(String)

IPC / messaging error.

MessageTooLarge

IPC frame exceeded the configured maximum payload size.

Fields

size: usize

Observed serialized size in bytes.

limit: usize

Configured limit in bytes (16 MiB by default).

WrongState

Kernel is in wrong state for requested operation.

Fields

expected: String

Expected state.

actual: String

Actual state.

CapabilityDenied

Capability check denied an action.

Fields

pid: u64

The PID of the process that was denied.

action: String

The action that was attempted.

reason: String

Why the action was denied.

ResourceLimitExceeded

Resource limit exceeded.

Fields

pid: u64

The PID of the process.

resource: String

Name of the resource (memory, cpu_time, etc.).

current: u64

Current usage value.

limit: u64

Configured limit.

SpawnFailed

Agent spawn failed.

Fields

agent_id: String

The agent that was being spawned.

reason: String

Why the spawn failed.

BackendNotAvailable

Spawn backend not available (defined but not yet implemented).

Fields

backend: String

The backend that was requested.

reason: String

Why the backend is not available.

Timeout

Operation timed out.

Fields

operation: String

Description of the operation that timed out.

duration_ms: u64

How long we waited before timing out.

Config(String)

Configuration error.

QuotaExceeded

Disk quota exceeded (K1-G4).

Fields

agent_id: String

Agent that exceeded its quota.

current_bytes: u64

Current disk usage.

limit_bytes: u64

Configured limit.

GovernanceDenied(String)

Governance gate denied the action.

Mesh(String)

Mesh networking error.

Other(Box<dyn Error + Send + Sync>)

Wraps a generic error from downstream crates.

Trait Implementations

impl Debug for KernelError

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

Formats the value using the given formatter.

impl Display for KernelError

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

Formats the value using the given formatter.

impl Error for KernelError

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.

impl From<Box<dyn Error + Send + Sync>> for KernelError

fn from(source: Box<dyn Error + Send + Sync>) -> Self

Converts to this type from the input type.