Tcpreplay

Tcpreplay è una suite di utilità con licenza [GPLv3] per UNIX (e Windows sotto [Cygwin]) per modificare e riprodurre traffico di rete precedentemente catturato da strumenti come [tcpdump] e [Wireshark]. Classifica il traffico come client o server, riscrive le intestazioni di Livello 2/3/4 e lo riproduce sulla rete attraverso switch, router, firewall, NIDS e IPS — a qualsiasi velocità, da un flusso minimo fino alla piena velocità del collegamento. Tcpreplay supporta sia la modalità a singola NIC che a doppia NIC, per testare sia dispositivi di sniffing che in-line.

Tcpreplay è utilizzato da numerosi fornitori di firewall, IDS, IPS, NetFlow e altre soluzioni di networking, aziende, università, laboratori e progetti open source. Se la tua organizzazione utilizza Tcpreplay, faccelo sapere: chi sei e per cosa lo usi, così possiamo continuare a dare priorità alle funzionalità che contano.

Dalla versione 4.0, Tcpreplay è anche specificamente orientato al testing di appliance [IP Flow][flow]/[NetFlow]: temporizzazione accurata della riproduzione ad alta velocità e reportistica dei risultati, statistiche Flows Per Second (fps) e analisi della scadenza dei flussi per ottimizzare le impostazioni di timeout di un prodotto flow — fino a centinaia di migliaia di flussi/sec, a seconda delle dimensioni dei flussi nel file pcap.

📖 La documentazione completa è disponibile su https://tcpreplay.appneta.com — una guida introduttiva, una pagina per ogni strumento, ricette pratiche, i concetti alla base della suite, le pagine man e le FAQ. Questo README è la panoramica rapida; il sito è il riferimento.

• La suite
• Novità nella 4.6
• Installare una release
• Compilare dai sorgenti
  • Autotools
  • CMake
  • Prestazioni: netmap, AF_XDP, io_uring
  • Riproduzione su interfacce IP raw (L3)
  • Libreria C libtcpreplay
  • Eseguire la suite di test
• Ottenere aiuto
• Contribuire
• Licenza
• Autori

La Suite

Riproduzione di rete:

• tcpreplay / tcpreplay-edit — riproduce file pcap a velocità arbitrarie sulla rete, modificando opzionalmente i pacchetti al volo (tcpreplay-edit) o randomizzando gli indirizzi IP (tcpreplay)
• tcpliveplay — riproduce una sessione TCP catturata su una rete live in modo che un server remoto risponda effettivamente (contribuito da Yazan Siam, sponsorizzato da [Cisco], per testare l'intero stack di rete fino al livello applicativo — il normale tcpreplay rimane di solito al Livello 2)

Editor e utilità per file pcap:

• tcpprep — pre-processore pcap multi-pass che classifica i pacchetti come client o server e scrive un file di cache consumato da tcpreplay/tcprewrite
• tcprewrite — riscrive le intestazioni dei pacchetti TCP/IP e di Livello 2 in un file pcap
• tcpbridge — collega due segmenti di rete usando la logica di riscrittura di tcprewrite
• tcpcapinfo — decodificatore e debugger di file pcap raw

Novità nella 4.6

• CMake è ora il sistema di build principale e consigliato (autotools è ancora utilizzato per i tarball di rilascio)
• io_uring e AF_XDP per l'iniezione di pacchetti sul fast-path, insieme al supporto netmap esistente — entrambi richiedono meno configurazione rispetto a netmap e nessun driver modificato
• libtcpreplay, una libreria C statica per incorporare il motore di replay direttamente nel proprio programma
• Supporto automatico per il replay su interfacce IP raw (L3) come WireGuard e dispositivi tun

Consultare il CHANGELOG per la cronologia completa delle release.

Installazione di una Release

Scaricare l'ultimo tarball di rilascio (disponibile anche su SourceForge), poi:

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

Un tarball di rilascio include i parser CLI e le pagine man pre-generati, quindi non serve altro oltre a un compilatore C e libpcap — vedi Compilazione dal sorgente qui sotto solo se stai lavorando da un checkout git, oppure se vuoi il supporto a CMake, netmap, AF_XDP o io_uring.

Istruzioni più dettagliate specifiche per piattaforma sono nel file INSTALL incluso nel tarball (stesso contenuto di docs/INSTALL qui).

Compilazione dal sorgente

La compilazione da un checkout git richiede python3 e asciidoctor (con entrambi i sistemi di build) per generare i parser delle opzioni CLI e le pagine man dai file *_opts.def — questo ha sostituito GNU AutoGen per tale scopo nella 4.6 (AutoGen è EOL; questi no). AutoGen stesso è ancora necessario solo per un header interno (src/tcpedit/tcpedit_stub.h) — vedi scripts/autoopts/README.md. Nulla di tutto ciò è necessario quando si compila un tarball di rilascio, che include già questi file generati.

Autotools

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

CMake (consigliato)

A partire dalla versione 4.6, la suite può essere compilata anche con CMake (3.16+) — il modo consigliato e principale per compilare Tcpreplay. Autotools è ancora fornito e utilizzato per i tarball di rilascio, ma verrà eventualmente ritirato, quindi i nuovi script/pacchetti dovrebbero puntare a CMake.

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

Ogni flag di ./configure ha un equivalente CMake — vedi la tabella all'inizio di CMakeLists.txt. Alcuni esempi:

# 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