Enum GpuError 

pub enum GpuError {
    DriverLibraryUnavailable {
        reason: String,
    },
    DriverSymbolMissing {
        reason: String,
    },
    DriverCallFailed {
        reason: String,
    },
    CalibrationFailed {
        reason: String,
    },
    NoDeviceKernel {
        reason: String,
    },
}

Typed error for src/gpu/*.rs operations.

Variants

DriverLibraryUnavailable

The CUDA driver shared library (libcuda.so / nvcuda.dll / libcuda.dylib) or one of its sibling stubs (cuSOLVER, cuSPARSE) could not be loaded from any of the searched candidates.

Fields

reason: String

DriverSymbolMissing

A required CUDA / cuBLAS / cuSOLVER / cuSPARSE symbol was missing from a loaded library (i.e. libloading::Library::get returned an error for a name we need).

Fields

reason: String

DriverCallFailed

A CUDA driver / cuSOLVER / cuSPARSE C API call returned a non-zero status code, or a cudarc safe wrapper (context bind, stream create, cuBLAS init, alloc, memcpy, gemm, synchronize) failed.

Fields

reason: String

CalibrationFailed

Runtime throughput calibration produced an unusable measurement (non-positive elapsed time, non-finite GB/s or GFLOPS).

Fields

reason: String

NoDeviceKernel

No device kernel exists for the requested GPU code path on this build. Device kernels are added opportunistically as accelerations; the absence of one is a permanently-possible, correctly-handled condition — not a defect — because the CPU path it falls back to is the correct reference computation. Callers treat this as a sentinel to fall back to the CPU path silently (no panic, no error log). Distinct from DriverCallFailed so the dispatcher can tell “no kernel for this path” apart from “the device refused”. Carries a short reason for diagnostics, e.g. the kernel name. (Any GPU acceleration roadmap belongs in an issue, not here.)

Fields

reason: String

Trait Implementations

impl Clone for GpuError

fn clone(&self) -> GpuError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GpuError

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

Formats the value using the given formatter.

impl Display for GpuError

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

Formats the value using the given formatter.

impl Error for GpuError

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<GpuError> for String

fn from(err: GpuError) -> String

Converts to this type from the input type.