Struct UdpUnderlayConfig 

pub struct UdpUnderlayConfig { /* private fields */ }

UDP underlay configuration.

Construct with UdpUnderlayConfig::default and customize with the consuming with_* methods, then pass to ScionStackBuilder::with_udp_underlay_config.

Implementations

impl UdpUnderlayConfig

pub fn with_outbound_ips(self, outbound_ips: Vec<IpAddr>) -> Self

Sets the outbound IP addresses to use for the UDP underlay.

If not set, the UDP underlay will use the local IP that can reach the endhost API. This is a convenience wrapper around Self::with_outbound_ip_resolver for a fixed set of addresses.

pub fn with_outbound_ip_resolver( self, resolver: impl OutboundIpResolver + 'static, ) -> Self

Sets a custom outbound IP resolver for the UDP underlay.

Use this method when outbound IP resolution does not depend on the selected endhost API URL. If the resolver needs the endhost API URL, use Self::with_outbound_ip_resolver_factory instead.

By default, TargetAddrOutboundIpResolver is used, which resolves the endhost API hostname via OS DNS.

pub fn with_outbound_ip_resolver_factory<F, R>(self, factory: F) -> Self

where F: FnOnce(Url) -> R + Send + 'static, R: OutboundIpResolver + 'static,

Sets a factory that builds the UDP underlay’s outbound IP resolver from the selected endhost API URL.

The winning endhost API URL is only known once the stack connects during ScionStackBuilder::build, so resolvers that depend on it must be constructed via this factory. The factory is invoked once with the selected URL.

Use this when the hostname is only resolvable through a custom DNS override that is invisible to the OS resolver, or to provide a fully custom URL-aware resolution strategy. If the resolver does not need the URL, use Self::with_outbound_ip_resolver instead.

pub fn with_udp_next_hop_resolver_fetch_interval( self, fetch_interval: Duration, ) -> Self

Sets the interval at which the UDP next hop resolver fetches the next hops from the endhost API.

Trait Implementations

impl Default for UdpUnderlayConfig

fn default() -> Self

Returns the “default value” for a type.