Expand description
Camus is an embedded persistent buffer for opaque application records.
It provides an asynchronous append -> read -> release -> reclaim
lifecycle with an at-least-once storage handoff. Logical streams are
application-selected namespaces; they are independent of physical segment
placement and do not represent consumers or subscriptions.
Structs§
- Commit
Stats - Aggregate durability-group activity for one open root.
- Config
- Configuration used to open one storage root.
- Duration
Stats - A count, total, and maximum for monotonic elapsed-time observations.
- Failure
Info - Structured detail retained for the first failed-closed transition.
- Health
Watch - A non-owning asynchronous watch of low-frequency root health transitions.
- Log
- A thread-safe client for one open Camus storage root.
- Maintenance
Stats - Successful physical maintenance activity for one open root.
- Operation
Counters - Saturating session counters for one logical public operation.
- Operation
Stats - Logical-operation activity for one open root.
- Pending
Record - One owned pending record returned by a stream read.
- Pending
Snapshot - A non-empty owned observation of pending records.
- Pressure
Stats - Reactor admission and backpressure state for one open root.
- Read
Limits - Hard bounds for one waiting stream read.
- Reclaim
Report - Work completed by one explicit reclamation request.
- Record
- Opaque metadata and payload transferred into one append operation.
- Record
Id - A stable opaque record identity allocated by Camus.
- Recovery
Stats - Work performed while successfully opening and recovering the current root.
- Root
Health - Current lifecycle and first failed-closed cause for one open root.
- Root
Stats - A synchronous in-memory snapshot of root-wide operational state.
- Runtime
Error - Failure to submit work to a configured runtime backend.
- Storage
JobStats - Detailed elapsed time for finite filesystem jobs by reactor work kind.
- Storage
Stats - Current durable and physical aggregate state for one root.
- Stream
- A lightweight logical-stream handle backed by one root reactor.
- Stream
Id - A caller-selected logical stream namespace inside one storage root.
- Stream
Stats - A synchronous in-memory snapshot of one logical stream.
- Wait
Stats - Current waiters plus saturating session totals for one wait category.
Enums§
- Capacity
- Root-wide encoded storage capacity.
- Durability
Outcome - Whether an I/O error can say anything definitive about durable mutation.
- Error
- An error returned by a Camus operation.
- Error
Kind - Stable low-cardinality classification for a Camus error.
- Full
Policy - Admission behavior for a full bounded root.
- Operation
Kind - Low-cardinality operation context for a failed-closed transition.
- Root
State - Lifecycle state of one open root.
Constants§
- DEFAULT_
COMMAND_ QUEUE_ CAPACITY - Default number of admitted commands buffered for one root.
- DEFAULT_
MAX_ COMMIT_ BYTES - Default maximum encoded bytes in one commit group.
- DEFAULT_
MAX_ COMMIT_ UNITS - Default maximum commit units sharing one durability barrier.
- DEFAULT_
MAX_ EPOCH_ BYTES - Default hard encoded size of one append epoch.
- DEFAULT_
MAX_ RELEASE_ RECORDS - Default hard number of IDs in one release call.
- DEFAULT_
SEGMENT_ BYTES - Default hard final size of one physical data segment.
Traits§
- Runtime
- Minimal executor capabilities required by one Camus root reactor.
Type Aliases§
- Result
- The result type returned by Camus operations.
- Runtime
Future - A boxed runtime-neutral task Future.