Enum LoadError 

pub enum LoadError {
    Open {
        path: PathBuf,
        message: String,
    },
    NoEntrySymbol {
        path: PathBuf,
        symbol: &'static str,
    },
    Major {
        path: PathBuf,
        found: u32,
        expected: u32,
    },
    MissingCapability {
        path: PathBuf,
        capability: &'static str,
    },
    ShortTable {
        path: PathBuf,
        capability: &'static str,
        found: usize,
        expected: usize,
    },
}

A plugin could not be loaded, or does not speak this ABI.

Variants

Open

The library itself could not be opened: not a dynamic library, wrong architecture, a missing dependency of the plugin’s own.

Fields

path: PathBuf

The file that was tried.

message: String

The loader’s own message.

NoEntrySymbol

The library opened, but exports no entry symbol.

This is the clean failure for “built against a different contract”: the symbol carries the root structure’s layout, so an old host looking for the old name finds nothing instead of reading fields that moved.

Fields

path: PathBuf

The file that was tried.

symbol: &'static str

The symbol that was looked for.

Major

The plugin reports a different semantic major version.

Fields

path: PathBuf

The file that was tried.

found: u32

What the plugin says.

expected: u32

What this host speaks.

MissingCapability

The plugin does not provide a capability this host cannot work without.

Fields

path: PathBuf

The file that was tried.

capability: &'static str

The capability’s name.

ShortTable

The plugin provides a capability, but its table is smaller than this host knows how to read.

Fields

path: PathBuf

The file that was tried.

capability: &'static str

The capability’s name.

found: usize

The size the plugin declared.

expected: usize

The size this host needs.

Trait Implementations

impl Debug for LoadError

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

Formats the value using the given formatter.

impl Display for LoadError

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

Formats the value using the given formatter.

impl Error for LoadError

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.