monitor.rs reached 257 lines after the trusted-network suppression (limit is
250). BanPolicy, enforce_tracker_verdicts, ban_xdp_verdicts and prefix_len move
to src/engine/subnet/enforce.rs; the monitor keeps the task, source selection
and verdict logging, re-exporting enforce_tracker_verdicts so existing paths
stay valid.
Also documents the new tests/edge_e2e.rs scenarios in docs/testing.md.
- PROXY v2 header parsing is now the pure, total function
`parse_v2_header(buf, limit) -> (SocketAddr, consumed)`; the async reader
only reads bytes and delegates. This makes the parser reachable from tests
and fuzz targets and keeps every index bounds-checked.
- tests/proxy_v2_parser.rs: valid v4/v6 headers, bad signature, non-PROXY
command, TLVs, every truncated prefix, oversized header, unsupported
family, short address block, and a deterministic sweep over family/length.
- fuzz/: cargo-fuzz targets `http_head` (scan_head + evaluate) and `proxy_v2`
with invariants (no panic, no out-of-buffer consumption, family matches the
header). Seeds for the HTTP head keep coverage useful; `make fuzz` runs
60 s per target. Both targets ran clean (7M and 3M executions).
- docs/testing.md documents the fuzz workflow; .gitignore covers the
generated corpus/artifacts.
BPF program (the first two made the filter wrong on real hardware):
- Compute the TCP payload length from ip->tot_len (IPv4) / payload_len
(IPv6) instead of data_end. Ethernet padding on a real NIC added 6 bogus
payload bytes, broke expected_seq and dropped every connection after the
fourth segment. scripts/xdp_pkt_test.sh reproduces it on synthetic frames
and fails against the old code.
- Read map values (conn->fails, sent_at) before bpf_map_delete_elem; the LRU
element is freed by the delete.
- Parse up to two VLAN/QinQ tags before L3; fragments are checked against the
blacklist and passed instead of bypassing all filtering; first fragments are
no longer dropped.
- Unknown non-SYN flows PASS: the program is a stateless filter fed by the
conntrack state machine, not a firewall, so spoofed SYNs cannot evict
established flows into a drop and replies to the daemon's own outbound TCP
keep working.
- Reset conn->fails on in-order segments, honour SYN payload (TFO), fix the
IPv6 SYN-ACK address swap, count every DROP path, drop SYN with IP options.
- Expired prefix bans are no longer deleted with the wrong LPM key; userspace
reaps them with the exact key.
Loader:
- Remember the effective attach flags (native vs generic) and use them for
detach/query, verifying the interface is clean afterwards. The old code
always detached the native slot, leaving a generic program attached after
shutdown.
- DetachGuard rolls back the attach if anything after it fails.
- ban_cidr validates the prefix length and masks host bits.
- Whitelist maps (v4 and the new v6 LPM trie) are populated from the config at
startup and fail fast on error.
- Stats read all 13 counters, and a test asserts every map's key/value size
against the Rust encodings.
Tests: xdp_pkt_test (padding, VLAN/QinQ, fragments), xdp_loader (attach flags,
rollback, detach), xdp_ban_keys, xdp_whitelist_keys, xdp_services, live
xdp_attach_smoke (ignored, needs root).
XDP behaviour:
- udp_rate_limit6 (LRU, full 128-bit source key) plus throttle_hit6, so
udp_policy = "rate-limit" applies to native IPv6 as well.
- scripts/xdp_ipv6_smoke.sh: phase 4 patches .rodata before load and
verifies policy=2 on a real kernel (3 pass / 3 rate-limited).
Loader (XDP could never load before this):
- .rodata is one struct rampart_config with frozen offsets enforced by
_Static_assert; XdpGlobals is #[repr(C)] and the image is built with
offset_of!. Before, a 96-byte image was written into a 76-byte map at
offsets clang had reordered, so load() failed with EINVAL.
- patch_rodata fails loudly when the map size and image size diverge.
- build.rs tracks xdp/core and xdp/hooks, not just universal_filter.c.
- build_ringbuf looked for "events_map"; the map is "events_ringbuf".
- tests/xdp_object_maps.rs checks map names and .rodata size without root.
Docs and style:
- Code comments are English, JavaDoc/Rustdoc style, without emoji or
banners (new project rule, TODO §0.8).
- README rewritten bilingual: Russian first, English below, nav buttons,
compact TOC and copy-paste quick start.
- docs/README.md: documentation index and maintenance rules;
configuration.md documents the whole [xdp] section and IPv4/IPv6
coverage; testing.md covers the real-kernel smoke; stale links removed.