Struct NetworkEmulation 

pub struct NetworkEmulation {
    pub delay_ms: u32,
    pub jitter_ms: u32,
    pub loss_percent: f64,
    pub loss_correlation: f64,
}

Network emulation settings using Linux tc netem.

These settings simulate realistic network conditions like latency and packet loss. Useful for testing congestion control behavior under real-world conditions.

Example

use freenet_test_network::docker::NetworkEmulation;

// Simulate intercontinental latency (100-150ms) with 1% packet loss
let emulation = NetworkEmulation {
    delay_ms: 125,
    jitter_ms: 25,
    loss_percent: 1.0,
    ..Default::default()
};

Fields

delay_ms: u32

Base latency in milliseconds

jitter_ms: u32

Latency jitter (+/- this value) in milliseconds

loss_percent: f64

Packet loss percentage (0.0 - 100.0)

loss_correlation: f64

Correlation percentage for loss (consecutive losses are correlated)

Implementations

impl NetworkEmulation

pub fn lan() -> Self

Create settings for LAN-like conditions (minimal latency)

pub fn regional() -> Self

Create settings for regional network (US coast-to-coast)

pub fn intercontinental() -> Self

Create settings for intercontinental network (US to Europe)

pub fn high_latency() -> Self

Create settings for high-latency network (US to Asia-Pacific) This is the scenario that triggered the BBR timeout storm bug.

pub fn challenging() -> Self

Create settings for challenging network conditions

Trait Implementations

impl Clone for NetworkEmulation

fn clone(&self) -> NetworkEmulation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NetworkEmulation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NetworkEmulation

fn default() -> Self

Returns the “default value” for a type.