Enum RingKernelError 

pub enum RingKernelError {
    KernelNotFound(String),
    KernelAlreadyActive(String),
    KernelNotActive(String),
    KernelTerminated(String),
    InvalidStateTransition {
        from: String,
        to: String,
    },
    InvalidState {
        expected: String,
        actual: String,
    },
    LaunchFailed(String),
    CompilationError(String),
    QueueFull {
        capacity: usize,
    },
    QueueEmpty,
    SerializationError(String),
    DeserializationError(String),
    ValidationError(String),
    MessageTooLarge {
        size: usize,
        max: usize,
    },
    Timeout(Duration),
    AllocationFailed {
        size: usize,
        reason: String,
    },
    HostAllocationFailed {
        size: usize,
    },
    TransferFailed(String),
    InvalidAlignment {
        expected: usize,
        actual: usize,
    },
    OutOfMemory {
        requested: usize,
        available: usize,
    },
    PoolExhausted,
    InvalidIndex(usize),
    MemoryError(String),
    BackendUnavailable(String),
    BackendInitFailed(String),
    NoDeviceFound,
    DeviceSelectionFailed(String),
    BackendError(String),
    DeadlockDetected,
    LockPoisoned,
    ChannelClosed,
    ClockSkew {
        skew_ms: u64,
        max_ms: u64,
    },
    InvalidTimestamp,
    K2KError(String),
    K2KDestinationNotFound(String),
    K2KDeliveryFailed(String),
    PubSubError(String),
    TopicNotFound(String),
    SubscriptionError(String),
    MultiGpuError(String),
    DeviceNotAvailable(String),
    CrossDeviceTransferFailed(String),
    TelemetryError(String),
    MetricsCollectionFailed(String),
    InvalidConfig(String),
    MissingConfig(String),
    StdIoError(Error),
    IoError(String),
    InvalidCheckpoint(String),
    CheckpointSaveFailed(String),
    CheckpointRestoreFailed(String),
    CheckpointNotFound(String),
    HealthCheckFailed {
        name: String,
        reason: String,
    },
    CircuitBreakerOpen {
        name: String,
    },
    RetryExhausted {
        attempts: u32,
        reason: String,
    },
    WatchdogTimeout {
        kernel_id: String,
    },
    LoadSheddingRejected {
        level: String,
    },
    MigrationFailed(String),
    MigrationSourceNotReady {
        kernel_id: String,
    },
    MigrationDestinationUnavailable {
        device_id: usize,
    },
    TracingError(String),
    SpanNotFound(String),
    MetricsExportFailed(String),
    Internal(String),
    NotSupported(String),
    Cancelled,
}

Comprehensive error type for RingKernel operations.

Variants

KernelNotFound(String)

Kernel not found with the given ID.

KernelAlreadyActive(String)

Kernel is already active.

KernelNotActive(String)

Kernel is not active.

KernelTerminated(String)

Kernel has already terminated.

InvalidStateTransition

Invalid kernel state transition.

Fields

from: String

Current state

to: String

Attempted target state

InvalidState

Invalid kernel state.

Fields

expected: String

Expected state

actual: String

Actual state

LaunchFailed(String)

Kernel launch failed.

CompilationError(String)

Kernel compilation failed (NVRTC, shader compilation, etc.).

QueueFull

Queue is full, message cannot be enqueued.

Fields

capacity: usize

Queue capacity

QueueEmpty

Queue is empty, no message to dequeue.

SerializationError(String)

Message serialization failed.

DeserializationError(String)

Message deserialization failed.

ValidationError(String)

Message validation failed.

MessageTooLarge

Message too large.

Fields

size: usize

Actual message size

max: usize

Maximum allowed size

Timeout(Duration)

Message timeout.

AllocationFailed

GPU memory allocation failed.

Fields

size: usize

Requested size

reason: String

Failure reason

HostAllocationFailed

Host memory allocation failed.

Fields

size: usize

Requested size

TransferFailed(String)

Memory transfer failed.

InvalidAlignment

Invalid memory alignment.

Fields

expected: usize

Expected alignment

actual: usize

Actual alignment

OutOfMemory

Out of GPU memory.

Fields

requested: usize

Requested size

available: usize

Available memory

PoolExhausted

Memory pool exhausted.

InvalidIndex(usize)

Invalid index (out of bounds).

MemoryError(String)

Generic memory error.

BackendUnavailable(String)

Backend not available.

BackendInitFailed(String)

Backend initialization failed.

NoDeviceFound

No suitable GPU device found.

DeviceSelectionFailed(String)

Device selection failed.

BackendError(String)

Backend operation failed.

DeadlockDetected

Deadlock detected.

LockPoisoned

Lock poisoned.

ChannelClosed

Channel closed.

ClockSkew

Clock skew too large.

Fields

skew_ms: u64

Detected skew in milliseconds

max_ms: u64

Maximum allowed skew

InvalidTimestamp

Invalid timestamp.

K2KError(String)

K2K messaging error.

K2KDestinationNotFound(String)

K2K destination not found.

K2KDeliveryFailed(String)

K2K delivery failed.

PubSubError(String)

Pub/sub error.

TopicNotFound(String)

Topic not found.

SubscriptionError(String)

Subscription error.

MultiGpuError(String)

Multi-GPU coordination error.

DeviceNotAvailable(String)

Device not available.

CrossDeviceTransferFailed(String)

Cross-device transfer failed.

TelemetryError(String)

Telemetry error.

MetricsCollectionFailed(String)

Metrics collection failed.

InvalidConfig(String)

Invalid configuration.

MissingConfig(String)

Missing required configuration.

StdIoError(Error)

I/O error wrapper.

IoError(String)

I/O error with string message.

InvalidCheckpoint(String)

Invalid checkpoint format or data.

CheckpointSaveFailed(String)

Checkpoint save failed.

CheckpointRestoreFailed(String)

Checkpoint restore failed.

CheckpointNotFound(String)

Checkpoint not found.

HealthCheckFailed

Health check failed.

Fields

name: String

Health check name

reason: String

Failure reason

CircuitBreakerOpen

Circuit breaker is open.

Fields

name: String

Circuit breaker name

RetryExhausted

Retry attempts exhausted.

Fields

attempts: u32

Number of attempts made

reason: String

Last failure reason

WatchdogTimeout

Kernel watchdog timeout.

Fields

kernel_id: String

Kernel ID that timed out

LoadSheddingRejected

Load shedding rejected request.

Fields

level: String

Current degradation level

MigrationFailed(String)

Kernel migration failed.

MigrationSourceNotReady

Migration source not ready.

Fields

kernel_id: String

Source kernel ID

MigrationDestinationUnavailable

Migration destination unavailable.

Fields

device_id: usize

Destination device ID

TracingError(String)

Tracing error.

SpanNotFound(String)

Span not found.

MetricsExportFailed(String)

Metrics export failed.

Internal(String)

Internal error.

NotSupported(String)

Feature not supported.

Cancelled

Operation cancelled.

Implementations

impl RingKernelError

pub fn is_recoverable(&self) -> bool

Returns true if this error is recoverable.

pub fn is_resource_error(&self) -> bool

Returns true if this error indicates a resource issue.

pub fn is_fatal(&self) -> bool

Returns true if this is a fatal error requiring restart.

pub fn is_health_error(&self) -> bool

Returns true if this is a health/resilience related error.

pub fn is_migration_error(&self) -> bool

Returns true if this is a migration-related error.

pub fn is_observability_error(&self) -> bool

Returns true if this is an observability-related error.

Trait Implementations

impl Debug for RingKernelError

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

Formats the value using the given formatter.

impl Display for RingKernelError

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

Formats the value using the given formatter.

impl Error for RingKernelError

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 RingKernelError

fn from(source: Error) -> RingKernelError

Converts to this type from the input type.