- Split TODO into a thin status index plus docs/roadmap/ with one file per task (v0.4 reliability, v0.5 product, v0.6 research, icebox). - Add docs/architecture.md (current processes, packet/data path, layers, storage, metrics) and docs/development.md (rules, gates, DoD). - Add CHANGELOG.md reconstructed from history; move round details out of TODO. - Align docs with the code: config defaults and missing [detect]/ [protocol.http] sections, XDP metric names, ClickHouse table and TTL, Redis RDB restore, multiarch clang include, CLI binary name. - Add scripts/check_docs_links.sh and run it in CI. - release profile: thin LTO + one codegen unit. Binary 12.3 MB -> 9.7 MB, http parser bench 314 ns -> 278 ns; panic=abort stays off for catch_unwind in the Redis subscriber. - Drop the unused JWT role claim; fix 'rampart doctor' hints in the CLI.
37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
# v0.6 — io_uring runtime
|
||
|
||
| | |
|
||
|---|---|
|
||
| Milestone | v0.6 |
|
||
| Status | idea |
|
||
| Priority | P3 |
|
||
| Depends on | бенчмарк relay-пути |
|
||
|
||
## Цель
|
||
|
||
Опциональный io_uring-транспорт для relay: меньше syscall и копий на горячем
|
||
пути пересылки.
|
||
|
||
## Зачем
|
||
|
||
Фича `io-uring` и зависимость `tokio-splice` объявлены, но не используются. На
|
||
relay-пути доминируют `read`/`write` и копии; `splice`/io_uring могут снизить CPU
|
||
на высоких pps.
|
||
|
||
## Non-goals
|
||
|
||
- Замена tokio целиком: только транспорт relay-соединений.
|
||
- Требование io_uring для работы edge: feature опционален, дефолт — текущий путь.
|
||
|
||
## Approach
|
||
|
||
1. Замерить текущий relay: `perf`/`samply` на нагрузочном стенде, найти долю
|
||
syscall.
|
||
2. Прототип `RelayTransport` на `tokio-splice`, сравнить на 1/10/100k соединений.
|
||
3. Оставить фичу только если выигрыш воспроизводим и код не разрастается.
|
||
|
||
## Критерии приёмки
|
||
|
||
- [ ] Замеры до/после с методологией в `docs/research/benchmark.md`.
|
||
- [ ] `--features io-uring` собирается и тестируется в CI.
|
||
- [ ] Поведение при недоступном io_uring — прозрачный fallback.
|