Enum LogError 

pub enum LogError {
    Io(Error),
    PartialBatch {
        segment: i64,
        file_offset: u64,
    },
    CrcMismatch {
        segment: i64,
        file_offset: u64,
        expected: u32,
        computed: u32,
    },
    OffsetTooLow {
        requested: i64,
        log_start: i64,
    },
    Records(RecordsError),
    BadSegmentName(String),
    OffsetMismatch {
        expected: i64,
        actual: i64,
    },
    Corrupt(String),
    InvalidArgument(String),
}

Errors returned by Log and Segment.

Variants

Io(Error)

An I/O operation against the filesystem failed.

PartialBatch

A partial batch was found at the tail of a .log file during recovery — the trailing bytes will be truncated to the last cleanly decoded batch.

Fields

segment: i64

Absolute base offset of the segment containing the partial batch.

file_offset: u64

Byte position within the .log file where the partial batch starts.

CrcMismatch

A batch’s stored CRC did not match the one computed over its bytes.

Fields

segment: i64

Absolute base offset of the segment.

file_offset: u64

Byte position within the .log file where the corrupt batch starts.

expected: u32

CRC value embedded in the batch header.

computed: u32

CRC value re-computed by the reader.

OffsetTooLow

A caller requested an offset below Log::log_start_offset.

Fields

requested: i64

Offset the caller asked for.

log_start: i64

Current log start.

Records(RecordsError)

Encoding/decoding of a RecordBatch failed.

BadSegmentName(String)

A segment filename couldn’t be parsed (e.g., wrong length, not all digits).

OffsetMismatch

A caller supplied an explicit offset to Log::append_at that did not match the log’s current end offset. Replication paths use this to detect divergence between leader-assigned offsets and the local log’s expected next offset.

Fields

expected: i64

The offset the log expected — i.e. its current end offset.

actual: i64

The offset the caller actually supplied.

Corrupt(String)

A log file (e.g., .txnindex) is corrupt: wrong size, bad checksum, etc.

InvalidArgument(String)

A caller supplied an invalid argument.

Trait Implementations

impl Debug for LogError

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

Formats the value using the given formatter.

impl Display for LogError

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

Formats the value using the given formatter.

impl Error for LogError

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 LogError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<RecordsError> for LogError

fn from(source: RecordsError) -> Self

Converts to this type from the input type.