Skip to content

NetEm

Jump to bottom
Jiri Prochazka edited this page May 21, 2015 · 3 revisions

WORK IN PROGRESS

This page is introduction to the new NetEm implementation. It contains a list of supported NetEm parameters, descriptions and examples of usage.

NetEm parameters are configured on each individual interface. You can configure them via XML recipe. Currently, LNST supports these parameters:

  • Packet delay
  • Packet loss
  • Packet corruption
  • Packet duplication
  • Packet reordering

You can set any combination of these parameters, but only 1 instance of each parameter per interface is allowed. For example, you can't set delay twice on one interface. Following sections are more detailed descriptions of each NetEm parameter, with basic usage example.

Packet delay

Adds the chosen delay to the packets outgoing to chosen network interface. The optional parameters allows to introduce a delay variation and a correlation. Delay and jitter values are expressed in ms while correlation is percentage.

Supported options:

option name format mandatory other
time ms yes
jitter ms no
correlation percent no jitter must be entered
distribution uniform | normal | pareto no jitter must be entered

Example

<eth id="testiface" label="testnet">
    <netem>
        <delay>
            <options>
                    <option name="time" value="10ms" />
                    <option name="jitter" value="1ms" />
                    <option name="correlation" value="50%" />
                    <option name="distribution" value="normal" />
            </options>
        </delay>
    </netem>
    <addresses>
        <address>192.168.101.10/24</address>
    </addresses>
</eth>

Packet loss

Adds an independent loss probability to the packets outgoing from the chosen network interface. It is also possible to add a correlation, but this option is now deprecated due to the noticed bad behavior.

Supported options:

option name format mandatory other
percent percent yes
correlation percent no percent must be entered

Example

<eth id="testiface" label="testnet">
    <netem>
        <loss>
            <options>
                    <option name="percent" value="10%" />
                    <option name="correlation" value="50%" />
            </options>
        </loss>
    </netem>
    <addresses>
        <address>192.168.101.10/24</address>
    </addresses>
</eth>

Packet corruption

Allows the emulation of random noise introducing an error in a random position for a chosen percent of packets. It is also possible to add a correlation through the proper parameter.

Supported options:

option name format mandatory other
percent percent yes
correlation percent no percent must be entered

Example

<eth id="testiface" label="testnet">
    <netem>
        <corrupt>
            <options>
                    <option name="percent" value="10%" />
                    <option name="correlation" value="50%" />
            </options>
        </corrupt>
    </netem>
    <addresses>
        <address>192.168.101.10/24</address>
    </addresses>
</eth>

Packet duplication

Using this option the chosen percent of packets is duplicated before queuing them. It is also possible to add a correlation through the proper parameter.

Supported options:

option name format mandatory other
percent percent yes
correlation percent no percent must be entered

Example

<eth id="testiface" label="testnet">
    <netem>
        <duplication>
            <options>
                    <option name="percent" value="10%" />
                    <option name="correlation" value="50%" />
            </options>
        </duplication>
    </netem>
    <addresses>
        <address>192.168.101.10/24</address>
    </addresses>
</eth>

Packet reordering

To use reordering, a delay option must be specified. There are two ways to use this option (assuming 'delay 10ms' in the options list).

percent=10%, correlation=50%, gap_distance=10 - in this example, the first 9 (gap_distance - 1) packets are delayed by 10ms and subsequent packets are sent immediately with a probability of 0.10 (with correlation of 50%) or delayed with a probability of 0.90. After a packet is reordered, the process restarts i.e. the next 9 packets are delayed and subsequent packets are sent immediately or delayed based on reordering probability. To cause a repeatable pattern where every 10th packet is reordered reliably, a reorder probability of 100% can be used.

percent 10%,correlation=50% - in this second example 10% of packets are sent immediately (with correlation of 50%) while the others are delayed by 10ms

Supported options:

option name format mandatory other
percent percent yes
correlation percent no percent must be entered
gap_distance number no

Example

<eth id="testiface" label="testnet">
    <netem>
        <reorder>
            <options>
                    <option name="percent" value="10%" />
                    <option name="gap_distance" value="10" />
                    <option name="correlation" value="50%" />
            </options>
        </reorder>
    </netem>
    <addresses>
        <address>192.168.101.10/24</address>
    </addresses>
</eth>

All the examples stated above are available in recipes/examples/ folder

Parameter description has been taken from NetEm man pages.

Clone this wiki locally