guard/build.rs
loki5512344 918e561a61
feat(xdp): IPv6 UDP rate limit, working loader; English JavaDoc comments
XDP behaviour:
- udp_rate_limit6 (LRU, 128-bit source key) + throttle_hit6, so
  udp_policy = "rate-limit" now 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).

XDP loader (was completely broken, never reached the verifier):
- .rodata is now one struct rampart_config with frozen offsets enforced by
  _Static_assert; XdpGlobals is #[repr(C)] and the image is built with
  offset_of!. Previously 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 the 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: verifies map names and .rodata size without root;
  the real binary was confirmed to attach in a netns.

Docs and style:
- Code comments are English, JavaDoc/Rustdoc style, without emoji or
  decorative banners (new project rule, TODO §0.8).
- README rewritten bilingual: Russian first, English below, 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 describes the real-kernel smoke; stale research links removed.
2026-11-15 23:44:07 +01:00

49 lines
1.5 KiB
Rust

use std::path::PathBuf;
use std::process::Command;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let has_xdp_feature = std::env::var("CARGO_FEATURE_XDP").is_ok();
if !has_xdp_feature {
return Ok(());
}
let manifest_dir = PathBuf::from(std::env::var("CARGO_MANIFEST_DIR")?);
let xdp_dir = manifest_dir.join("xdp");
let out_dir = PathBuf::from(std::env::var("OUT_DIR")?);
let src = xdp_dir.join("core/universal_filter.c");
let dst = out_dir.join("universal_filter.o");
println!("cargo:rerun-if-changed={}", src.display());
// config.h/common.h/etc. live in these dirs: without tracking them a header
// edit silently keeps a stale object (and a stale .rodata layout).
println!("cargo:rerun-if-changed={}", xdp_dir.join("core").display());
println!("cargo:rerun-if-changed={}", xdp_dir.join("hooks").display());
let host_triple = std::env::var("HOST").unwrap_or_default();
let arch = host_triple.split('-').next().unwrap_or(&host_triple);
let status = Command::new("clang")
.args([
"-O2",
"-g",
"-target",
"bpf",
"-mcpu=v3",
"-c",
src.to_str().ok_or("src path is not valid UTF-8")?,
"-o",
dst.to_str().ok_or("dst path is not valid UTF-8")?,
&format!("-I{}", xdp_dir.display()),
&format!("-I{}", xdp_dir.join("core").display()),
&format!("-I{}", xdp_dir.join("hooks").display()),
&format!("-I/usr/include/{}-linux-gnu", arch),
])
.status()?;
if !status.success() {
return Err("XDP C compilation failed (see clang errors above)".into());
}
println!("cargo:rerun-if-env-changed=CARGO_FEATURE_XDP");
Ok(())
}