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.
There are some papers (;login: October 2013, USENIX ATC '13) and a presentation (ICCRG IETF87) describing packetdrill.
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
For installing the required packages run:
sudo apt-get install make git libsctp-dev bison flex python3 libssl-dev
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
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.
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.
The status of continous integration testing is available from Buildbot.