Skip to main content

Crate camus

Crate camus 

Source
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§

CommitStats
Aggregate durability-group activity for one open root.
Config
Configuration used to open one storage root.
DurationStats
A count, total, and maximum for monotonic elapsed-time observations.
FailureInfo
Structured detail retained for the first failed-closed transition.
HealthWatch
A non-owning asynchronous watch of low-frequency root health transitions.
Log
A thread-safe client for one open Camus storage root.
MaintenanceStats
Successful physical maintenance activity for one open root.
OperationCounters
Saturating session counters for one logical public operation.
OperationStats
Logical-operation activity for one open root.
PendingRecord
One owned pending record returned by a stream read.
PendingSnapshot
A non-empty owned observation of pending records.
PressureStats
Reactor admission and backpressure state for one open root.
ReadLimits
Hard bounds for one waiting stream read.
ReclaimReport
Work completed by one explicit reclamation request.
Record
Opaque metadata and payload transferred into one append operation.
RecordId
A stable opaque record identity allocated by Camus.
RecoveryStats
Work performed while successfully opening and recovering the current root.
RootHealth
Current lifecycle and first failed-closed cause for one open root.
RootStats
A synchronous in-memory snapshot of root-wide operational state.
RuntimeError
Failure to submit work to a configured runtime backend.
StorageJobStats
Detailed elapsed time for finite filesystem jobs by reactor work kind.
StorageStats
Current durable and physical aggregate state for one root.
Stream
A lightweight logical-stream handle backed by one root reactor.
StreamId
A caller-selected logical stream namespace inside one storage root.
StreamStats
A synchronous in-memory snapshot of one logical stream.
WaitStats
Current waiters plus saturating session totals for one wait category.

Enums§

Capacity
Root-wide encoded storage capacity.
DurabilityOutcome
Whether an I/O error can say anything definitive about durable mutation.
Error
An error returned by a Camus operation.
ErrorKind
Stable low-cardinality classification for a Camus error.
FullPolicy
Admission behavior for a full bounded root.
OperationKind
Low-cardinality operation context for a failed-closed transition.
RootState
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.
RuntimeFuture
A boxed runtime-neutral task Future.