stefangense / packetdrill

packetdrill with UDPLite and SCTP support and bug fixes for FreeBSD

packetdrill

A fork of packetdrill which adds support for

• UDPLite as specified in RFC 3828
• SCTP as specified in RFC 4960, RFC 4820, RFC 6458, and RFC 7053

and generic bugfixes, espcially several fixes required to get packetdrill working on FreeBSD. MacOS (El Capitan and higher) is also supported.

Information

There are some papers (;login: October 2013, USENIX ATC '13) and a presentation (ICCRG IETF87) describing packetdrill.

Installation

MacOS (El Capitan and higer)

Download the sources, compile them and install the binary:

git clone https://github.com/nplab/packetdrill.git
cd packetdrill/gtests/net/packetdrill/
./configure
make
sudo cp packetdrill /usr/bin

Linux (Ubuntu)

For installing the required packages run:

sudo apt-get install make git libsctp-dev bison flex python

Then download the sources, compile them and install the binary:

git clone https://github.com/nplab/packetdrill.git
cd packetdrill/gtests/net/packetdrill/
./configure
make
sudo cp packetdrill /usr/bin

FreeBSD

For installing the required packages run:

sudo pkg install git bison python

Then download the sources, compile them and install the binary:

git clone https://github.com/nplab/packetdrill.git
cd packetdrill/gtests/net/packetdrill/
./configure
make
sudo cp packetdrill /usr/local/bin

To be able to run packetdrill in combination with sudo run

sudo sysctl -w vm.old_mlock=1

or add

vm.old_mlock=1

to /etc/sysctl.conf and reboot.

Windows (Windows 11)

packetdrill has no Windows support, but the packetdrill remote mode works inside the Windows Subsystem for Linux version 1 (WSL1). Note, WSL1 maps Linux system calls to Windows system calls, whereas WSL2 is basically a Linux VM. To test the Windows implementation, WSL1 is required.

Follow the Linux instructions for installation.

The packetdrill remote mode requires two hosts, the wire_client (i.e., the system under test, Windows) and the wire_server (i.e., the system that captures the packets, e.g. Ubuntu).

To start the wire_server with interface enp0s5f0 connecting to wire_client.

sudo packetdrill --wire_server --wire_server_dev=enp0s5f0

To start the wire_client on Windows, first start a cmd as Administrator and run wsl within it. Inside the wsl, run

sudo packetdrill --wire_client --wire_client_dev=eth1 --wire_server_ip=10.1.2.3 <script_path>

where eth1 is wsl's interface to the wire_server and 10.1.2.3 is the real IP address of wire_server's enp0s5f0 interface.

Continous Integration

The status of continous integration testing is available from Buildbot.