Enum LoaderError 

pub enum LoaderError {
    LibraryNotFound {
        library: &'static str,
        candidates: Vec<&'static str>,
        search_paths: usize,
    },
    SymbolNotFound {
        library: &'static str,
        symbol: &'static str,
    },
    VersionTooOld {
        symbol: &'static str,
        required: CudaVersion,
        installed: CudaVersion,
    },
    Libloading(Error),
    UnsupportedPlatform {
        platform: &'static str,
    },
}

An error raised by the dynamic loader.

These surface whenever an NVIDIA shared library or one of its symbols cannot be resolved at runtime — typically because CUDA is not installed, the installed driver is older than what baracuda was built against, or the user is on a platform NVIDIA doesn’t support.

Variants

LibraryNotFound

None of the candidate library filenames resolved anywhere on the library search path.

Fields

library: &'static str

candidates: Vec<&'static str>

search_paths: usize

SymbolNotFound

The library was loaded but did not export the requested symbol.

Fields

library: &'static str

symbol: &'static str

VersionTooOld

cuGetProcAddress returned CU_GET_PROC_ADDRESS_VERSION_NOT_SUFFICIENT for symbol: the installed driver does not provide it at the version baracuda asked for.

Fields

symbol: &'static str

required: CudaVersion

installed: CudaVersion

Libloading(Error)

Raw libloading error — kept for platform-specific diagnostics that the other variants can’t express (e.g. a missing dependency on a chained .so).

UnsupportedPlatform

baracuda does not target this platform (e.g. macOS).

Fields

platform: &'static str

Implementations

impl LoaderError

pub fn library_not_found( library: &'static str, candidates: &[&'static str], ) -> Self

Convenience constructor for the common case of “tried these names, none worked”.

pub fn library_not_found_with_search( library: &'static str, candidates: &[&'static str], search_path_count: usize, ) -> Self

As above, but records how many directories were searched.

Trait Implementations

impl Debug for LoaderError

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

Formats the value using the given formatter.

impl Display for LoaderError

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

Formats the value using the given formatter.

impl Error for LoaderError

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 LoaderError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<LoaderError> for BaracudaError

fn from(source: LoaderError) -> Self

Converts to this type from the input type.

impl<S> From<LoaderError> for Error<S>

where S: CudaStatus + Send + Sync + 'static,

fn from(source: LoaderError) -> Self

Converts to this type from the input type.