Enum DurabilityMode 

pub enum DurabilityMode {
    Flushed,
    Synced,
    Grouped {
        every: u32,
    },
}

How far a single-record write is pushed before it returns.

This is a contract, not a tuning knob: it decides what a successful mutation means. Nothing here makes a claim about surviving power loss — see DurabilityMode::guarantee for what each mode does and does not establish.

Variants

Flushed

Write and flush to the operating system. The default.

The bytes leave the process before the call returns, so a committed write survives the process dying. They are not forced to the device.

Synced

Write, flush, and fsync before returning.

Issues a stable-storage barrier per mutation. Whether that barrier actually reaches the platter depends on the filesystem, the mount options and the drive’s write cache — none of which this database can observe, so this mode buys a barrier, not a proof.

Grouped

Flush every write, and fsync once every every writes.

Amortises the barrier. The cost is an explicit window: up to every - 1 acknowledged writes may not yet have been through one.

Fields

every: u32

Implementations

impl DurabilityMode

pub fn guarantee(&self) -> &'static str

What a successful mutation guarantees under this mode, stated so that a caller can read the contract rather than infer it from an API name.

pub fn unbarriered_window(&self) -> Option<u32>

How many acknowledged writes may not yet have been through a barrier.

None where no barrier is issued at all.

Trait Implementations

impl Clone for DurabilityMode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DurabilityMode

impl Debug for DurabilityMode

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

Formats the value using the given formatter.

impl Default for DurabilityMode

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DurabilityMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DurabilityMode

impl PartialEq for DurabilityMode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DurabilityMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DurabilityMode