How bloomdb-labs/bloom_lfs works
Bloom_lfs is an append-oriented durable storage engine. Its main workflow accepts application writes through the store API, stages and batches them in a buffer ring, and dispatches aligned writes to a durable backing file; reads use the dispatcher, while completion tracking exposes contiguous durable offsets. The graph also preserves the documented write modes and flush/sync capabilities. Source evidence is concentrated in src/lib.rs; other subsystem details rely on the README’s architecture and feature descriptions.
Main entry points: lib.rs Log-Structured Store
Components 14
Store API
- Store Configuration
src/lib.rs - Log-Structured Store
src/lib.rs - Write Reservation
src/lib.rs - Offset Read
src/lib.rs - Flush and Sync
src/lib.rs
Write Coordination
- Write Modes
src/lib.rs - Buffer Ring
src/lib.rs
I/O and Storage
- QuikIO Dispatcher
src/lib.rs - io_uring
- Direct I/O
- Backing File
src/lib.rs
Durability
- Write Completion
src/lib.rs - Stable Offsets
src/lib.rs
Other components
- Application
Connections 17
- Application → Store Configuration: configures
README.md - Application → Log-Structured Store: writes and reads
README.md - Store Configuration → Log-Structured Store: opens
src/lib.rs - Log-Structured Store → Write Reservation: reserves space
src/lib.rs - Log-Structured Store → Buffer Ring: stages writes
src/lib.rs - Write Modes → Buffer Ring: selects ordering
README.md - Buffer Ring → QuikIO Dispatcher: submits flushes
src/lib.rs - QuikIO Dispatcher → io_uring: dispatches writes
README.md - io_uring → Direct I/O: issues aligned I/O
README.md - Direct I/O → Backing File: writes batches
README.md - Log-Structured Store → Offset Read: reads by offset
README.md - Offset Read → QuikIO Dispatcher: reads data
src/lib.rs - Flush and Sync → Buffer Ring: flushes buffers
README.md - Flush and Sync → QuikIO Dispatcher: syncs storage
src/lib.rs - QuikIO Dispatcher → Write Completion: reports completions
src/lib.rs - Write Completion → Stable Offsets: advances contiguous offsets
src/lib.rs - Application → Stable Offsets: checks durability
README.md