guard/tests/xdp_ban_clock.rs
loki5512344 a8a3057719
feat(xdp): IPv6 UDP rate limit, working loader; English comments and docs
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.
2026-11-15 23:50:52 +01:00

29 lines
1.1 KiB
Rust

//! Ban clock: XDP compares expiry against `bpf_ktime_get_ns()` (monotonic nanoseconds
//! since boot), so userspace must write the same clock. Regression: `SystemTime` (epoch
//! nanoseconds, about 1.7e18) used to be written, and bans never expired.
#![cfg(feature = "xdp")]
use rampart::xdp::monotonic_ns;
fn clock_monotonic_ns() -> u64 {
let mut ts = libc::timespec { tv_sec: 0, tv_nsec: 0 };
// SAFETY: `ts` is a valid, writable `timespec`, and CLOCK_MONOTONIC is always
// supported on Linux (the xdp feature only builds on Linux).
let rc = unsafe { libc::clock_gettime(libc::CLOCK_MONOTONIC, &mut ts) };
assert_eq!(rc, 0, "clock_gettime(CLOCK_MONOTONIC) failed");
let secs = u64::try_from(ts.tv_sec).expect("tv_sec fits u64");
let nanos = u64::try_from(ts.tv_nsec).expect("tv_nsec fits u64");
secs * 1_000_000_000 + nanos
}
#[test]
fn ban_clock_is_monotonic_not_wall_clock() {
let expected = clock_monotonic_ns();
let got = monotonic_ns();
let diff = got.abs_diff(expected);
assert!(
diff < 5_000_000_000,
"monotonic_ns must read CLOCK_MONOTONIC: got {got}, expected ~{expected}"
);
}