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.
109 lines
2.9 KiB
Rust
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(())
|
|
}
|