Enum FsError 

pub enum FsError {
    Cancelled(CancellationError),
    Config(VolumeConfigError),
    LocalStream(LocalStreamError),
    LocalObjects(LocalObjectsError),
    LocalObjectsBucket(ObjectsError),
    LocalRoot(Error),
    LocalOptionsConflict,
    LocalInitializationWorker,
    ObjectCacheConfig(ObjectCacheConfigError),
    CheckoutMode(CheckoutModeError),
    UnsupportedDurability,
    NameCollision,
    FileIdentityCollision,
    NonNormalizedName,
    UnsupportedCheckout,
    LiveRequiresSerializedAuthority,
    ExclusiveWriterConflict {
        actual: Head,
    },
    ZeroLiveRetryLimit,
    LiveRetry(LiveRetryError),
    PendingLiveMutation,
    LiveConflict {
        conflicts: Vec<RebaseConflict>,
        truncated: bool,
    },
    Authority(AuthorityStoreError),
    Object(ObjectStoreError),
    Closure(ClosureError),
    Decode(CanonicalDecodeError),
    VolumeCreated(VolumeCreatedError),
    RetentionCreated(RetentionCreatedError),
    Path(PathLookupError),
    Directory(DirectoryReadError),
    FileRecord(FileRecordReadError),
    FileRead(FileRangeReadError),
    BlobBuild(BlobBuildError),
    BlobRead(BlobReadError),
    AttributeLookup(AttributeLookupError),
    AttributeList(AttributeListError),
    AttributeMutation(AttributeMutationError),
    InlineFile(InlineFileDataError),
    NotFound,
    NotDirectory,
    NotSymbolicLink,
    NotReparsePoint,
    InvalidSpecialKind,
    UnsupportedFileKind,
    InvalidDirectoryRecord,
    InvalidExportManifest,
    Transfer(GenerationTransferError),
    Dependency(DependencyError),
    Probe(AuthenticatedProbeError),
    Rebase(RebaseError<AuthenticatedProbeError>),
    Mutation(GenerationMutationError),
    DetachedMutation(RegularMutationError),
    Checkpoint(CheckpointError),
    Publication(PublicationError),
    EmptyAuthority,
    InvalidAuthorityHistory,
    VolumeMismatch,
    CreationRejected,
    WorkspaceDeleted,
    WritableCheckoutRequiresHead,
    MutationNotAllowed,
    NoPendingMutations,
    RefreshNotAllowed,
    PendingMutationsRequireRebase,
    TooManyPendingMutations,
    ExcessiveMutationCapacity,
    PendingMutationAllocationFailed,
    PreparedMergePending,
    InvalidDiff,
    DiffAllocationFailed,
    GarbageCollectionAllocationFailed,
    MergeChangeLimit,
    MergeParentNotHead,
    MergeFileTable(FileTableMutationError),
    MergeTree(TreeMutationError),
    Work(WorkError),
}

Fail-closed embedded facade errors.

Variants

Cancelled(CancellationError)

Operation was cancelled before further facade work began.

Config(VolumeConfigError)

Volume configuration is invalid.

LocalStream(LocalStreamError)

Durable local Stream initialization or recovery failed.

LocalObjects(LocalObjectsError)

Durable local Objects initialization or recovery failed.

LocalObjectsBucket(ObjectsError)

The canonical filesystem Objects bucket could not be opened.

LocalRoot(Error)

Local provider root setup failed before either canonical provider opened.

LocalOptionsConflict

A live process-local engine already owns this root with different limits.

LocalInitializationWorker

The bounded local root initialization worker could not complete.

ObjectCacheConfig(ObjectCacheConfigError)

Immutable-object accelerator bounds are invalid.

CheckoutMode(CheckoutModeError)

Checkout behavior is contradictory.

UnsupportedDurability

Requested lifecycle is not guaranteed by the selected backends.

NameCollision

A new name collides with an existing sibling under the volume’s CaseSensitivity::ProfileFolded policy once both are case-folded, even though their exact bytes differ.

FileIdentityCollision

A caller-derived identity already names different authenticated state.

NonNormalizedName

A new name is not canonical Unicode NFC, required by the volume’s UnicodePolicy::RequireNfc policy.

UnsupportedCheckout

The facade does not yet expose this checkout behavior.

LiveRequiresSerializedAuthority

Direct-live mutation requires a serialized-authority volume.

ExclusiveWriterConflict

Another writer changed the authority before exclusive ownership could be acquired.

Fields

actual: Head

Linearizable head that defeated this acquisition.

ZeroLiveRetryLimit

A direct-live operation requires a positive safe-retry bound.

LiveRetry(LiveRetryError)

Direct-live retry observations violated the canonical transition order.

PendingLiveMutation

A direct-live checkout already has an unresolved candidate operation.

LiveConflict

Live advancement would cross an exact observed or mutated region.

Fields

conflicts: Vec<RebaseConflict>

Bounded region-specific conflicts.

truncated: bool

Whether additional conflicts were omitted by the configured bound.

Authority(AuthorityStoreError)

Authority storage failed.

Object(ObjectStoreError)

Immutable object storage failed.

Closure(ClosureError)

Generation closure authentication failed.

Decode(CanonicalDecodeError)

Canonical filesystem data is malformed or unsupported.

VolumeCreated(VolumeCreatedError)

Canonical volume creation data is malformed or unsupported.

RetentionCreated(RetentionCreatedError)

Canonical generation-retention fact is invalid.

Path(PathLookupError)

Exact namespace-path resolution failed.

Directory(DirectoryReadError)

Bounded authenticated directory pagination failed.

FileRecord(FileRecordReadError)

Bounded authenticated file-record pagination failed.

FileRead(FileRangeReadError)

Composed sparse regular-file range read failed.

BlobBuild(BlobBuildError)

Bounded authenticated blob construction failed.

BlobRead(BlobReadError)

Authenticated blob-range reading failed.

AttributeLookup(AttributeLookupError)

Authenticated named-attribute lookup failed.

AttributeList(AttributeListError)

Authenticated named-attribute pagination failed.

AttributeMutation(AttributeMutationError)

Sparse named-attribute path-copy failed.

InlineFile(InlineFileDataError)

Tiny regular-file payload exceeded its canonical bound.

NotFound

Requested path is authentically absent.

NotDirectory

Requested operation requires a directory.

NotSymbolicLink

Requested operation requires a symbolic link.

NotReparsePoint

Requested operation requires an opaque Windows reparse point.

InvalidSpecialKind

Special-file creation selected a kind incompatible with its payload.

UnsupportedFileKind

The configured volume profile cannot represent this kind exactly.

InvalidDirectoryRecord

A directory binding and file-table record disagree or are missing.

InvalidExportManifest

Export manifest does not exactly match its authenticated closure.

Transfer(GenerationTransferError)

Resumable generation transfer validation or paging failed.

Dependency(DependencyError)

Checkout dependency capture failed.

Probe(AuthenticatedProbeError)

Exact authenticated dependency probing failed.

Rebase(RebaseError<AuthenticatedProbeError>)

Observation-safe rebase classification failed.

Mutation(GenerationMutationError)

One ordered generation mutation failed.

DetachedMutation(RegularMutationError)

Path-independent open-file mutation failed.

Checkpoint(CheckpointError)

Immutable checkpoint construction failed.

Publication(PublicationError)

Whole-closure generation publication failed.

EmptyAuthority

Authority exists but has no volume creation fact.

InvalidAuthorityHistory

Authority records do not contain the expected volume event.

VolumeMismatch

Authenticated data belongs to another volume.

CreationRejected

Concurrent creation/publication produced a semantic conflict.

WorkspaceDeleted

The named workspace has been terminally deleted.

WritableCheckoutRequiresHead

Writable overlays must be opened from the current authority head.

MutationNotAllowed

Mutation was requested from a checkout that cannot mutate.

NoPendingMutations

Commit was requested without a changed candidate generation.

RefreshNotAllowed

Explicit head refresh requires manual checkout consistency.

PendingMutationsRequireRebase

A dirty overlay must be safely rebased or discarded before refresh.

TooManyPendingMutations

Uncommitted operations exceed the volume’s atomic replay bound.

ExcessiveMutationCapacity

Caller-supplied mutation storage exceeds the admitted persistent bound.

PendingMutationAllocationFailed

Retaining a bounded replay log failed.

PreparedMergePending

A prepared two-parent merge must be committed or discarded before mutation/rebase.

InvalidDiff

Diff roots or persistent page structure do not match the admitted format.

DiffAllocationFailed

Bounded diff result allocation failed.

GarbageCollectionAllocationFailed

Bounded local live-set allocation failed before physical collection.

MergeChangeLimit

A three-way merge exceeded its admitted change frontier.

MergeParentNotHead

The selected second parent is not the current authority head.

MergeFileTable(FileTableMutationError)

Sparse file-table merge application failed.

MergeTree(TreeMutationError)

Sparse directory-tree merge application failed.

Work(WorkError)

Exact work overflowed or exceeded the admitted budget.

Trait Implementations

impl Debug for FsError

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

Formats the value using the given formatter.

impl Display for FsError

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

Formats the value using the given formatter.

impl Error for FsError

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<AttributeListError> for FsError

fn from(source: AttributeListError) -> Self

Converts to this type from the input type.

impl From<AttributeLookupError> for FsError

fn from(source: AttributeLookupError) -> Self

Converts to this type from the input type.

impl From<AttributeMutationError> for FsError

fn from(source: AttributeMutationError) -> Self

Converts to this type from the input type.

impl From<AuthenticatedProbeError> for FsError

fn from(source: AuthenticatedProbeError) -> Self

Converts to this type from the input type.

impl From<AuthorityStoreError> for FsError

fn from(source: AuthorityStoreError) -> Self

Converts to this type from the input type.

impl From<BlobBuildError> for FsError

fn from(source: BlobBuildError) -> Self

Converts to this type from the input type.

impl From<BlobReadError> for FsError

fn from(source: BlobReadError) -> Self

Converts to this type from the input type.

impl From<CancellationError> for FsError

fn from(source: CancellationError) -> Self

Converts to this type from the input type.

impl From<CanonicalDecodeError> for FsError

fn from(source: CanonicalDecodeError) -> Self

Converts to this type from the input type.

impl From<CheckoutModeError> for FsError

fn from(source: CheckoutModeError) -> Self

Converts to this type from the input type.

impl From<CheckpointError> for FsError

fn from(source: CheckpointError) -> Self

Converts to this type from the input type.

impl From<ClosureError> for FsError

fn from(source: ClosureError) -> Self

Converts to this type from the input type.

impl From<DependencyError> for FsError

fn from(source: DependencyError) -> Self

Converts to this type from the input type.

impl From<DirectoryReadError> for FsError

fn from(source: DirectoryReadError) -> Self

Converts to this type from the input type.

impl From<FileRangeReadError> for FsError

fn from(source: FileRangeReadError) -> Self

Converts to this type from the input type.

impl From<FileRecordReadError> for FsError

fn from(source: FileRecordReadError) -> Self

Converts to this type from the input type.

impl From<FileTableMutationError> for FsError

fn from(source: FileTableMutationError) -> Self

Converts to this type from the input type.

impl From<FsError> for WorkspaceError

fn from(error: FsError) -> Self

Converts to this type from the input type.

impl From<GenerationMutationError> for FsError

fn from(source: GenerationMutationError) -> Self

Converts to this type from the input type.

impl From<GenerationTransferError> for FsError

fn from(source: GenerationTransferError) -> Self

Converts to this type from the input type.

impl From<InlineFileDataError> for FsError

fn from(source: InlineFileDataError) -> Self

Converts to this type from the input type.

impl From<LiveRetryError> for FsError

fn from(source: LiveRetryError) -> Self

Converts to this type from the input type.

impl From<LocalObjectsError> for FsError

fn from(source: LocalObjectsError) -> Self

Converts to this type from the input type.

impl From<LocalStreamError> for FsError

fn from(source: LocalStreamError) -> Self

Converts to this type from the input type.

impl From<ObjectCacheConfigError> for FsError

fn from(source: ObjectCacheConfigError) -> Self

Converts to this type from the input type.

impl From<ObjectStoreError> for FsError

fn from(source: ObjectStoreError) -> Self

Converts to this type from the input type.

impl From<PathLookupError> for FsError

fn from(source: PathLookupError) -> Self

Converts to this type from the input type.

impl From<PublicationError> for FsError

fn from(source: PublicationError) -> Self

Converts to this type from the input type.

impl From<RebaseError<AuthenticatedProbeError>> for FsError

fn from(source: RebaseError<AuthenticatedProbeError>) -> Self

Converts to this type from the input type.

impl From<RegularMutationError> for FsError

fn from(source: RegularMutationError) -> Self

Converts to this type from the input type.

impl From<RetentionCreatedError> for FsError

fn from(source: RetentionCreatedError) -> Self

Converts to this type from the input type.

impl From<TreeMutationError> for FsError

fn from(source: TreeMutationError) -> Self

Converts to this type from the input type.

impl From<VolumeConfigError> for FsError

fn from(source: VolumeConfigError) -> Self

Converts to this type from the input type.

impl From<VolumeCreatedError> for FsError

fn from(source: VolumeCreatedError) -> Self

Converts to this type from the input type.

impl From<WorkError> for FsError

fn from(source: WorkError) -> Self

Converts to this type from the input type.