Enum KernelError 

pub enum KernelError {
    KernelNotFound(String),
    KernelAlreadyRegistered(String),
    InvalidStateTransition {
        from: String,
        to: String,
    },
    KernelNotActive(String),
    ValidationError(String),
    SerializationError(String),
    DeserializationError(String),
    QueueFull {
        capacity: usize,
    },
    QueueEmpty,
    MessageTooLarge {
        size: usize,
        max: usize,
    },
    Timeout(Duration),
    LaunchFailed(String),
    CompilationError(String),
    DeviceError(String),
    BackendNotAvailable(String),
    LicenseError(LicenseError),
    SLOViolation(String),
    DomainNotSupported(Domain),
    InternalError(String),
    IoError(Error),
    ConfigError(String),
    ActorError(String),
    RingKernelError(String),
    K2KError(String),
    Unauthorized(String),
    ResourceExhausted(String),
    ServiceUnavailable(String),
}

Errors that can occur during kernel operations.

Variants

KernelNotFound(String)

Kernel not found in registry.

KernelAlreadyRegistered(String)

Kernel already registered.

InvalidStateTransition

Invalid kernel state transition.

Fields

from: String

Current state.

to: String

Attempted target state.

KernelNotActive(String)

Kernel is not in active state.

ValidationError(String)

Input validation failed.

SerializationError(String)

Serialization error.

DeserializationError(String)

Deserialization error.

QueueFull

Message queue is full.

Fields

capacity: usize

Queue capacity.

QueueEmpty

Message queue is empty.

MessageTooLarge

Message too large for queue.

Fields

size: usize

Actual message size.

max: usize

Maximum allowed size.

Timeout(Duration)

Timeout waiting for response.

LaunchFailed(String)

GPU kernel launch failed.

CompilationError(String)

GPU compilation error.

DeviceError(String)

GPU device error.

BackendNotAvailable(String)

Backend not available.

LicenseError(LicenseError)

License error.

SLOViolation(String)

SLO violation.

DomainNotSupported(Domain)

Domain not supported.

InternalError(String)

Internal error.

IoError(Error)

IO error.

ConfigError(String)

Configuration error.

ActorError(String)

Actor error.

RingKernelError(String)

RingKernel error (from underlying runtime).

K2KError(String)

K2K (Kernel-to-Kernel) communication error.

Unauthorized(String)

Unauthorized access.

ResourceExhausted(String)

Resource exhausted (quota exceeded, rate limited, etc.).

ServiceUnavailable(String)

Service unavailable (circuit open, degraded, etc.).

Implementations

impl KernelError

pub fn validation(msg: impl Into<String>) -> Self

Create a validation error.

pub fn internal(msg: impl Into<String>) -> Self

Create an internal error.

pub fn not_found(id: impl Into<String>) -> Self

Create a kernel not found error.

pub fn launch_failed(msg: impl Into<String>) -> Self

Create a launch failed error.

pub fn device(msg: impl Into<String>) -> Self

Create a device error.

pub fn k2k(msg: impl Into<String>) -> Self

Create a K2K error.

pub fn is_recoverable(&self) -> bool

Returns true if this is a recoverable error (safe to retry).

pub fn is_client_error(&self) -> bool

Returns true if this is a client error (invalid input, not found, etc.).

pub fn is_license_error(&self) -> bool

Returns true if this is a license-related error.

pub fn http_status_code(&self) -> u16

Returns the suggested HTTP status code for this error.

Centralizes HTTP status mapping so that all ecosystem integrations (Axum, Tower, gRPC, Actix) use consistent status codes.

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

Returns a machine-readable error code string.

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<Error> for KernelError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<KernelError> for ResilienceError

fn from(source: KernelError) -> Self

Converts to this type from the input type.

impl From<LicenseError> for KernelError

fn from(source: LicenseError) -> Self

Converts to this type from the input type.

impl From<RingKernelError> for KernelError

Convert from ringkernel-core errors.

fn from(err: RingKernelError) -> Self

Converts to this type from the input type.

impl From<SecurityError> for KernelError

fn from(e: SecurityError) -> Self

Converts to this type from the input type.