packetdrill
A fork of packetdrill which adds support for
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.