Simulate network latency, packet loss, and low bandwidth on Mac OSX

Sometimes while testing you may want to be able to simulate network latency, or packet loss, or low bandwidth. I have done this with Linux and tc/netem as well as with Shunra on Windows, but I had never done it on Mac OSX.

It turns out that Mac OSX includes ‘dummynet’ from FreeBSD which has the capability to do this WAN simulation.

Here is a quick example:

  • Inject 250ms latency and 10% packet loss on connections between my workstation and my development web server (10.0.0.1)
  • Simulate maximum bandwidth of 1Mbps
# Create 2 pipes and assigned traffic to and from our webserver to each:
$ sudo  ipfw add pipe 1 ip from any to 10.0.0.1
$ sudo  ipfw add pipe 2 ip from 10.0.0.1 to any
 
# Configure the pipes we just created:
$ sudo  ipfw pipe 1 config delay 250ms bw 1Mbit/s plr 0.1
$ sudo  ipfw pipe 2 config delay 250ms bw 1Mbit/s plr 0.1

A quick test:

$ ping 10.0.0.1
PING 10.0.0.1 (10.0.0.1): 56 data bytes
64 bytes from 10.0.0.1: icmp_seq=0 ttl=63 time=515.939 ms
64 bytes from 10.0.0.1: icmp_seq=1 ttl=63 time=519.864 ms
64 bytes from 10.0.0.1: icmp_seq=2 ttl=63 time=521.785 ms
Request timeout for icmp_seq 3
64 bytes from 10.0.0.1: icmp_seq=4 ttl=63 time=524.461 ms

Disable:

$sudo  ipfw list |grep pipe
  01900 pipe 1 ip from any to 10.13.1.133 out
  02000 pipe 2 ip from 10.13.1.133 to any in
$ sudo  ipfw delete 01900
$ sudo  ipfw delete 02000
 
# or, flush all ipfw rules, not just our pipes
$ sudo ipfw -q flush

Notice that the round-trip on the ping is ~500ms.  That is because we applied a 250ms latency to both pipes, incoming and outgoing traffic.

Our example was very simple, but you can get quite complex since “pipes” are applied to traffic using standard ipfw firewall rules.  For example, you could specify different latency based on port, host, network, etc.

Packet loss is configured with the “plr” command.  Valid values are 0 – 1.  In our example above we used 0.1 which equals 10% packetloss.

This is a very handy way for developers on Mac’s to test their applications in a variety of network environments.  And you get it for FREE.  On Windows you need to buy a commercial tool to achieve this (at least that was true the last time I looked, in 2008.)

Posted Tuesday, August 31st, 2010 under macosx, software, testing.
  • Edwin van der Klaauw

    This command: ipfw add pipe 1 from any to 10.0.0.1
    gives this error: ipfw: unrecognised option [-1] from

    The “ip” param seems to be missing in the examples?
    This works: ipfw add pipe 1 ip from any to 10.0.0.1

    • jmiller

      Thanks for the correction. I’ll update the article

  • http://www.khokhar.net Tariq Khokhar

    That’s a useful post – I wrote something similar at:

    http://www.khokhar.net/2010/01/simulating-low-bandwidths/

    But didn’t go into this much detail. Is Shunra commercial tool? I’d be interested to know about any FOSS tools that let you do similar things.

    Cheers,

    Tariq

    • jmiller

      Yes, I believe Shunra is a commercial tool. I do not know of any FOSS tools for Windows that allow one to simulate WAN conditions. If you find any, please let me know.