index.html

---
title: PcapPlusPlus - a multiplatform C++ library for capturing, parsing and crafting of network packets
layout: generic-page
nav_exclude: true
---
<div class="lp-container">
  <header class="lp-header">
    <div class="lp-center">
      <h1 style="font-weight: bold">Welcome To PcapPlusPlus v21.05!</h1>
      <h2 style="padding-bottom: 30px">A multiplatform C++ library for capturing, parsing and crafting of network packets. It is designed to be efficient, powerful and easy to use.</h2>
      <a href="{{ site.baseurl }}/docs/" class="btn btn-blue fs-5 mb-3 mb-md-5 mr-5">Get started</a>
      <a href="{{ site.baseurl }}/docs/install" class="btn btn-blue fs-5 mb-3 mb-md-5">Download</a>
    </div>
  </header>
  <section class="lp-section">
    <div class="lp-center lp-section-container">
      <div class="lp-col lp-col-left">
        <h2>Capture and send network traffic</h2>
        <p>PcapPlusPlus enables capturing and sending network packets through easy-to-use C++ wrappers for the most popular packet 
          processing engines such as 
          <a href="https://www.tcpdump.org/">libpcap</a>,
          <a href="https://www.winpcap.org/">WinPcap</a>,
          <a href="https://nmap.org/npcap/">Npcap</a>,
          <a href="https://www.dpdk.org/">DPDK</a> and
          <a href="https://www.ntop.org/products/packet-capture/pf_ring/">PF_RING</a> 
        </p>
        <a href="{{ site.baseurl }}/docs/features#packet-capture" class="btn btn-blue fs-5 mb-3 mb-md-5">Learn More</a>
      </div>
      <div class="lp-col">
        <img src="{{ site.baseurl }}/resources/capture-engines.png" class="lp-image"/>
      </div>
    </div>
  </section>
  <section class="lp-section lp-section-invert">
    <div class="lp-center lp-section-container">
      <div class="lp-col">
          <h2>Decode and forge packets</h2>
          <p>PcapPlusPlus enables decoding and forging capabilities for a large variety of <a href="{{ site.baseurl }}/docs/features#supported-network-protocols">network protocols</a></p>
          <a href="{{ site.baseurl }}/docs/features#packet-parsing-and-crafting" class="btn btn-blue fs-5 mb-3 mb-md-5">Learn More</a>
      </div>  
      <div class="lp-col lp-col-left">
{% highlight cpp %}
// parse the raw packet into a parsed packet
pcpp::Packet parsedPacket(&rawPacket);

// check if it's an IPv4 packet
if (parsedPacket.isPacketOfType(pcpp::IPv4)) {
  // extract source and dest IPs
  pcpp::IPv4Address srcIP = 
    parsedPacket.getLayerOfType()->getSrcIPv4Address();
  pcpp::IPv4Address destIP = 
    parsedPacket.getLayerOfType()->getDstIPv4Address();

  // print source and dest IPs
  printf("Source IP is '%s'; Dest IP is '%s'\n", 
    srcIP.toString().c_str(), destIP.toString().c_str());
}
{% endhighlight %}
      </div>
    </div>
  </section>
  <section class="lp-section">
    <div class="lp-center lp-section-container">
      <div class="lp-col lp-col-left">
        <h2>Super Fast!</h2>
        <p>PcapPlusPlus is designed to be efficient and lightweight. It enables amazingly fast packet processing with minimum overhead
        </p>
        <a href="{{ site.baseurl }}/docs/benchmark" class="btn btn-blue fs-5 mb-3 mb-md-5">View Benchmarks</a>
      </div>
      <div class="lp-col">
        <img src="{{ site.baseurl }}/resources/rocket.png" class="lp-image">
      </div>
    </div>
  </section>
  <section class="lp-section lp-section-invert">
    <div class="lp-center lp-section-container">
      <div class="lp-col">
        <h2>Multiplatform support</h2>
        <p>PcapPlusPlus is fully supported on Windows, MacOS, Linux, Android and FreeBSD. You can download pre-built binaries for each platform or
          build it from source. PcapPlusPlus is available in popular package managers such as Homebrew and Conan
        </p>
        <a href="{{ site.baseurl }}/docs/install" class="btn btn-blue fs-5 mb-3 mb-md-5">View Installation Guide</a>
      </div>
      <div class="lp-col lp-col-left">
        <img src="{{ site.baseurl }}/resources/supported-os.png" class="lp-image">
      </div>
    </div>
  </section>
  <section class="lp-section">
    <div class="lp-center lp-section-container">
      <div class="lp-col lp-col-left">
        <h2>Read and write packets to files</h2>
        <p>PcapPlusPlus provides an easy-to-use interface for reading and writing network packets into files. 
          It supports the most popular file formats which are 
          <a href="https://wiki.wireshark.org/Development/LibpcapFileFormat">PCAP</a> and 
          <a href="https://github.com/pcapng/pcapng">PCAPNG</a>
        </p>
        <a href="{{ site.baseurl }}/docs/features#read-and-write-packets-fromto-files" class="btn btn-blue fs-5 mb-3 mb-md-5">Learn More</a>
      </div>      
      <div class="lp-col">
{% highlight cpp %}
// create a pcap file reader
pcpp::PcapFileReaderDevice pcapReader("input.pcap");
pcapReader.open();

// create a pcapng file writer
pcpp::PcapNgFileWriterDevice pcapNgWriter("output.pcapng");
pcapNgWriter.open();

// raw packet object
pcpp::RawPacket rawPacket;

// read packets from pcap reader and write pcapng writer
while (pcapReader->getNextPacket(rawPacket)) {
  pcapNgWriter.writePacket(rawPacket);
}
{% endhighlight %}
      </div>
    </div>
  </section>
  <section class="lp-section lp-section-invert">
    <div class="lp-center lp-section-container">
      <div class="lp-col">
        <h2>Packet reassembly</h2>
        <p>PcapPlusPlus contains unique implementation of packet reassembly techniques.</p>
        <p><strong>TCP Reassembly</strong> which supports TCP retransmission, out-of-order TCP packets and missing TCP data</p>
        <p><strong>IP Fragmentation and Defragmentation</strong> to create and reassemble IPv4 and IPv6 fragments</p>
        <a href="{{ site.baseurl }}/docs/features#packet-reassembly" class="btn btn-blue fs-5 mb-3 mb-md-5">Learn More</a>
      </div>
      <div class="lp-col lp-col-left">
          <img src="{{ site.baseurl }}/resources/stream.png" class="lp-image">
      </div>
    </div>
  </section>
  <footer class="lp-footer">
    <div class="lp-footer-section lp-footer-grid">
      <div>
        <h3>Docs</h3>
        <ul>
          <li><a href="{{ site.baseurl }}/docs/install" class="lp-footer-item">Installation</a></li>
          <li><a href="{{ site.baseurl }}/docs/features" class="lp-footer-item">Features</a></li>
          <li><a href="{{ site.baseurl }}/docs/tutorials" class="lp-footer-item">Tutorials</a></li>
          <li><a href="{{ site.baseurl }}/docs/dpdk" class="lp-footer-item">DPDK</a></li>
          <li><a href="{{ site.baseurl }}/docs/examples" class="lp-footer-item">Examples</a></li>
          <li><a href="{{ site.baseurl }}/docs/api" class="lp-footer-item">API Documentation</a></li>
        </ul>
      </div>
      <div>
        <h3>Community</h3>
        <ul>
          <li><a target="_blank" href="https://github.com/seladb/PcapPlusPlus" class="lp-footer-item">GitHub</a></li>
          <li><a target="_blank" href="https://twitter.com/seladb" class="lp-footer-item">Twitter</a></li>
          <li><a target="_blank" href="https://groups.google.com/d/forum/pcapplusplus-support" class="lp-footer-item">Google Group</a></li>
          <li><a href="mailto:pcapplusplus@gmail.com" class="lp-footer-item">Email</a></li>
          <li><a href="{{ site.baseurl }}/docs/community#contribute" class="lp-footer-item">Contribute</a></li>  
        </ul>
      </div>
      <div>
        <h3>More</h3>
        <ul>
          <li><a href="{{ site.baseurl }}/docs/releases" class="lp-footer-item">Releases</a></li>
          <li><a href="{{ site.baseurl }}/docs/benchmark" class="lp-footer-item">Benchmarks</a></li>
          <li><a href="{{ site.baseurl }}/docs/features#license" class="lp-footer-item">License</a></li> 
          <li><a href="https://github.com/PcapPlusPlus/pcapplusplus.github.io" class="lp-footer-item">Website Repo</a></li> 
        </ul>
      </div>  
    </div>
    <div class="lp-footer-section lp-footer-copyright">
      <img src="{{ site.baseurl }}{{ site.logo_source }}" width="{{ site.logo_width }}" height="57">
      <p>Copyright © {{ site.time | date: '%Y' }} {{ site.github_username }}</p>
    </div>
  </footer>
</div>