Enum HelperError 

pub enum HelperError {
    Validation(String),
    ForeignSymlink {
        path: String,
        current: String,
    },
    NotASymlink {
        path: String,
    },
    CliTargetIsSymlink {
        target: String,
    },
    CliTargetMissing {
        target: String,
    },
    CliTargetNotFile {
        target: String,
    },
    CliTargetEscaped {
        target: String,
        resolved: String,
    },
    ForeignManagedFile {
        path: String,
    },
    Io {
        op: String,
        path: String,
        detail: String,
    },
    Other(String),
    DockerSocketOccupied {
        path: String,
    },
    RouteConflict {
        subnet: String,
    },
}

Error returned by privileged helper RPCs.

Variants

Validation(String)

Input failed parse/validate at the RPC boundary.

ForeignSymlink

Destination is a symlink pointing outside ArcBox ownership.

Fields

path: String

current: String

NotASymlink

Destination exists but is not a symlink (e.g. real docker.sock).

Fields

path: String

CliTargetIsSymlink

CLI link target path is itself a symlink (escape risk).

Fields

target: String

CliTargetMissing

CLI link target path does not exist on disk.

Fields

target: String

CliTargetNotFile

CLI link target exists but is not a regular file.

Fields

target: String

CliTargetEscaped

Canonicalized CLI target left the ArcBox xbin tree.

Fields

target: String

resolved: String

ForeignManagedFile

File exists without the ArcBox management marker (DNS resolver, etc.).

Fields

path: String

Io

Filesystem / OS operation failed.

Fields

op: String

path: String

detail: String

Other(String)

Catch-all for subsystem errors (routes, etc.) without a tighter variant.

Prefer a dedicated variant when a call site needs structured matching.

DockerSocketOccupied

/var/run/docker.sock (or sandboxed equivalent) is a real file/socket, typically held by Docker Desktop — not a replaceable symlink.

Kept separate from Self::NotASymlink so path stays a pure path and UX copy is not stuffed into structured fields.

Fields

path: String

RouteConflict

An exact route already exists and was left untouched.

Fields

subnet: String

Implementations

impl HelperError

pub fn validation(msg: impl Into<String>) -> Self

pub fn other(msg: impl Into<String>) -> Self

pub fn io(op: &str, path: impl AsRef<Path>, err: impl Display) -> Self

pub fn foreign_symlink( path: impl AsRef<Path>, current: impl AsRef<Path>, ) -> Self

pub fn not_a_symlink(path: impl AsRef<Path>) -> Self

pub fn foreign_managed(path: impl AsRef<Path>) -> Self

pub fn docker_socket_occupied(path: impl AsRef<Path>) -> Self

impl HelperError

Stable machine-readable code for metrics / Desktop branching.

pub fn code(&self) -> &'static str

Trait Implementations

impl Clone for HelperError

fn clone(&self) -> HelperError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HelperError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HelperError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for HelperError

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

Formats the value using the given formatter.

impl Eq for HelperError

impl Error for HelperError

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<HelperError> for ClientError

fn from(source: HelperError) -> Self

Converts to this type from the input type.

impl PartialEq for HelperError

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for HelperError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HelperError