Enum DurableCheckpointError 

#[non_exhaustive]
pub enum DurableCheckpointError {
    AtomicReplaceUnsupported {
        path: PathBuf,
    },
    Encode(PersistenceError),
    TaskJoin(JoinError),
    GenerationExhausted,
    WriteSuperseded {
        generation: u64,
        latest: u64,
    },
    Read {
        path: PathBuf,
        source: Error,
    },
    InvalidFormat {
        path: PathBuf,
    },
    ChecksumMismatch {
        path: PathBuf,
    },
    CheckpointTooLarge {
        path: PathBuf,
        bytes: u64,
        max_bytes: u64,
    },
    CheckpointSizeOverflow {
        path: PathBuf,
    },
    CreateDir {
        path: PathBuf,
        source: Error,
    },
    Write {
        path: PathBuf,
        source: Error,
    },
    TemporaryPathExhausted {
        path: PathBuf,
        attempts: usize,
    },
    Rename {
        from: PathBuf,
        to: PathBuf,
        source: Error,
    },
    SyncDirectory {
        path: PathBuf,
        source: Error,
    },
    IdentityMismatch {
        expected: DurableCheckpointIdentity,
        actual: DurableCheckpointIdentity,
    },
    CacheChainMismatch {
        cache_chain_id: u64,
        checkpoint_chain_id: u64,
    },
}

Durable checkpoint persistence or compatibility failure.

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.

AtomicReplaceUnsupported

This platform cannot provide the crate’s required atomic replacement.

Fields

path: PathBuf

Destination checkpoint path.

Encode(PersistenceError)

The checkpoint payload could not be serialized.

TaskJoin(JoinError)

The blocking checkpoint writer task was cancelled or panicked.

GenerationExhausted

The in-process writer generation counter cannot advance safely.

WriteSuperseded

A newer write was requested before this writer could install its snapshot.

Fields

generation: u64

Generation assigned to this write.

latest: u64

Latest generation requested from this store.

Read

The checkpoint file could not be read.

Fields

path: PathBuf

Checkpoint path.

source: Error

Filesystem failure.

InvalidFormat

The file does not carry the supported magic, version, or payload.

Fields

path: PathBuf

Checkpoint path.

ChecksumMismatch

The checkpoint checksum does not match its encoded contents.

Fields

path: PathBuf

Checkpoint path.

CheckpointTooLarge

The checkpoint exceeds this store’s configured resource bound.

Fields

path: PathBuf

Checkpoint path.

bytes: u64

Encoded file size observed or produced.

max_bytes: u64

Maximum encoded size accepted by the store.

CheckpointSizeOverflow

Encoded checkpoint size overflowed the supported u64 accounting.

Fields

path: PathBuf

Checkpoint path.

CreateDir

The checkpoint directory could not be created.

Fields

path: PathBuf

Directory path.

source: Error

Filesystem failure.

Write

The temporary checkpoint file could not be written or synced.

Fields

path: PathBuf

Temporary checkpoint path.

source: Error

Filesystem failure.

TemporaryPathExhausted

Every bounded unique temporary-file candidate already existed.

Fields

path: PathBuf

Destination checkpoint path.

attempts: usize

Number of collision retries attempted.

Rename

The synced temporary file could not be atomically installed.

Fields

from: PathBuf

Temporary checkpoint path.

to: PathBuf

Destination checkpoint path.

source: Error

Filesystem failure.

SyncDirectory

The checkpoint rename committed but its containing directory could not be synced. The file may exist, but the caller must not acknowledge the delivery because crash durability was not established.

Fields

path: PathBuf

Directory path.

source: Error

Filesystem failure.

IdentityMismatch

A checkpoint was opened under a different subscriber or handler schema.

Fields

expected: DurableCheckpointIdentity

Requested consumer identity.

actual: DurableCheckpointIdentity

Stored consumer identity.

CacheChainMismatch

The configured cache and checkpoint identity target different chains.

Fields

cache_chain_id: u64

Current cache chain id.

checkpoint_chain_id: u64

Stored/requested checkpoint chain id.

Trait Implementations

impl Debug for DurableCheckpointError

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

Formats the value using the given formatter.

impl Display for DurableCheckpointError

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

Formats the value using the given formatter.

impl Error for DurableCheckpointError

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<DurableCheckpointError> for ReactiveCheckpointRestoreError

fn from(source: DurableCheckpointError) -> Self

Converts to this type from the input type.

impl From<PersistenceError> for DurableCheckpointError

fn from(source: PersistenceError) -> Self

Converts to this type from the input type.