docs(todo): record XDP IPv6-parity plan (C + Rust + tests + non-goals)

This commit is contained in:
Loki 2026-11-15 22:51:52 +01:00
parent 18a0ffa53d
commit cacd01c657
Signed by: boba
GPG key ID: 6CDE87BC9A778D97

18
TODO.md
View file

@ -165,7 +165,23 @@ guard/
`RunExit`, единственный `process::exit` теперь в `main` бина (clippy там не срабатывает). `RunExit`, единственный `process::exit` теперь в `main` бина (clippy там не срабатывает).
- [x] Флакающий тест `pow_roundtrip::verifier_rejects_garbage_and_replay` (p≈1/16 из-за - [x] Флакающий тест `pow_roundtrip::verifier_rejects_garbage_and_replay` (p≈1/16 из-за
случайного токена) — сидирован, 50 прогонов до (3 fail) / после (0 fail). случайного токена) — сидирован, 50 прогонов до (3 fail) / после (0 fail).
- [ ] IPv6-банов в XDP-putи нет (`ban_cidr` bail'ит на v6) — IPv6-паритет (вывод №8). - [ ] IPv6-паритет XDP (вывод №8) — план:
- [ ] **C**: `struct lpm_key6 { u32 prefixlen; u8 addr[16]; }` в `common.h`;
`blacklist6_map` (LPM_TRIE, 20-байтный ключ, value `u64` expiry, 100000, NO_PREALLOC) в `maps.h`;
в `universal_filter.c` non-mapped IPv6 не возвращает PASS раньше времени: общий L4-парсинг +
порт-гейт, затем блок `if (native_v6)`: `is_blacklisted6` (lookup `prefixlen=128`,
expiry-cleanup как у v4) → DROP; UDP при `G_UDP_POLICY==1` → DROP; `detect_tcp_bypass` → DROP;
TCP → `prefix_key_from_v6` + `update_prefix_stats` (оживляет мёртвый код, замыкает
детектор подсетей на v6); иначе PASS. Ringbuf-события для v6 не шлём (ABI `src_ip` u32).
- [ ] **Rust**: `pub fn blacklist6_key(prefix_len: u8, &[u8;16]) -> [u8;20]` (prefixlen LE в 0..4,
addr network order в 4..20); `blacklist6_update`; `ban_cidr` матчит V4/V6;
`gateway.rs::xdp_ban` → `ban_cidr(ip, 32|128, dur)` для обоих семейств; `ban_ip` удаляется
(после перевода gateway вызовов нет — «мёртвый код = баг»), `noop.rs` синхронизировать.
- [ ] **Тесты**: `tests/xdp_ban_v6.rs` (layout ключа `/64` и `/128`, network order); C — clang-сборка
через `build.rs` + smoke в netns при CAP_BPF.
- Non-goals (позже): conntrack/throttle/UDP rate-limit (`policy==2`)/RST-challenge для нативного v6
(нужны 128-битные flow/throttle-ключи); whitelist6 (у `whitelist_map` нет писателя даже для v4);
ringbuf-события для v6; unban v6.
## 3. Backlog ## 3. Backlog