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:
parent
295ab81fb4
commit
918e561a61
104 changed files with 2129 additions and 1021 deletions
|
|
@ -1,3 +1,5 @@
|
|||
//! `blacklist` subcommands: manage the manager blacklist over its HTTP API.
|
||||
|
||||
use serde::Deserialize;
|
||||
use serde::Serialize;
|
||||
|
||||
|
|
|
|||
|
|
@ -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(_)) => {
|
||||
|
|
|
|||
|
|
@ -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");
|
||||
|
|
|
|||
|
|
@ -1,3 +1,5 @@
|
|||
//! Subcommand implementations for the Rampart CLI.
|
||||
|
||||
pub mod blacklist;
|
||||
pub mod config;
|
||||
pub mod doctor;
|
||||
|
|
|
|||
|
|
@ -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}")
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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")
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -1,3 +1,5 @@
|
|||
//! `status` subcommand: print the manager health summary.
|
||||
|
||||
pub async fn run() -> anyhow::Result<()> {
|
||||
println!("Rampart Status");
|
||||
println!("================\n");
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue