guard/tests/xdp_object_maps.rs
loki5512344 14dcaccdbf
fix(xdp): correct payload length, attach/detach, whitelist and ban upkeep
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).
2026-11-16 12:06:05 +01:00

90 lines
2.6 KiB
Rust

#![cfg(feature = "xdp")]
//! Contract between the loader (`src/xdp/filter/*`) and the C object: map names and the
//! `.rodata` size. Catches drift without root and without loading the program into the
//! kernel — exactly the class of bug that made XDP fail silently ("events_map not found",
//! "Invalid argument" on `.rodata`).
use libbpf_rs::ObjectBuilder;
use rampart::xdp::RODATA_SIZE;
fn open_object() -> libbpf_rs::OpenObject {
let bytes = include_bytes!(concat!(env!("OUT_DIR"), "/universal_filter.o"));
ObjectBuilder::default()
.name("rampart")
.expect("object name")
.open_memory(bytes)
.expect("open XDP object (ELF/BTF parse must not need privileges)")
}
#[test]
fn every_map_the_loader_uses_exists_in_the_object() {
let obj = open_object();
let names: Vec<String> = obj.maps().map(|m| m.name().to_string_lossy().into_owned()).collect();
// Names come from `find_map`, `build_ringbuf` and `patch_rodata`.
for expected in [
"stats_map",
"prefix_stats",
"events_ringbuf",
"blacklist_map",
"blacklist6_map",
"whitelist_map",
"whitelist6_map",
"udp_rate_limit",
"udp_rate_limit6",
] {
assert!(
names.iter().any(|n| n == expected),
"loader expects map '{expected}', object has {names:?}"
);
}
assert!(
names.iter().any(|n| n.ends_with(".rodata")),
"loader expects a '.rodata' map, object has {names:?}"
);
}
#[test]
fn rodata_map_value_size_matches_loader_image() {
let obj = open_object();
let map = obj
.maps()
.find(|m| m.name().to_string_lossy().ends_with(".rodata"))
.expect("rodata map");
assert_eq!(
map.value_size() as usize,
RODATA_SIZE,
"sizeof(struct rampart_config) in config.h must equal sizeof(XdpGlobals)"
);
}
#[test]
fn map_key_and_value_sizes_match_the_rust_encoding() {
let obj = open_object();
// (map, key size, value size) as encoded by src/xdp/filter/maps.rs and
// src/xdp/probe/stats.rs. The C structs come from xdp/core/common.h,
// xdp/core/prefix_stats.h and xdp/core/maps.h.
let expected = [
("blacklist_map", 8, 8),
("blacklist6_map", 20, 8),
("whitelist_map", 8, 1),
("whitelist6_map", 20, 1),
("prefix_stats", 24, 24),
("stats_map", 4, 8),
];
for (name, key_size, value_size) in expected {
let map = obj.maps().find(|m| m.name().to_string_lossy() == name);
assert!(map.is_some(), "map '{name}' is missing from the XDP object");
let map = map.expect("map existence asserted above");
assert_eq!(
map.key_size(),
key_size,
"map '{name}' key size drifted from the Rust encoding"
);
assert_eq!(
map.value_size(),
value_size,
"map '{name}' value size drifted from the Rust encoding"
);
}
}