guard/tests/protocol_registry.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

41 lines
1.2 KiB
Rust

//! Protocol registry tests: empty registries fail fast, registered handlers
//! resolve by name.
use std::future::Future;
use std::pin::Pin;
use rampart::protocol::{HandshakeResult, ProtocolHandler, ProtocolRegistry, Upstream};
use tokio::net::TcpStream;
struct NoopHandler;
impl ProtocolHandler for NoopHandler {
fn name(&self) -> &'static str {
"noop"
}
fn handshake<'a>(
&'a self,
_stream: &'a mut TcpStream,
) -> Pin<Box<dyn Future<Output = anyhow::Result<HandshakeResult>> + Send + 'a>> {
Box::pin(async { Ok(HandshakeResult::new(Upstream::new("127.0.0.1:9000"))) })
}
}
#[tokio::test]
async fn empty_registry_reports_missing_protocols() {
let registry = ProtocolRegistry::new();
assert!(registry.is_empty());
let err = registry.primary().err().expect("empty registry must fail fast");
assert!(err.to_string().contains("no protocol plugins compiled"));
}
#[tokio::test]
async fn registered_handler_resolves_by_name() {
let mut registry = ProtocolRegistry::new();
registry.register(Box::new(NoopHandler));
assert_eq!(registry.names(), vec!["noop"]);
let handler = registry.primary().expect("registered handler must resolve");
assert_eq!(handler.name(), "noop");
}