Enum GcRootsError 

#[non_exhaustive]
pub enum GcRootsError {
    Refs(RefError),
    Stash(StashError),
    ConflictState(ConflictStateError),
    Rebase(RebaseError),
    Recovery(RecoveryError),
    Index(IndexError),
    Store(StoreError),
    BadHash(FromHexError),
    Io(Error),
    Truncated,
    RefTooDeep(String),
    SymlinkedStore(String),
    Worktrees(DiscoverError),
}

Errors from collecting the retention root set. Every underlying source error is wrapped so the collector can fail closed.

#[non_exhaustive]: new root sources (like the staging index, added in 0.2.0) come with new variants; downstream matches must keep a wildcard arm so those additions stay minor-version changes.

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.

Refs(RefError)

Stash(StashError)

ConflictState(ConflictStateError)

Rebase(RebaseError)

Recovery(RecoveryError)

Index(IndexError)

Store(StoreError)

BadHash(FromHexError)

Io(Error)

Truncated

The reachable-object walk hit super::graph::MAX_REACHABLE before completing. The live set is incomplete, so a caller must abort rather than treat beyond-cap objects as prunable.

RefTooDeep(String)

A ref directory nested deeper than MAX_REF_WALK_DEPTH.

SymlinkedStore(String)

.mkit or .mkit/objects is a symlink. A deletion-capable gc refuses, since pruning would follow the link and unlink files outside the repo.

Worktrees(DiscoverError)

The linked-worktree registry could not be enumerated. Root collection must union EVERY tree’s per-tree state (#493 Phase 3); a partial view would let a sibling’s staged work be pruned.

Trait Implementations

impl Debug for GcRootsError

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

Formats the value using the given formatter.

impl Display for GcRootsError

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

Formats the value using the given formatter.

impl Error for GcRootsError

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<ConflictStateError> for GcRootsError

fn from(source: ConflictStateError) -> Self

Converts to this type from the input type.

impl From<DiscoverError> for GcRootsError

fn from(source: DiscoverError) -> Self

Converts to this type from the input type.

impl From<Error> for GcRootsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromHexError> for GcRootsError

fn from(source: FromHexError) -> Self

Converts to this type from the input type.

impl From<IndexError> for GcRootsError

fn from(source: IndexError) -> Self

Converts to this type from the input type.

impl From<RebaseError> for GcRootsError

fn from(source: RebaseError) -> Self

Converts to this type from the input type.

impl From<RecoveryError> for GcRootsError

fn from(source: RecoveryError) -> Self

Converts to this type from the input type.

impl From<RefError> for GcRootsError

fn from(source: RefError) -> Self

Converts to this type from the input type.

impl From<StashError> for GcRootsError

fn from(source: StashError) -> Self

Converts to this type from the input type.

impl From<StoreError> for GcRootsError

fn from(source: StoreError) -> Self

Converts to this type from the input type.