Enum ErrorCode 

#[non_exhaustive]
pub enum ErrorCode {
    DeviceOutOfMemory,
    UnsupportedFeature,
    PoisonedLock,
    KernelCompileFailed,
    DispatchFailed,
    InvalidProgram,
    CooperativeResidencyExceeded,
    Unknown,
}

Machine-readable classification of a backend failure kind.

Use this to drive retry logic, circuit breakers, and alerting rules without parsing human-readable message strings.

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.

DeviceOutOfMemory

Backend device reported insufficient memory.

UnsupportedFeature

The backend does not support a required feature.

PoisonedLock

A lock used by the backend failed to unlock safely.

This is generally caused by a panic while a write guard was held and indicates an internal synchronization bug in process state.

KernelCompileFailed

GPU kernel-source compilation failed. “Shader” in the variant name is historical; the code covers any kernel-source compile failure for any backend kernel-source or binary validation. A 2.0 rename to KernelCompileFailed is tracked in the semver-policy doc; the variant stays stable in 0.x.

DispatchFailed

Command dispatch or queue submission failed.

InvalidProgram

The program itself is invalid for this backend.

CooperativeResidencyExceeded

A cooperative (whole-grid-sync) launch could not fit every block co-resident on the device. This is a routable performance condition, not a hard failure: the orchestrator should fall back (loudly) to a recall-identical non-cooperative path (resident fixpoint or host split).

Unknown

Unclassified error (produced by BackendError::new).

Implementations

impl ErrorCode

pub const fn stable_id(self) -> u32

Stable integer identifier for API consumers and diagnostic catalogs.

These ids are append-only. Existing assignments must not be reused or renumbered because downstream systems may persist them in telemetry, alert rules, and retry policies.

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl PartialEq for ErrorCode

fn eq(&self, other: &ErrorCode) -> 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 ErrorCode