guard/src/cli/commands/doctor.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

109 lines
2.9 KiB
Rust

//! `doctor` subcommand: environment, manager API and XDP diagnostics.
use crate::xdp::{EnvironmentReport, FilesystemProbe, SystemProbe};
/// 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| {
let fields: Vec<&str> = line.split_whitespace().collect();
(fields.len() > 7 && fields[1] == "00000000").then(|| fields[0].to_owned())
})
}
/// Network/XDP section: what the environment exposes without root.
fn print_network_section(all_ok: &mut bool) {
println!("\nNetwork / XDP");
println!("-------------");
let probe = FilesystemProbe;
let Some(interface) = default_route_interface(&probe) else {
println!("[WARN] Default route interface not found, XDP checks skipped");
return;
};
println!("Interface: {interface}");
let report = EnvironmentReport::collect(&probe, &interface);
let kernel = report
.kernel_version
.map_or_else(|| "unknown".to_owned(), |v| v.to_string());
println!("Kernel: {kernel}");
println!(
"BTF: {}",
if report.btf_available {
"available"
} else {
"missing (CO-RE disabled)"
}
);
println!(
"Privileges: {}",
if report.privileged {
"root (capabilities assumed)"
} else {
"non-root"
}
);
println!("Driver: {}", report.driver_name.as_deref().unwrap_or("unknown"));
println!("Attach mode: {}", report.attach_mode());
println!("Verdict: {}", report.verdict());
for warning in &report.warnings {
println!("[WARN] {warning}");
}
if let Err(e) = report.validate() {
println!("[FAIL] {e}");
*all_ok = false;
} else {
println!("[OK] XDP environment");
}
}
/// Runs every diagnostic and prints the report.
pub async fn run() -> anyhow::Result<()> {
println!("Rampart Diagnostics");
println!("=====================\n");
let mut all_ok = true;
let manager_url = std::env::var("RAMPART_MANAGER").unwrap_or_else(|_| "http://localhost:8080".to_string());
match reqwest::get(format!("{manager_url}/api/v1/health")).await {
Ok(resp) if resp.status().is_success() => {
println!("[OK] Manager API");
},
_ => {
println!("[FAIL] Manager API");
all_ok = false;
},
}
match reqwest::get(format!("{manager_url}/api/v1/blacklist")).await {
Ok(resp) if resp.status().is_success() => {
println!("[OK] Blacklist API");
},
_ => {
println!("[WARN] Blacklist API unavailable");
},
}
match reqwest::get(format!("{manager_url}/api/v1/servers")).await {
Ok(resp) if resp.status().is_success() => {
println!("[OK] Servers API");
},
_ => {
println!("[WARN] Servers API unavailable");
},
}
print_network_section(&mut all_ok);
println!();
if all_ok {
println!("All checks passed.");
} else {
println!("Some checks failed. Run with --verbose for details.");
}
Ok(())
}