guard/src/bin/rampart-tui.rs
loki5512344 a8a3057719
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.
2026-11-15 23:50:52 +01:00

64 lines
1.6 KiB
Rust

//! `rampart-tui` is an interactive terminal dashboard for live Rampart metrics.
use std::sync::Arc;
use std::time::Duration;
use clap::Parser;
use ratatui::Terminal;
use ratatui::backend::CrosstermBackend;
use tokio::sync::Notify;
use rampart::tui::app;
use rampart::tui::fetch::{Fetcher, HttpFetcher};
use rampart::tui::state::AppState;
#[derive(Parser)]
#[command(
name = "rampart-tui",
about = "Rampart live metrics TUI (Prometheus /metrics source)"
)]
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,
}
fn main() -> anyhow::Result<()> {
let cli = Cli::parse();
let Some(fetcher) = HttpFetcher::new(cli.url.clone()) else {
anyhow::bail!("failed to build http client");
};
let runtime = tokio::runtime::Builder::new_current_thread().enable_all().build()?;
let terminal = ratatui::try_init()?;
let result = runtime.block_on(run(
terminal,
Arc::new(fetcher) as Arc<dyn Fetcher>,
cli.url,
Duration::from_secs(cli.refresh_secs.max(1)),
));
ratatui::restore();
result
}
async fn run(
mut terminal: Terminal<CrosstermBackend<std::io::Stdout>>,
fetcher: Arc<dyn Fetcher>,
url: String,
refresh: Duration,
) -> anyhow::Result<()> {
let state = Arc::new(AppState::new(url));
let notify = Arc::new(Notify::new());
tokio::spawn(app::spawn_fetch_loop(
fetcher,
Arc::clone(&state),
refresh,
Arc::clone(&notify),
));
app::run_ui(&mut terminal, state, notify)
.await
.map_err(anyhow::Error::from)
}