appneta/tcpreplayकैप्चर किए गए नेटवर्क ट्रैफ़िक को मनमानी गति पर संपादित करें और पुनः चलाएँ — *NIX और Windows के लिए pcap टूल्स का एक सूट।
<p align="center">
<img src="https://raw.githubusercontent.com/appneta/tcpreplay/master/docs/guide/assets/images/logo.svg" alt="" width="96" height="96">
</p>
<h1 align="center">Tcpreplay</h1>
[](https://github.com/appneta/tcpreplay/actions/workflows/github-actions-ci.yml)
[](https://scan.coverity.com/projects/12017)
[](https://github.com/appneta/tcpreplay/actions/workflows/codeql.yml)
[](https://github.com/appneta/tcpreplay/actions/workflows/c-linter.yml)
[](https://tcpreplay.appneta.com)
[](https://github.com/appneta/tcpreplay/releases)
Tcpreplay, UNIX (और [Cygwin] के अंतर्गत Windows) के लिए [GPLv3] लाइसेंस प्राप्त उपयोगिताओं का एक सूट है, जो [tcpdump] और [Wireshark] जैसे टूल द्वारा पहले कैप्चर किए गए नेटवर्क ट्रैफ़िक को संपादित करने और रीप्ले करने के लिए है। यह ट्रैफ़िक को क्लाइंट या सर्वर के रूप में वर्गीकृत करता है, Layer 2/3/4 हेडर को फिर से लिखता है, और इसे स्विच, राउटर, फ़ायरवॉल, NIDS और IPS के माध्यम से नेटवर्क पर वापस रीप्ले करता है — किसी भी गति से, रिसाव से लेकर पूर्ण वायर रेट तक। Tcpreplay स्निफ़िंग और इन-लाइन दोनों डिवाइस के परीक्षण के लिए सिंगल और डुअल NIC दोनों मोड का समर्थन करता है।
Tcpreplay का उपयोग कई फ़ायरवॉल, IDS, IPS, NetFlow और अन्य नेटवर्किंग विक्रेताओं, उद्यमों, विश्वविद्यालयों, प्रयोगशालाओं और ओपन सोर्स प्रोजेक्ट्स द्वारा किया जाता है। यदि आपका संगठन Tcpreplay का उपयोग करता है, तो कृपया हमें बताएं कि आप कौन हैं और आप इसका उपयोग किस लिए करते हैं, ताकि हम उन सुविधाओं को प्राथमिकता देना जारी रख सकें जो मायने रखती हैं।
4.0 के बाद से, Tcpreplay विशेष रूप से [IP Flow][flow]/[NetFlow] उपकरण परीक्षण को भी लक्षित करता है: सटीक उच्च-दर प्लेबैक टाइमिंग और परिणाम रिपोर्टिंग, Flows Per Second (fps) आंकड़े, और फ़्लो उत्पाद की टाइमआउट सेटिंग्स को ट्यून करने के लिए फ़्लो-एक्सपायरी विश्लेषण — pcap फ़ाइल में फ़्लो आकार के आधार पर, प्रति सेकंड सैकड़ों हज़ार फ़्लो तक।
📖 **पूर्ण दस्तावेज़ीकरण <https://tcpreplay.appneta.com> पर उपलब्ध है** — एक गेटिंग-स्टार्टेड गाइड, प्रत्येक टूल के लिए एक पेज, हाउ-टू रेसिपी, सूट के पीछे की अवधारणाएं, मैन पेज, और FAQ। यह README एक त्वरित परिचय है; साइट संदर्भ है।
- [सूट](#the-suite)
- [4.6 में नया क्या है](#whats-new-in-46)
- [रिलीज़ इंस्टॉल करना](#installing-a-release)
- [स्रोत से बिल्ड करना](#building-from-source)
- [Autotools](#autotools)
- [CMake](#cmake-recommended)
- [प्रदर्शन: netmap, AF\_XDP, io\_uring](#performance-netmap-af_xdp-io_uring)
- [रॉ IP (L3) इंटरफ़ेस पर रीप्ले करना](#replaying-onto-raw-ip-l3-interfaces)
- [libtcpreplay C लाइब्रेरी](#libtcpreplay-c-library)
- [टेस्ट सूट चलाना](#running-the-test-suite)
- [सहायता प्राप्त करना](#getting-help)
- [योगदान](#contributing)
- [लाइसेंस](#license)
- [लेखक](#authors)
The Suite
=========
नेटवर्क प्लेबैक:
--------------------------
* **tcpreplay** / **tcpreplay-edit** — pcap फ़ाइलों को मनमानी गति से नेटवर्क पर रीप्ले करें, वैकल्पिक रूप से उड़ान में पैकेट संपादित करें (`tcpreplay-edit`) या IP पतों को रैंडमाइज़ करें (`tcpreplay`)
* **tcpliveplay** — एक कैप्चर किए गए TCP सत्र को लाइव नेटवर्क पर इस तरह रीप्ले करें कि रिमोट सर्वर वास्तव में प्रतिक्रिया दे (Yazan Siam द्वारा योगदान, [Cisco] द्वारा प्रायोजित, एप्लिकेशन तक पूर्ण नेटवर्क स्टैक के परीक्षण के लिए — सामान्य `tcpreplay` आमतौर पर Layer 2 पर ही रहता है)
Pcap फ़ाइल संपादक और उपयोगिताएं:
--------------------------------
* **tcpprep** — मल्टी-पास pcap प्री-प्रोसेसर जो पैकेट को क्लाइंट या सर्वर के रूप में वर्गीकृत करता है और tcpreplay/tcprewrite द्वारा उपभोग की जाने वाली कैश फ़ाइल लिखता है
* **tcprewrite** — pcap फ़ाइल में TCP/IP और Layer 2 पैकेट हेडर को फिर से लिखता है
* **tcpbridge** — tcprewrite के रीराइटिंग लॉजिक का उपयोग करके दो नेटवर्क सेगमेंट को ब्रिज करता है
* **tcpcapinfo** — रॉ pcap फ़ाइल डिकोडर और डीबगर
4.6 में नया क्या है
==================
* [CMake](#cmake-recommended) अब प्राथमिक, अनुशंसित बिल्ड सिस्टम है
(रिलीज़ tarballs के लिए अभी भी autotools का उपयोग किया जाता है)
* [io_uring](#performance-netmap-af_xdp-io_uring) और
[AF_XDP](#performance-netmap-af_xdp-io_uring) फास्ट-पाथ पैकेट इंजेक्शन,
मौजूदा netmap समर्थन के साथ — दोनों को netmap की तुलना में कम सेटअप
और किसी पैच किए गए ड्राइवर की आवश्यकता नहीं होती
* [libtcpreplay](#libtcpreplay-c-library), रीप्ले इंजन को सीधे आपके अपने
प्रोग्राम में एम्बेड करने के लिए एक स्टैटिक C लाइब्रेरी
* [raw IP (L3) इंटरफेस पर रीप्ले करने](#replaying-onto-raw-ip-l3-interfaces)
के लिए स्वचालित समर्थन, जैसे WireGuard और tun डिवाइस
पूर्ण रिलीज़ इतिहास के लिए [CHANGELOG](https://github.com/appneta/tcpreplay/blob/master/docs/CHANGELOG) देखें।
रिलीज़ इंस्टॉल करना
=====================
[](https://github.com/appneta/tcpreplay/releases)
[](https://sourceforge.net/projects/tcpreplay)
नवीनतम [रिलीज़ tarball](https://github.com/appneta/tcpreplay/releases/latest) डाउनलोड करें
([SourceForge](https://sourceforge.net/projects/tcpreplay) पर भी मिरर किया गया है),
फिर:
```
tar xf tcpreplay-*.tar.xz && cd tcpreplay-*
./configure && make && sudo make install
```
एक रिलीज़ टारबॉल पहले से जनरेट किए गए CLI पार्सर और मैन पेज के साथ आती है, इसलिए इसमें C कंपाइलर और libpcap के अलावा कुछ भी आवश्यक नहीं है — नीचे [स्रोत से बिल्ड करना](#building-from-source) देखें, केवल यदि आप git चेकआउट से काम कर रहे हैं, या CMake, netmap, AF_XDP या io_uring समर्थन चाहते हैं।
अधिक विस्तृत प्लेटफ़ॉर्म-विशिष्ट निर्देश टारबॉल में शामिल `INSTALL` फ़ाइल में हैं (यहाँ [`docs/INSTALL`](https://github.com/appneta/tcpreplay/blob/master/docs/INSTALL) के समान सामग्री)।
स्रोत से बिल्ड करना
=====================
git चेकआउट से बिल्ड करने के लिए `*_opts.def` फ़ाइलों से CLI विकल्प पार्सर और मैन पेज जनरेट करने हेतु `python3` और `asciidoctor` (कोई भी बिल्ड सिस्टम) आवश्यक हैं — इस उद्देश्य के लिए 4.6 में इसने GNU AutoGen का स्थान लिया (AutoGen EOL है; ये नहीं हैं)। AutoGen स्वयं अभी भी केवल एक आंतरिक हेडर (`src/tcpedit/tcpedit_stub.h`) के लिए आवश्यक है — देखें [`scripts/autoopts/README.md`](https://github.com/appneta/tcpreplay/blob/master/scripts/autoopts/README.md)। रिलीज़ टारबॉल बिल्ड करते समय इनमें से कुछ भी आवश्यक नहीं है, क्योंकि यह इन्हें पहले से जनरेट किए हुए शामिल करती है।
Autotools
---------
```
./autogen.sh # only needed once, from a git checkout
./configure
make
sudo make install
```
CMake (अनुशंसित)
--------------------
4.6 के अनुसार, सूट को [CMake](https://cmake.org) (3.16+) के साथ भी बनाया जा सकता है — **Tcpreplay को संकलित करने का अनुशंसित और प्राथमिक तरीका**।
Autotools अभी भी प्रदान किया गया है और रिलीज़ टारबॉल्स के लिए उपयोग किया जाता है, लेकिन अंततः इसे हटा दिया जाएगा, इसलिए नई स्क्रिप्ट्स/पैकेजिंग को CMake को लक्षित करना चाहिए।
```
cmake -B build
cmake --build build
sudo cmake --install build
```
हर `./configure` फ़्लैग का एक CMake समकक्ष है — [`CMakeLists.txt`](https://github.com/appneta/tcpreplay/blob/master/CMakeLists.txt) के शीर्ष पर दी गई तालिका देखें। कुछ उदाहरण:
```
# 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
# custom libpcap install, static linking, custom tcpdump path
cmake -B build -DWITH_LIBPCAP=/usr/local/opt/libpcap \
-DENABLE_STATIC_LINK=ON -DWITH_TCPDUMP=/usr/sbin/tcpdump
# force a specific packet injection method
cmake -B build -DFORCE_INJECT_PCAP_SENDPACKET=ON
# several configurations side by side
cmake -B build-debug -DENABLE_DEBUG=ON
cmake -B build-release
```
`cmake --build build --target manpages` मैन पेजों को पुनः उत्पन्न करता है
(python3 + asciidoctor); एक सादा `cmake --build build` उन्हें कभी नहीं छूता।
CMake Tools एक्सटेंशन वाले VS Code उपयोगकर्ता बस रिपॉज़िटरी
फ़ोल्डर खोल सकते हैं और संकेत मिलने पर एक कॉन्फ़िगर प्रीसेट चुन सकते हैं।
प्रदर्शन: netmap, AF_XDP, io_uring
--------------------------------------
यदि डिफ़ॉल्ट सॉकेट पथ पर्याप्त तेज़ नहीं है, तो Tcpreplay के पास पैकेटों को सीधे NIC तक
पहुँचाने के तीन कम-ओवरहेड तरीके हैं। इन्हें लगभग इसी क्रम में आज़माएँ — io_uring
को सबसे कम सेटअप चाहिए, netmap को सबसे अधिक:
<details>
<summary><b>io_uring</b> (Linux, <code>liburing-dev</code> चाहिए — किसी पैच किए गए ड्राइवर की आवश्यकता नहीं)</summary>
`liburing-dev` स्थापित और [io_uring](https://man7.org/linux/man-pages/man7/io_uring.7.html) समर्थन वाले कर्नेल वाले Linux सिस्टम पर पहचाना जाता है।
पैकेट अभी भी एक नियमित PF_PACKET रॉ सॉकेट के माध्यम से बाहर जाते हैं, लेकिन भेजने की क्रियाएँ
io_uring क्यू के माध्यम से अतुल्यकालिक रूप से सबमिट की जाती हैं, जिससे प्रति-पैकेट
सिसकॉल ओवरहेड कम हो जाता है।
```
sudo apt-get install liburing-dev
cmake -B build && cmake --build build && sudo cmake --install build
sudo tcpreplay -i eth0 --io-uring test.pcap
```
</details>
<details>
<summary><b>AF_XDP</b> (Linux, <code>libxdp-dev</code>/<code>libbpf-dev</code> + eBPF-सक्षम ड्राइवर की आवश्यकता है)</summary>
`libxdp-dev` और `libbpf-dev` स्थापित वाले Linux सिस्टम पर पहचाना जाता है। जब
चयनित किया जाता है (`--xdp`), तो kernel नेटवर्क स्टैक को बायपास कर दिया जाता है और पैकेट
सीधे eBPF-सक्षम ड्राइवर के माध्यम से भेजे जाते हैं — सामान्य
एडाप्टर पर पूर्ण लाइन रेट, व्यावसायिक ट्रैफ़िक जनरेटर के बराबर, बिना
ड्राइवर को पैच किए।
```
sudo apt-get install libxdp-dev libbpf-dev
cmake -B build && cmake --build build && sudo cmake --install build
sudo tcpreplay -i eth0 --xdp test.pcap
```
</details>
<details>
<summary><b>netmap</b> (Linux/BSD, netmap-पैच किए गए नेटवर्क ड्राइवर आवश्यक — सबसे आक्रामक, उच्चतम सीमा)</summary>
[netmap] रीप्ले की अवधि के दौरान नेटवर्क ड्राइवर को बायपास करता है और
सीधे NIC के TX बफ़र्स में लिखता है। यह तीनों विकल्पों में सबसे आक्रामक है —
जब तक यह सक्रिय रहता है, उस इंटरफ़ेस पर नेटवर्क स्टैक बंद रहता है, इसलिए
**जिस इंटरफ़ेस से आपने SSH किया है, उस पर परीक्षण न करें** — लेकिन समर्थित
हार्डवेयर पर इसकी थ्रूपुट सीमा सबसे अधिक है।
[प्रोजेक्ट पेज][netmap] से netmap डाउनलोड और इंस्टॉल करें। यदि आपने इसे
`/usr/src` या `/usr/local/src` में निकाला है तो यह स्वचालित रूप से
चुना जाएगा; अन्यथा बिल्ड को उसकी ओर इंगित करें:
```
cmake -B build -DWITH_NETMAP=/home/fklassen/git/netmap
cmake --build build
sudo cmake --install build
```
</details>
कच्चे IP (L3) इंटरफ़ेस पर रीप्ले करना
--------------------------------------
Linux पर, tcpreplay सीधे केवल-लेयर-3 वाले इंटरफ़ेस जैसे
WireGuard और tun डिवाइस पर रीप्ले कर सकता है — किसी बिल्ड विकल्प या कमांड लाइन फ़्लैग की आवश्यकता नहीं है। इनपुट फ़ाइल में मौजूद कोई भी
लेयर 2 हेडर (VLAN टैग सहित Ethernet, Linux SLL,
loopback, ...) स्वचालित रूप से हटा दिया जाता है और पैकेट सही प्रोटोकॉल के साथ नंगे
IPv4/IPv6 के रूप में भेजे जाते हैं, जिसकी WireGuard जैसे ड्राइवरों को आवश्यकता होती है:
```
sudo tcpreplay -i wg0 test.pcap
```
ध्यान दें कि इन इंटरफ़ेस पर गैर-IP पैकेट (जैसे ARP) नहीं भेजे जा सकते और
उन्हें विफल के रूप में रिपोर्ट किया जाता है, और यह कि इन पर `--io-uring` समर्थित नहीं है।
libtcpreplay C लाइब्रेरी
-----------------------
4.6 से सूट **libtcpreplay** इंस्टॉल करता है, एक स्टैटिक लाइब्रेरी जो वही रीप्ले इंजन उजागर करती है जिसका उपयोग `tcpreplay` बाइनरी `tcpreplay_api.h` के माध्यम से करती है।
एप्लिकेशन pcap फ़ाइलों को रीप्ले कर सकते हैं और लाइव आँकड़े प्रोग्रामेटिक रूप से पढ़ सकते हैं,
बाइनरी को फ़ोर्क करने और उसके आउटपुट को स्क्रैप करने के बजाय:
```
cc myapp.c $(pkg-config --cflags --libs --static libtcpreplay) -o myapp
```
हेडर `include/tcpreplay/` के अंतर्गत इंस्टॉल होते हैं; दोनों बिल्ड सिस्टम लाइब्रेरी और इसकी `libtcpreplay.pc` इंस्टॉल करते हैं। एक पूर्ण प्रोग्राम के लिए [`examples/`](https://github.com/appneta/tcpreplay/blob/master/examples) देखें।
टेस्ट सूट चलाना
------------------------
```
cd test
sudo make test
```
इसके लिए root (raw sockets/packet injection) आवश्यक है और यह कॉन्फ़िगर किए गए
टेस्ट NICs पर लाइव ट्रैफ़िक भेजता है — इसे उस इंटरफ़ेस के विरुद्ध न चलाएँ जिससे आप
जुड़े हुए हैं। `make test` केवल autotools के लिए है; `--with-testnic`/`--with-testnic2`
के साथ टेस्ट NICs कॉन्फ़िगर करने के लिए [`docs/INSTALL`](https://github.com/appneta/tcpreplay/blob/master/docs/INSTALL) देखें।
सहायता प्राप्त करना
============
लगता है आपको कोई बग मिला है, या कोई प्रश्न है? पहले
[मौजूदा issues](https://github.com/appneta/tcpreplay/issues) खोजें, फिर यदि वह
पहले से कवर नहीं है तो [नया issue खोलें](https://github.com/appneta/tcpreplay/issues/new)। कृपया इसमें शामिल करें:
* Tcpreplay संस्करण (`-V`/`--version`) और प्लेटफ़ॉर्म
* यदि यह build समस्या है: `configure`/`cmake` और `make` का आउटपुट
* यदि यह runtime समस्या है: सटीक कमांड लाइन, और आप क्या करने का प्रयास कर रहे थे
उसका विवरण (या संलग्न pcap)
* और कुछ भी जो प्रासंगिक लगे — जितना अधिक विवरण, उतनी तेज़ी से हम मदद कर सकते हैं
विशेष रूप से कोई सुरक्षा भेद्यता मिली है? कृपया सार्वजनिक issue दर्ज करने के बजाय
[`SECURITY.md`](https://github.com/appneta/tcpreplay/blob/master/SECURITY.md) का पालन करें।
आपको tcpreplay-users
[मेलिंग सूची](https://lists.sourceforge.net/lists/listinfo/tcpreplay-users) पर पोस्ट करने से पहले
[दस्तावेज़ीकरण साइट](https://tcpreplay.appneta.com) — [गाइड्स](https://tcpreplay.appneta.com/guides/),
[FAQ](https://tcpreplay.appneta.com/faq/) और
[man पेज](https://tcpreplay.appneta.com/reference/man-pages/) — देखने के लिए भी प्रोत्साहित किया जाता है,
और कृपया मेंटेनर्स को सीधे ईमेल न करें, ताकि दूसरे भी आपके प्रश्न से लाभ उठा सकें
(और उत्तर देने में मदद कर सकें)।
योगदान देना
============
1. रिपॉज़िटरी को [Fork] करें और यदि आपने पहले से नहीं किया है तो [git सेट अप करें][git]
2. अपनी सुविधा या बग फ़िक्स के लिए एक ब्रांच बनाएँ
3. अपना परिवर्तन करें — कोडिंग मानकों और आपके कोड का योगदान लाइसेंस के संदर्भ में
क्या अर्थ रखता है, इसके लिए [`docs/HACKING`](https://github.com/appneta/tcpreplay/blob/master/docs/HACKING) देखें
4. अपने fork पर push करें और `master` के विरुद्ध [pull request भेजें][pr]
हम GitHub पर इसकी समीक्षा करेंगे और आपके साथ चर्चा करेंगे; स्वीकार होने पर, यह सीधे
`master` पर लागू कर दिया जाता है। आर्किटेक्चर-स्तरीय सामग्री — DLT प्लगइन लिखना,
libtcpreplay/libtcpedit को embed करना, और प्लगइन डिज़ाइन — के लिए
[डेवलपर गाइड्स](https://tcpreplay.appneta.com/developers/) भी देखें।
लाइसेंस
=======
Tcpreplay [GPLv3] के अंतर्गत लाइसेंस प्राप्त है, और इसमें University of California, Berkeley,
Lawrence Berkeley Laboratory और उसके योगदानकर्ताओं द्वारा विकसित सॉफ़्टवेयर शामिल है। पूरा पाठ
[`LICENSE`](https://github.com/appneta/tcpreplay/blob/master/LICENSE) में देखें।
यह परियोजना के लिए लिखी गई फ़ाइलों को कवर करता है; Tcpreplay Suite के साथ वितरित कुछ फ़ाइलें
अन्य लेखकों के कॉपीराइट के अंतर्गत हैं और उनका भिन्न लाइसेंस है, तथा उन्हें फ़ाइल के भीतर
ऐसे चिह्नित किया गया है। किसी विशिष्ट फ़ाइल या मॉड्यूल पर लागू लाइसेंसिंग के बारे में प्रश्न
[tcpreplay-users मेलिंग सूची](https://sourceforge.net/p/tcpreplay/mailman/tcpreplay-users/) पर भेजे जा सकते हैं।
लेखक
=======
Tcpreplay को Aaron Turner ने बनाया था। Fred Klassen ([AppNeta by Broadcom][AppNeta])
ने 2013 में, 4.0 रिलीज़ से शुरू करते हुए, रखरखाव संभाला, और ऊपर वर्णित प्रदर्शन तथा
flow-testing सुविधाएँ जोड़ीं।
[GPLv3]: http://www.gnu.org/licenses/gpl-3.0.html
[netmap]: https://github.com/luigirizzo/netmap
[flow]: https://en.wikipedia.org/wiki/Traffic_flow_(computer_networking)
[NetFlow]: http://www.cisco.com/go/netflow
[Cygwin]: http://www.cygwin.com/
[Wireshark]: https://www.wireshark.org
[tcpdump]: http://www.tcpdump.org
[Cisco]: http://www.cisco.com
[AppNeta]: https://www.broadcom.com/products/software/network-management/appneta
[git]: https://help.github.com/articles/set-up-git
[Fork]: https://help.github.com/articles/fork-a-repo
[pr]: https://help.github.com/articles/using-pull-requests