-
Notifications
You must be signed in to change notification settings - Fork 0
Blueprint Audit
Dmdv edited this page Jul 11, 2026
·
1 revision
Source:
docs/blueprint/AUDIT.mdin the main repository.
Status legend:
| Status | Meaning |
|---|---|
| SHIPPED | Code + test and/or runnable example in this repo |
| OPTIONAL | Built when dependency is installed (auto-detect) |
| DOC | Documented with operator guidance; limited runtime API |
| PARTIAL | Touched via demo or third-party lib only |
| GAP | Not implemented here (reference / future module) |
Industry map: 07-industry-libraries.md ·
Tutorials: ../tutorials/.
| Item | Status | Evidence |
|---|---|---|
CPU isolation (isolcpus, nohz_full) |
DOC | 01-hardware-os.md |
| Thread pinning | SHIPPED / macOS QoS DOC | ll/affinity.hpp |
| hwloc topology | OPTIONAL | [industry][hwloc] |
| libnuma bind / alloc_onnode | SHIPPED API + Linux OPTIONAL link |
ll/linux_numa.hpp, [roadmap][numa], Linux CI |
| C-states / P-states / governor | DOC | 01-hardware-os.md |
| Hugepages / TLB | DOC |
01-hardware-os.md, kernel-bypass lab |
| Item | Status | Evidence |
|---|---|---|
| IPollModeRx contract + stub | SHIPPED |
ll/kernel_bypass.hpp, [industry][bypass]
|
| DPDK | OPTIONAL detect + lab runbook |
STACK_WITH_DPDK; stub when absent |
| OpenOnload / EF_VI | OPTIONAL detect + lab runbook | STACK_WITH_ONLOAD |
| liburing | SHIPPED API + Linux OPTIONAL |
ll/linux_uring.hpp, Linux CI |
| Real Logic SBE codegen | SHIPPED |
schemas/sbe-*.xml, generated/sbe/, ll/sbe_codec.hpp
|
| SBE-style POD teaching aid | SHIPPED | ll/sbe_style.hpp |
| FlatBuffers | OPTIONAL | schemas/tick.fbs |
| struct_pack | SHIPPED | yalantinglibs + ll/struct_pack_tick.hpp
|
| Asio / Beast / gRPC / simdjson | SHIPPED | library mesh |
| Item | Status | Evidence |
|---|---|---|
| Arena / object pool | SHIPPED | ll/arena.hpp |
| std::pmr | SHIPPED | ll/pmr_arena.hpp |
| mimalloc off-path | OPTIONAL | industry tests |
| jemalloc off-path | OPTIONAL | ll/jemalloc_util.hpp |
| False sharing / cache lines | SHIPPED |
ll/cache_line.hpp, SPSC |
| Item | Status | Evidence |
|---|---|---|
ll::SpscQueue |
SHIPPED | tests + examples |
| Boost.Lockfree / moodycamel | SHIPPED / OPTIONAL | industry suite |
| folly::ProducerConsumerQueue | OPTIONAL | auto if Folly present; make folly
|
| Memory order tutorial | SHIPPED | examples/memory_order |
| Item | Status | Evidence |
|---|---|---|
| C++26 project | SHIPPED | CMake |
| CRTP / likely | SHIPPED | ll/branch.hpp |
| LTO/PGO guidance | DOC | 05-compiler.md |
| Item | Status | Evidence |
|---|---|---|
| TSC / steady_ns | SHIPPED | ll/tsc_clock.hpp |
| Portable HDR histogram | SHIPPED | ll/HdrLatencyHistogram |
| HdrHistogram_c | SHIPPED (FetchContent) |
ll/hdr_c.hpp, [roadmap][hdr_c]
|
| Google Benchmark | OPTIONAL | bench_queues |
| Rank | Layer | Why |
|---|---|---|
| 1 | §4 + §3 | Queues, arenas, pmr |
| 2 | Library mesh + industry optional | Asio… + hwloc/FB/mimalloc/moodycamel |
| 3 | §6 Telemetry | Portable HDR + HdrHistogram_c |
| 4 | §2 Serde + §1 NUMA | SBE codegen, numa/uring APIs |
| 5 | §2 Bypass drivers | Contract + lab; DPDK/Onload not linked |
| # | Item | Status |
|---|---|---|
| 1 | Real Logic SBE codegen | DONE — schema, generator script, committed headers, tests, tutorial |
| 2 | Linux numa + uring + CI |
DONE — APIs, tests, linux-roadmap CI job |
| 3 | HdrHistogram_c wrapper |
DONE — FetchContent + ll::HdrHistogramC
|
| 4 | DPDK / Onload lab | DONE as contract+stub+runbook (driver GAP by design) |
This audit is the checklist for PRs: new work should move a row from DOC/GAP → SHIPPED/OPTIONAL with tests.
Wiki mirror of repository docs. Edit docs/ in the main repo, then python3 scripts/publish_wiki.py.