Enum WorkspaceRootError 

pub enum WorkspaceRootError {
    Unresolvable {
        reason: String,
    },
    NotAbsolute {
        path: String,
    },
    NotUnicode {
        path: String,
    },
    ShapeChanging {
        path: String,
        character: &'static str,
    },
    PlaceholderMisplaced {
        placement: &'static str,
    },
    NotSpawnable {
        path: String,
    },
    CreationFailed {
        path: String,
        error: String,
    },
}

Why the workspace root could not be resolved or spliced into a declared command.

Every variant is terminal at dispatch time: the root is a property of the server’s configuration and filesystem, so retrying the dispatch cannot change it.

Variants

Unresolvable

The aion home itself could not be resolved, so there is no root to derive.

Fields

reason: String

The home resolution’s own diagnosis.

NotAbsolute

The resolved root is not an absolute path.

A relative root resolves against the server’s current directory, so the same recorded history would name a different location after a restart from elsewhere.

Fields

path: String

The offending path, rendered for the refusal.

NotUnicode

The resolved root is not valid UTF-8, so it has no faithful spelling inside a declared command string.

Fields

path: String

The offending path, rendered lossily for the refusal.

ShapeChanging

The resolved root contains a character that would change how the declared command parses after splicing.

Fields

path: String

The offending path, rendered for the refusal.

character: &'static str

Which shape-changing character was found, named for the refusal.

PlaceholderMisplaced

A placeholder occurrence in the declared command is not a whole, unquoted argv word, so the spliced root would become a fragment of some larger word instead of the path the server resolved.

Fields

placement: &'static str

Where the offending occurrence sits, named for the refusal.

NotSpawnable

The resolved root contains a NUL byte, so no process can be launched in a path spliced with it.

The command-splicing path refuses NUL under WorkspaceRootError::ShapeChanging alongside the characters that would reshape a parse. A harness SETTING is never parsed, so NUL is the only one of that set which still bites — and it bites for its own reason, one layer lower: execve takes NUL-terminated strings, so a path carrying one cannot be handed to the kernel at all.

Fields

path: String

The offending path, rendered for the refusal.

CreationFailed

The root directory does not exist and could not be created.

Fields

path: String

The directory that could not be created.

error: String

The io error’s own diagnosis.

Trait Implementations

impl Clone for WorkspaceRootError

fn clone(&self) -> WorkspaceRootError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkspaceRootError

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

Formats the value using the given formatter.

impl Display for WorkspaceRootError

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

Formats the value using the given formatter.

impl Eq for WorkspaceRootError

impl Error for WorkspaceRootError

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 PartialEq for WorkspaceRootError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WorkspaceRootError