Enum HlcError 

#[non_exhaustive]
pub enum HlcError {
    Length(usize),
    NodeIdTooLarge(u64),
    PeerTooFarAhead {
        ahead_micros: i64,
        max_micros: i64,
    },
    CounterOverflow,
}

Why a hybrid logical clock operation failed.

No variant holds the input bytes that failed. A peer controls the value of the krabka.hlc header, and a message that keeps those bytes would put hostile input into the log field that shows the error. The variants carry lengths, counts, and time deltas only.

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.

Length(usize)

The header value is not exactly HLC_ENCODED_LEN bytes.

NodeIdTooLarge(u64)

The node id is wider than the 4 bytes the layout gives it.

NodeId holds a u64, and Kafka carries the same value as a 4-byte wire field. A node id above u32::MAX has no place in the layout, so the encode fails instead of a silent truncation.

PeerTooFarAhead

The peer’s wall time is further ahead of the local physical clock than the configured maximum offset, so the clock refused the stamp.

Fields

ahead_micros: i64

How far the peer’s wall time is ahead of the local physical clock.

max_micros: i64

The configured maximum offset.

CounterOverflow

The logical counter reached u32::MAX inside one microsecond.

The counter separates events that share a wall-time microsecond. It never wraps, because a wrap would put a later event before an earlier one.

Trait Implementations

impl Clone for HlcError

fn clone(&self) -> HlcError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for HlcError

impl Debug for HlcError

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

Formats the value using the given formatter.

impl Display for HlcError

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

Formats the value using the given formatter.

impl Eq for HlcError

impl Error for HlcError

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 PartialEq for HlcError

fn eq(&self, other: &HlcError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for HlcError