Enum StartupError 

pub enum StartupError {
    MissingData {
        blob: PathBuf,
    },
    UnreadableData {
        blob: PathBuf,
        cause: CnResult,
    },
    OverflowUnsupported {
        blob: PathBuf,
        needed: u32,
    },
    NoStateRoot,
}

Why the runtime could not reach a playable state.

Variants

MissingData

No compiled world data where the runtime expected it. The usual causes are a build that never ran and an installation missing its data folder.

Fields

blob: PathBuf

The primary blob file that was looked for.

UnreadableData

The data is present but did not load: a truncated file, a schema the binary no longer understands, or a failed read.

Fields

blob: PathBuf

The primary blob file that was read.

cause: CnResult

What the read reported.

OverflowUnsupported

The world was packaged as one self-contained blob file, but it needs overflow payload blobs, which only the directory layout can hold. Their siblings would land beside the executable, so this is refused rather than half-loaded.

Fields

blob: PathBuf

The single blob file the world was read from.

needed: u32

How many further blobs the world spans.

NoStateRoot

Nothing anchored the state tree, so there is nowhere to look for data.

Implementations

impl StartupError

pub fn from_blob_failure(blob: PathBuf, cause: CnResult) -> Self

Classify a blob-load failure, distinguishing absent data from data that is present but unusable, since only the first is the user’s to fix. blob is the primary blob’s path, passed in rather than resolved here so the classification stays a pure function of its inputs.

Trait Implementations

impl Clone for StartupError

fn clone(&self) -> StartupError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StartupError

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

Formats the value using the given formatter.

impl Eq for StartupError

impl PartialEq for StartupError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StartupError