Expand description
Write-ahead logging and durability. Write-ahead logging, checked recovery, and self-tuning group commit.
Modules§
- header
- Shared-file-header encoding for append-only WAL files.
- record
- Byte-exact WAL record framing.
- replay
- Checked WAL prefix replay.
Structs§
- Completed
Group - One exact completed group retained in the bounded recent-group ring.
- Group
Size Histogram - Fixed-size logarithmic distribution of completed group record counts.
- LogSeq
- Monotonic write-ahead-log sequence number.
- Visible
Record - One record visible from in-memory state before its group reaches storage.
- WalReader
- Owned checked WAL prefix recovered from a filesystem image.
- WalRetirement
- Exact effect of one visibility-retirement request.
- WalWriter
- Single-store WAL writer using caller threads as leader and followers.
- WalWriter
Stats - Deterministic group-composition and progress snapshot.
Enums§
- Visible
Record Error - Checked access failure for a retained encoded record.
- WalRead
Error - WAL recovery failure requiring the caller to stop rather than hide corruption.
- WalRecovery
Error - A non-empty WAL cannot be resumed because replay did not reach a clean end.
- WalRetire
Error - Visibility retirement failure.
- WalWrite
Error - WAL creation, staging, or group-flush failure.
Constants§
- DEFAULT_
MAX_ GROUP_ BYTES - Default upper bound for one group append, in encoded bytes.
- DEFAULT_
MAX_ GROUP_ BYTES_ DURABLE - Default upper bound for a full-sync group append, in encoded bytes.
- GROUP_
SIZE_ HISTOGRAM_ BUCKETS - Number of fixed group-size histogram buckets.
- RECENT_
GROUP_ LIMIT - Maximum number of completed groups retained exactly for diagnostics/tests.