Struct FaultInjector

pub struct FaultInjector<D: Device> { /* private fields */ }

A fault injector device.

A fault injector is a device that alters packets traversing through it to simulate adverse network conditions (such as random packet loss or corruption), or software or hardware limitations (such as a limited number or size of usable network buffers).

Implementations

impl<D: Device> FaultInjector<D>

pub fn new(inner: D, seed: u32) -> FaultInjector<D>

Create a fault injector device, using the given random number generator seed.

pub fn into_inner(self) -> D

Return the underlying device, consuming the fault injector.

pub fn corrupt_chance(&self) -> u8

Return the probability of corrupting a packet, in percents.

pub fn drop_chance(&self) -> u8

Return the probability of dropping a packet, in percents.

pub fn max_packet_size(&self) -> usize

Return the maximum packet size, in octets.

pub fn max_tx_rate(&self) -> u64

Return the maximum packet transmission rate, in packets per second.

pub fn max_rx_rate(&self) -> u64

Return the maximum packet reception rate, in packets per second.

pub fn bucket_interval(&self) -> Duration

Return the interval for packet rate limiting, in milliseconds.

pub fn set_corrupt_chance(&mut self, pct: u8)

Set the probability of corrupting a packet, in percents.

Panics

This function panics if the probability is not between 0% and 100%.

pub fn set_drop_chance(&mut self, pct: u8)

Set the probability of dropping a packet, in percents.

Panics

This function panics if the probability is not between 0% and 100%.

pub fn set_max_packet_size(&mut self, size: usize)

Set the maximum packet size, in octets.

pub fn set_max_tx_rate(&mut self, rate: u64)

Set the maximum packet transmission rate, in packets per interval.

pub fn set_max_rx_rate(&mut self, rate: u64)

Set the maximum packet reception rate, in packets per interval.

pub fn set_bucket_interval(&mut self, interval: Duration)

Set the interval for packet rate limiting, in milliseconds.

Trait Implementations

impl<D: Debug + Device> Debug for FaultInjector<D>

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

Formats the value using the given formatter.

impl<D: Device> Device for FaultInjector<D>

type RxToken<'a> = RxToken<'a> where Self: 'a

type TxToken<'a> = TxToken<'a, <D as Device>::TxToken<'a>> where Self: 'a

fn capabilities(&self) -> DeviceCapabilities

Get a description of device capabilities.

fn receive( &mut self, timestamp: Instant, ) -> Option<(Self::RxToken<'_>, Self::TxToken<'_>)>

Construct a token pair consisting of one receive token and one transmit token.

fn transmit(&mut self, timestamp: Instant) -> Option<Self::TxToken<'_>>

Construct a transmit token.