guard/tests/xdp_ban_v6.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

38 lines
1.3 KiB
Rust

//! Layout of the `blacklist6_map` key (LPM trie): the prefix length as a little-endian
//! u32 in bytes 0..4 plus the 16-byte address in network order (bytes 4..20).
//! No kernel needed: this exercises the pure key encoding function.
#![cfg(feature = "xdp")]
use rampart::xdp::blacklist6_key;
const ADDR_2001_DB8_1: [u8; 16] = [0x20, 0x01, 0x0d, 0xb8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1];
#[test]
fn key_layout_for_128_prefix() {
let key = blacklist6_key(128, &ADDR_2001_DB8_1);
assert_eq!(key.len(), 20);
assert_eq!(key[0], 128, "prefixlen goes first");
assert_eq!(key[1..4], [0, 0, 0], "u32 LE padding stays zero");
assert_eq!(key[4..20], ADDR_2001_DB8_1, "address kept in network order");
}
#[test]
fn key_layout_for_64_prefix() {
let key = blacklist6_key(64, &ADDR_2001_DB8_1);
assert_eq!(key[0], 64);
assert_eq!(key[1..4], [0, 0, 0]);
assert_eq!(key[4..20], ADDR_2001_DB8_1);
}
#[test]
fn leading_zero_address_is_not_confused_with_prefix_len() {
// ::1 has fifteen zero bytes before the final one: the key must not consume any of them.
let key = blacklist6_key(128, &[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1]);
assert_eq!(key[0], 128, "prefixlen is not overwritten by the address");
assert_eq!(key[1..4], [0, 0, 0]);
assert_eq!(key[4..19], [0u8; 15]);
assert_eq!(key[19], 1);
}