ts_l3/lib.rs
1// Copyright (c) 2026 LightSeek Foundation
2//
3// Permission is hereby granted, free of charge, to any person obtaining a copy
4// of this software and associated documentation files (the "Software"), to deal
5// in the Software without restriction, including without limitation the rights
6// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7// copies of the Software, and to permit persons to whom the Software is
8// furnished to do so, subject to the following conditions:
9//
10// The above copyright notice and this permission notice shall be included in
11// all copies or substantial portions of the Software.
12//
13// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
19// SOFTWARE.
20
21//! The L3 storage tier's Host-only executor, owned by the engine host
22//! (`docs/design/async-l3-cache.md`).
23//!
24//! The C++ scheduler plans each request's storage operations and the
25//! control plane agrees on their outcomes across the replica
26//! (`ts-control`'s `l3`); this crate runs the operations on this rank:
27//! bounded queues, worker threads, the backend's health, and the stores —
28//! the Mooncake store client, and an in-memory one for tests. Workers read
29//! and write the Host pool the data plane allocated, by address; no thread
30//! here takes the GIL, calls the scheduler or touches the GPU.
31
32pub mod executor;
33pub mod keys;
34pub mod layout;
35pub mod mooncake;
36pub mod settings;
37pub mod store;
38
39pub use executor::{
40 monotonic_clock, Clock, Executor, ExecutorConfig, ExecutorError, Namespace, Operation,
41 StorageCompletion, StorageKey, StoragePoll, StoragePressure,
42};
43pub use layout::{GroupLayout, HostLayout, LayoutError, Range};
44pub use settings::{Settings, StoreSettings};
45pub use store::{process_memory_store, HostBuffer, IoResult, MemoryStore, Store, StoreError};