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.
This commit is contained in:
Loki 2026-11-15 23:44:07 +01:00
parent 295ab81fb4
commit 918e561a61
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
104 changed files with 2129 additions and 1021 deletions

View file

@ -1,3 +1,5 @@
//! `blacklist` subcommands: manage the manager blacklist over its HTTP API.
use serde::Deserialize;
use serde::Serialize;

View file

@ -1,3 +1,6 @@
//! `config` subcommand: prints configuration usage; lookups and updates are not
//! implemented yet.
pub async fn run(key: Option<String>, value: Option<String>) -> anyhow::Result<()> {
match (key, value) {
(Some(_), Some(_)) => {

View file

@ -1,7 +1,9 @@
//! `doctor` subcommand: environment, manager API and XDP diagnostics.
use crate::xdp::{EnvironmentReport, FilesystemProbe, SystemProbe};
/// Ищет интерфейс с маршрутом по умолчанию в /proc/net/route
/// (destination == 00000000). Работает без root.
/// Finds the interface that owns the default route in `/proc/net/route`
/// (destination `00000000`). Works without root.
fn default_route_interface(probe: &impl SystemProbe) -> Option<String> {
let routes = probe.read_file("/proc/net/route").ok()?;
routes.lines().skip(1).find_map(|line| {
@ -10,7 +12,7 @@ fn default_route_interface(probe: &impl SystemProbe) -> Option<String> {
})
}
/// Подсекция network/XDP: что видно окружению без root.
/// Network/XDP section: what the environment exposes without root.
fn print_network_section(all_ok: &mut bool) {
println!("\nNetwork / XDP");
println!("-------------");
@ -57,6 +59,7 @@ fn print_network_section(all_ok: &mut bool) {
}
}
/// Runs every diagnostic and prints the report.
pub async fn run() -> anyhow::Result<()> {
println!("Rampart Diagnostics");
println!("=====================\n");

View file

@ -1,3 +1,5 @@
//! Subcommand implementations for the Rampart CLI.
pub mod blacklist;
pub mod config;
pub mod doctor;

View file

@ -1,3 +1,9 @@
//! `drain` subcommand: gracefully drain a node.
/// Drains `node` gracefully.
///
/// # Errors
/// Always fails: draining is not implemented yet.
pub async fn run(node: &str) -> anyhow::Result<()> {
anyhow::bail!("graceful drain is not implemented for node {node}")
}

View file

@ -1,7 +1,17 @@
//! `emergency` subcommand: switch the edge policy into or out of emergency mode.
/// Switches emergency mode on.
///
/// # Errors
/// Always fails: emergency mode is not implemented yet.
pub async fn enable() -> anyhow::Result<()> {
anyhow::bail!("emergency mode is not implemented; change the edge policy and restart Rampart")
}
/// Switches emergency mode off.
///
/// # Errors
/// Always fails: emergency mode is not implemented yet.
pub async fn disable() -> anyhow::Result<()> {
anyhow::bail!("emergency mode is not implemented; change the edge policy and restart Rampart")
}

View file

@ -1,4 +1,4 @@
//! CLI-команды управления edge-узлами: статус, drain, аварийный режим.
//! Edge node management commands: status, drain and emergency mode.
pub mod drain;
pub mod emergency;
pub mod status;

View file

@ -1,3 +1,5 @@
//! `status` subcommand: print the manager health summary.
pub async fn run() -> anyhow::Result<()> {
println!("Rampart Status");
println!("================\n");

View file

@ -1,3 +1,3 @@
//! CLI-команды для bin/rampart-cli.
//! CLI commands used by `bin/rampart-cli`.
#[allow(clippy::print_stdout, clippy::print_stderr)]
pub mod commands;