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.
This commit is contained in:
Loki 2026-11-15 23:50:52 +01:00
parent b64c329125
commit a8a3057719
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
104 changed files with 2155 additions and 1030 deletions

View file

@ -1,3 +1,5 @@
//! Command-line client for the Rampart manager API.
#![allow(clippy::print_stdout, clippy::print_stderr)]
use clap::{Parser, Subcommand};

View file

@ -1,3 +1,5 @@
//! Rampart manager daemon: HTTP API in front of the redis state store.
use axum::{
Router,
http::HeaderValue,
@ -18,8 +20,8 @@ async fn main() -> anyhow::Result<()> {
.with_env_filter(EnvFilter::from_default_env().add_directive("rampart=info".parse()?))
.init();
// Manager живёт исключительно на redis-хранилище: без фичи стартовать
// нечего — fail-fast вместо полумёртвого API (features additive, TODO SOLID D).
// The manager lives exclusively on the redis store: without the feature there
// is nothing to start, so fail fast instead of serving a half-dead API.
if !cfg!(feature = "store-redis") {
anyhow::bail!("rampart-manager requires a redis state store: built without store-redis feature");
}
@ -61,8 +63,8 @@ async fn main() -> anyhow::Result<()> {
.route("/api/v1/health", get(api::inventory::health::health_check))
.route("/api/v1/auth/login", post(api::auth::login));
// Redis-зависимые маршруты существуют только вместе с фичей; сам manager
// без неё bail'ит выше, поэтому 501-заглушки были бы недостижимым кодом.
// Redis-backed routes only exist together with the feature; the manager bails
// out above without it, so 501 stubs here would be unreachable code.
let protected = Router::new();
#[cfg(feature = "store-redis")]
let protected = protected

View file

@ -1,4 +1,4 @@
//! `rampart-tui` — интерактивный терминальный дашборд live-метрик Rampart.
//! `rampart-tui` is an interactive terminal dashboard for live Rampart metrics.
use std::sync::Arc;
use std::time::Duration;
@ -21,7 +21,7 @@ struct Cli {
/// URL Prometheus metrics endpoint
#[arg(long, default_value = "http://127.0.0.1:9090/metrics")]
url: String,
/// Период опроса, секунды
/// Scrape interval in seconds
#[arg(long, default_value_t = 1)]
refresh_secs: u64,
}

View file

@ -1,11 +1,13 @@
//! Edge daemon entry point; all work is delegated to [`rampart::app::run`].
use rampart::app::{self, RunExit};
#[tokio::main]
async fn main() -> anyhow::Result<()> {
match app::run().await? {
// Штатное завершение listener: управление возвращается tokio-рантайму.
// Clean listener shutdown: control returns to the tokio runtime.
RunExit::Ok => Ok(()),
// Drain-таймаут: бинарь — единственное место, где допустим process::exit.
// Drain timeout: the binary is the only place where process::exit is allowed.
exit => std::process::exit(exit.code()),
}
}