Enum SyncPolicy 

pub enum SyncPolicy {
    EveryN(u32),
    OnFlushOnly,
}

WAL fsync scheduling policy.

Variants

EveryN(u32)

Flush and fsync after every N appended entries, on explicit flush, and when the writer is dropped.

EveryN(1) is durability-by-default. Values greater than 1 opt into group commit. EveryN(0) is normalized to EveryN(1) on open.

OnFlushOnly

Never fsync during append or drop; only explicit WalWriter::flush fsyncs.

This is an explicit opt-in for benchmark parity and offline paths where durability is provided elsewhere. It is not the production default.

selene-graph forces this for the committer WAL (v1.2 BRIEF 2)

When a WalWriter is owned by selene-graph’s single committer thread (via SharedGraphBuilder::with_wal / SharedGraph::from_graph_with_wal / recovery), the committer is the sole fsync caller: it appends a contiguous run of commits with fsync deferred, then issues exactly one WalWriter::flush per run as the fsync-before-publish barrier. To make that the only fsync path, selene-graph overrides WalConfig::sync_policy to OnFlushOnly before opening such a WAL, discarding any caller policy (the fsync cadence is instead set by selene_graph::CommitBatching). A WalWriter opened directly (outside selene-graph) still honors whatever policy the caller passes — the override lives in selene-graph, not here.

Implementations

impl SyncPolicy

pub const fn as_every_n(self) -> Option<u32>

Return the EveryN threshold when this policy syncs on append.

Trait Implementations

impl Clone for SyncPolicy

fn clone(&self) -> SyncPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SyncPolicy

impl Debug for SyncPolicy

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

Formats the value using the given formatter.

impl Eq for SyncPolicy

impl PartialEq for SyncPolicy

fn eq(&self, other: &SyncPolicy) -> 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 SyncPolicy