Tcpreplay

Tcpreplay ist eine Sammlung von unter [GPLv3] lizenzierten Werkzeugen für UNIX (und Windows unter [Cygwin]) zum Bearbeiten und erneuten Abspielen von Netzwerkverkehr, der zuvor mit Tools wie [tcpdump] und [Wireshark] aufgezeichnet wurde. Es klassifiziert den Verkehr als Client- oder Server-Verkehr, schreibt Layer-2/3/4-Header um und spielt ihn über Switches, Router, Firewalls, NIDS und IPS zurück ins Netzwerk – von einem Rinnsal bis hin zur vollen Leitungskapazität. Tcpreplay unterstützt sowohl Single- als auch Dual-NIC- Modi, um sowohl sniffende als auch Inline-Geräte zu testen.

Tcpreplay wird von zahlreichen Firewall-, IDS-, IPS-, NetFlow- und anderen Netzwerk-Anbietern, Unternehmen, Universitäten, Laboren und Open-Source- Projekten eingesetzt. Wenn Ihre Organisation Tcpreplay verwendet, lassen Sie uns bitte wissen, wer Sie sind und wofür Sie es nutzen, damit wir weiterhin die Funktionen priorisieren können, die wichtig sind.

Seit 4.0 zielt Tcpreplay außerdem gezielt auf das Testen von [IP Flow][flow]/[NetFlow]- Appliances ab: präzises Timing bei hohen Raten und Ergebnisberichte, Flows-Per-Second-(fps)-Statistiken und Flow-Expiry-Analyse zur Abstimmung der Timeout-Einstellungen eines Flow-Produkts – bis zu Hunderttausende Flows/Sek., abhängig von den Flow-Größen in der pcap-Datei.

📖 Die vollständige Dokumentation finden Sie unter https://tcpreplay.appneta.com – ein Leitfaden für den Einstieg, eine Seite pro Tool, How-to-Rezepte, die Konzepte hinter der Suite, die Manpages und die FAQ. Dieses README ist der schnelle Überblick; die Website ist die Referenz.

• Die Suite
• Was ist neu in 4.6
• Installation einer Version
• Aus dem Quellcode bauen
  • Autotools
  • CMake
  • Performance: netmap, AF_XDP, io_uring
  • Abspielen auf Raw-IP-(L3)-Schnittstellen
  • libtcpreplay-C-Bibliothek
  • Ausführen der Testsuite
• Hilfe erhalten
• Mitwirken
• Lizenz
• Autoren

Die Suite

Netzwerk-Wiedergabe:

• tcpreplay / tcpreplay-edit – spielt pcap-Dateien mit beliebiger Geschwindigkeit ins Netzwerk ab, optional mit Bearbeitung der Pakete während des Abspielens (tcpreplay-edit) oder Randomisierung der IP-Adressen (tcpreplay)
• tcpliveplay – spielt eine aufgezeichnete TCP-Sitzung in einem Live-Netzwerk so ab, dass ein entfernter Server tatsächlich antwortet (beigesteuert von Yazan Siam, gesponsert von [Cisco], zum Testen des vollständigen Netzwerk-Stacks bis hinauf in die Anwendung – normales tcpreplay bleibt üblicherweise auf Layer 2)

Pcap-Datei-Editoren und Werkzeuge:

• tcpprep – Multi-Pass-pcap-Vorprozessor, der Pakete als Client oder Server klassifiziert und eine Cache-Datei schreibt, die von tcpreplay/tcprewrite verwendet wird
• tcprewrite – schreibt TCP/IP- und Layer-2-Paketheader in einer pcap-Datei um
• tcpbridge – überbrückt zwei Netzwerksegmente unter Verwendung der Umschreib-Logik von tcprewrite
• tcpcapinfo – Raw-pcap-Datei-Decoder und Debugger

Neu in 4.6

• CMake ist jetzt das primäre, empfohlene Build-System (autotools wird weiterhin für Release-Tarballs verwendet)
• io_uring und AF_XDP Fast-Path-Paketinjektion, neben der bestehenden netmap-Unterstützung — beide benötigen weniger Einrichtung als netmap und keine gepatchten Treiber
• libtcpreplay, eine statische C-Bibliothek zum Einbetten der Replay-Engine direkt in Ihr eigenes Programm
• Automatische Unterstützung für das Replay auf Raw-IP-(L3-)Schnittstellen wie WireGuard und tun-Geräte

Siehe das CHANGELOG für die vollständige Release-Historie.

Installieren einer Version

Laden Sie das neueste Release-Tarball herunter (auch gespiegelt auf SourceForge), dann:

tar xf tcpreplay-*.tar.xz && cd tcpreplay-*
./configure && make && sudo make install

Ein Release-Tarball enthält bereits vorab generierte CLI-Parser und Manpages, daher wird nichts außer einem C-Compiler und libpcap benötigt — siehe Building from source unten nur, wenn du von einem Git-Checkout aus arbeitest oder CMake-, netmap-, AF_XDP- oder io_uring-Unterstützung möchtest.

Detailliertere plattformspezifische Anweisungen findest du in der Datei INSTALL, die im Tarball enthalten ist (gleicher Inhalt wie docs/INSTALL hier).

Building From Source

Das Bauen aus einem Git-Checkout erfordert python3 und asciidoctor (je nach Build-System), um die CLI-Optionsparser und Manpages aus den *_opts.def-Dateien zu generieren — dies ersetzte GNU AutoGen für diesen Zweck in 4.6 (AutoGen ist EOL; diese nicht). AutoGen selbst wird nur noch für einen internen Header (src/tcpedit/tcpedit_stub.h) benötigt — siehe scripts/autoopts/README.md. Nichts davon ist beim Bauen eines Release-Tarballs erforderlich, da dieser diese bereits generiert enthält.

Autotools

./autogen.sh   # only needed once, from a git checkout
./configure
make
sudo make install

CMake (empfohlen)

Ab Version 4.6 kann die Suite auch mit CMake (3.16+) gebaut werden — der empfohlene und primäre Weg, Tcpreplay zu kompilieren. Autotools wird weiterhin bereitgestellt und für Release-Tarballs verwendet, wird aber letztendlich eingestellt, sodass neue Skripte/Paketierungen auf CMake abzielen sollten.

cmake -B build
cmake --build build
sudo cmake --install build

Jedes ./configure-Flag hat ein CMake-Äquivalent — siehe die Tabelle am Anfang von CMakeLists.txt. Einige Beispiele:

# debug build with support for the -d option
cmake -B build -DENABLE_DEBUG=ON

# AddressSanitizer or ThreadSanitizer build
cmake -B build -DENABLE_ASAN=ON
cmake -B build -DENABLE_TSAN=ON