Enum JournalError 

#[non_exhaustive]
pub enum JournalError {
    Io {
        message: String,
        path: Option<PathBuf>,
    },
    CorruptEntry {
        sequence: u64,
        expected_crc: u32,
        actual_crc: u32,
    },
    DeserializationError {
        sequence: u64,
        message: String,
    },
    SerializationError {
        message: String,
    },
    EntryTooLarge {
        entry_bytes: usize,
        segment_size: usize,
    },
    InvalidDirectory {
        path: PathBuf,
    },
    MutexPoisoned,
    SequenceNotFound {
        sequence: u64,
    },
    InvalidEntryHeader {
        offset: usize,
        message: String,
    },
}

Errors that can occur within the journal subsystem.

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.

Io

An I/O error occurred while reading or writing journal files.

Fields

message: String

The underlying I/O error message.

path: Option<PathBuf>

The file path involved, if known.

CorruptEntry

A journal entry failed CRC32 integrity verification.

Fields

sequence: u64

The sequence number of the corrupt entry.

expected_crc: u32

The expected CRC32 checksum.

actual_crc: u32

The actual CRC32 checksum computed from the entry bytes.

DeserializationError

The journal entry payload could not be deserialized.

Fields

sequence: u64

The sequence number of the entry that failed to deserialize.

message: String

The underlying deserialization error message.

SerializationError

The journal entry payload could not be serialized.

Fields

message: String

The underlying serialization error message.

EntryTooLarge

A segment file is too small to hold the entry being appended.

Fields

entry_bytes: usize

The size of the serialized entry in bytes.

segment_size: usize

The maximum segment size in bytes.

InvalidDirectory

The journal directory does not exist or is not accessible.

Fields

path: PathBuf

The path that was expected to be a valid directory.

MutexPoisoned

An internal mutex was poisoned (another thread panicked while holding the lock).

SequenceNotFound

The requested sequence number was not found in the journal.

Fields

sequence: u64

The sequence number that was requested.

InvalidEntryHeader

The journal entry has an invalid header (truncated or malformed).

Fields

offset: usize

Byte offset within the segment where the error occurred.

message: String

Description of the header problem.

Trait Implementations

impl Debug for JournalError

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

Formats the value using the given formatter.

impl Display for JournalError

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

Formats the value using the given formatter.

impl Error for JournalError

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<Error> for JournalError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<JournalError> for ReplayError

fn from(source: JournalError) -> Self

Converts to this type from the input type.