Module cache_peer

Module cache_peer 

Source
Expand description

2026-09-25: The cache peer: a process that lends RAM to KV and snapshot clients over one-sided RDMA. A connection gets either its own arena (RAW mode), which the client allocates in, or the shared paging arena of its (kind, blob_bytes), backed by a swap file (registry).

Owner: metrale-storage peers. Invariants:

  • A connection starts with the v2 paging header; blob_bytes == 0 selects RAW mode, any other value paging.
  • A paging client is refused unless RdmaConfig::swap_dir is set.

Structs§

CacheServerParams
2026-09-26: The peer’s half of the read-write handshake (KV paging and SSM snapshots): its QP identity plus the base address and rkey of its RW MR.
RdmaConfig
2026-09-25: The cache peer’s settings. A client asks for up to rails.len() rails, and the peer registers the arena on each.

Functions§

serve
2026-09-25: Serve on addr, one thread per connection. Accept errors are logged and skipped; only a bind error returns.