Architecture Decision Records
This directory contains Architecture Decision Records (ADRs) for Tachyon. Each ADR documents a significant design choice, the context that motivated it, and its consequences.
New ADRs use the template at the bottom of this file. Once accepted, an ADR is never deleted, superseded decisions are marked Superseded and linked to the replacement.
Index
ADR Title Status Date ADR-001 memfd_create vs shm_open Accepted 2026-03-30 ADR-002 SPSC strict vs MPSC Accepted 2026-03-30 ADR-003 Futex vs eventfd for consumer sleep Accepted 2026-03-30 ADR-004 TACHYON_MSG_ALIGNMENT = 64 Accepted 2026-03-30 ADR-005 SCM_RIGHTS vs named shared memory Accepted 2026-03-30 ADR-006 No-serialization contract Accepted 2026-03-30
Statuses
Accepted : in effect, implemented in the codebase.
: in effect, implemented in the codebase. Superseded : replaced by a later ADR; kept for history.
: replaced by a later ADR; kept for history. Deprecated : no longer recommended; will be removed in a future major version.
: no longer recommended; will be removed in a future major version. Proposed: under discussion, not yet merged.
... continue reading