Enum SandboxLoadError 

#[non_exhaustive]
pub enum SandboxLoadError {
    InvalidManifest(String),
    Wasm(String),
    ForbiddenImports(Vec<CapabilityDenial>),
    FuelBelowFixedCharges {
        fuel: u64,
        instantiation: u64,
    },
    InstantiationTooExpensive {
        what: &'static str,
        found: usize,
        max: usize,
    },
    ModuleTooLarge {
        found: usize,
        max: usize,
    },
    MissingStart,
    MissingMemory,
    StartSectionForbidden,
    SegmentOutOfBounds {
        what: &'static str,
        end: u64,
        capacity: u64,
    },
    MemoryTooLarge {
        found: u64,
        max: usize,
    },
    Engine(String),
}

Why an artifact could not be loaded at all.

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.

InvalidManifest(String)

The manifest handed to SandboxHost::from_module does not satisfy the rules parsing enforces — it was built or mutated rather than parsed.

Wasm(String)

The bytes are not a WebAssembly module this engine can compile.

ForbiddenImports(Vec<CapabilityDenial>)

The module imports something no host function defines.

FuelBelowFixedCharges

The manifest’s fuel budget cannot cover what every request must spend before the guest runs at all, so no route it declares could ever answer.

Fields

fuel: u64

The budget the manifest declares.

instantiation: u64

What instantiating this module costs, every request, before _start.

InstantiationTooExpensive

The module’s data or element segments would make every request’s instantiation expensive, in host work no fuel budget prices.

Fields

what: &'static str

What was counted.

found: usize

How many the module carries.

max: usize

The ceiling.

ModuleTooLarge

The module is larger than MAX_MODULE_BYTES.

The container reader applies this to a module it unpacks; this applies it to one handed straight to SandboxHost::from_module or SandboxHost::imports_of, which never passed through that reader.

Fields

found: usize

The module’s length.

max: usize

The ceiling.

MissingStart

The module exports no _start of type () -> ().

MissingMemory

The module exports no linear memory named memory.

StartSectionForbidden

The module carries a WebAssembly start section.

Guest code that runs at instantiation, before any request and outside the _start the shim calls. If it traps, every instantiation fails and the plugin can never answer; and running it at load to find out would mean executing an unaudited artifact’s code just to inspect it.

SegmentOutOfBounds

An active data segment does not fit the module’s own initial memory.

Copied in during instantiation, which is per request — so a segment past the end compiles clean and then fails every instantiation the artifact is ever given.

Fields

what: &'static str

Which store the segment writes into, for the message.

end: u64

One past the segment’s furthest write.

capacity: u64

What the module starts that store with.

MemoryTooLarge

The module’s initial linear memory is already over the manifest’s ceiling, so no request could ever instantiate it.

Fields

found: u64

The module’s initial memory, in bytes.

max: usize

The manifest’s ceiling.

Engine(String)

The engine could not be configured.

Trait Implementations

impl Clone for SandboxLoadError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SandboxLoadError

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

Formats the value using the given formatter.

impl Display for SandboxLoadError

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

Formats the value using the given formatter.

impl Eq for SandboxLoadError

impl Error for SandboxLoadError

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<SandboxLoadError> for SandboxPluginError

fn from(err: SandboxLoadError) -> Self

Converts to this type from the input type.

impl PartialEq for SandboxLoadError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SandboxLoadError