seladb/pcapplusplusBibliothèque C++ multiplateforme pour la capture, l'analyse, la création et l'analyse de paquets réseau haute performance. Prend en charge libpcap, DPDK, AF_XDP, PF_RING, et inclut le réassemblage TCP, l'empreinte digitale TLS et le décodage de protocole.
<div align="center">
[](https://pcapplusplus.github.io)
[](https://github.com/seladb/PcapPlusPlus/actions?query=workflow%3A%22Build+and+test%22)
[](https://github.com/seladb/PcapPlusPlus/actions?query=workflow%3A%22CodeQL%22)
[](https://app.codecov.io/github/seladb/PcapPlusPlus)
[](https://scorecard.dev/viewer/?uri=github.com/seladb/PcapPlusPlus)
[](https://github.com/seladb/PcapPlusPlus/graphs/contributors)
[](https://x.com/intent/follow?screen_name=seladb)
[]()
</div>
[PcapPlusPlus](https://pcapplusplus.github.io/) est une bibliothèque C++ multiplateforme pour la capture, l'analyse et la fabrication de paquets réseau. Elle est conçue pour être efficace, puissante et facile à utiliser.
PcapPlusPlus offre des capacités de décodage et de forgeage pour une grande variété de protocoles réseau. Il fournit également des wrappers C++ faciles à utiliser pour les moteurs de traitement de paquets les plus populaires tels que [libpcap](https://www.tcpdump.org/), [WinPcap](https://www.winpcap.org/), [Npcap](https://nmap.org/npcap/), [DPDK](https://www.dpdk.org/), [eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html), [WinDivert](https://reqrypt.org/windivert.html) et [PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/).
Traductions : English · [正體中文](https://github.com/seladb/pcapplusplus/blob/master/translation/README-zh-tw.md) · [한국어](https://github.com/seladb/pcapplusplus/blob/master/translation/README-kor.md) · [日本語](https://github.com/seladb/pcapplusplus/blob/master/translation/README-ja.md) · [Русский](https://github.com/seladb/pcapplusplus/blob/master/translation/README-rus.md)
## Table des matières
- [Table des matières](#table-des-matières)
- [Téléchargement](#téléchargement)
- [Page des versions GitHub](#page-des-versions-github)
- [Homebrew](#homebrew)
- [Vcpkg](#vcpkg)
- [Conan](#conan)
- [Compiler soi-même](#compiler-soi-même)
- [Vérifier vos paquets](#vérifier-vos-paquets)
- [Aperçu des fonctionnalités](#aperçu-des-fonctionnalités)
- [Premiers pas](#premiers-pas)
- [Documentation de l'API](#documentation-de-lapi)
- [Prise en charge multiplateforme](#prise-en-charge-multiplateforme)
- [Protocoles réseau pris en charge](#protocoles-réseau-pris-en-charge)
- [Couche liaison de données (L2)](#couche-liaison-de-données-l2)
- [Couche réseau (L3)](#couche-réseau-l3)
- [Couche transport (L4)](#couche-transport-l4)
- [Couche session (L5)](#couche-session-l5)
- [Couche présentation (L6)](#couche-présentation-l6)
- [Couche application (L7)](#couche-application-l7)
- [Prise en charge de DPDK et PF_RING](#prise-en-charge-de-dpdk-et-pf_ring)
- [Benchmarks](#benchmarks)
- [Donner votre avis](#donner-votre-avis)
- [Contribuer](#contribuer)
- [Licence](#licence)
## Téléchargement
Vous pouvez choisir entre télécharger depuis la page des versions GitHub, utiliser un gestionnaire de paquets ou compiler PcapPlusPlus vous-même. Pour plus de détails, veuillez consulter la page [Téléchargement](https://pcapplusplus.github.io/docs/install) du site web de PcapPlusPlus.
[](https://tooomm.github.io/github-release-stats/?username=seladb&repository=PcapPlusPlus)
### Page des versions GitHub
<https://github.com/seladb/PcapPlusPlus/releases/latest>
### Homebrew
```shell
brew install pcapplusplus
```
Formules Homebrew : <https://formulae.brew.sh/formula/pcapplusplus>
### Vcpkg
Windows :
```text
.\vcpkg install pcapplusplus
```
MacOS/Linux :
```text
vcpkg install pcapplusplus
```
Port Vcpkg : <https://github.com/microsoft/vcpkg/tree/master/ports/pcapplusplus>
### Conan
```text
conan install "pcapplusplus/[>0]@" -u
```
Le paquet dans ConanCenter : <https://conan.io/center/pcapplusplus>
### Compilez-le vous-même
Clonez le dépôt git :
```shell
git clone https://github.com/seladb/PcapPlusPlus.git
```
Suivez les instructions de compilation adaptées à votre plateforme sur la page [Build From Source](https://pcapplusplus.github.io/docs/install#build-from-source) du site web de PcapPlusPlus.
### Vérifier vos paquets
Les versions de PcapPlusPlus postérieures à la v23.09 sont signées avec l'attestation GitHub. Toutes les attestations sont disponibles [ici](https://github.com/seladb/PcapPlusPlus/attestations). Vous pouvez vérifier l'attestation de ces paquets avec GitHub CLI. Pour vérifier les paquets, vous pouvez suivre les instructions les plus récentes de [gh attestation verify](https://cli.github.com/manual/gh_attestation_verify). Pour des instructions simples, vous pouvez utiliser la commande suivante :
```shell
gh attestation verify <path-to-package-file> --repository seladb/PcapPlusPlus
```
et vous devriez voir la sortie suivante dans votre terminal :
```shell
✓ Verification succeeded!
```
## Aperçu des fonctionnalités
- __Capture de paquets__ via un wrapper C++ facile à utiliser pour les moteurs de capture de paquets populaires tels que [libpcap](https://www.tcpdump.org/), [WinPcap](https://www.winpcap.org/), [Npcap](https://nmap.org/npcap/), [Intel DPDK](https://www.dpdk.org/), [eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html), [WinDivert](https://reqrypt.org/windivert.html), [PF_RING de ntop](https://www.ntop.org/products/packet-capture/pf_ring/) et les [raw sockets](https://en.wikipedia.org/wiki/Network_socket#Raw_socket) [[En savoir plus](https://pcapplusplus.github.io/docs/features#packet-capture)]
- __Analyse et création de paquets__ incluant une analyse détaillée des protocoles et des couches, la génération de paquets et l'édition de paquets pour une grande variété de [protocoles réseau](https://pcapplusplus.github.io/docs/features#supported-network-protocols) [[En savoir plus](https://pcapplusplus.github.io/docs/features#packet-parsing-and-crafting)]
- __Lecture et écriture de paquets depuis/vers des fichiers__ aux formats __PCAP__ et __PCAPNG__ [[En savoir plus](https://pcapplusplus.github.io/docs/features#read-and-write-packets-fromto-files)]
- __Traitement de paquets à la vitesse de ligne__ via un wrapper C++ efficace et facile à utiliser pour [DPDK](https://www.dpdk.org/), [eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html) et [PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/) [[En savoir plus](https://pcapplusplus.github.io/docs/features#dpdk-support)]
- __Support multiplateforme__ - PcapPlusPlus est entièrement pris en charge sur Linux, MacOS, Windows, Android et FreeBSD
- __Réassemblage de paquets__ - implémentation unique du __réassemblage TCP__ qui inclut la retransmission TCP, les paquets TCP hors séquence et les données TCP manquantes, ainsi que la __fragmentation et défragmentation IP__ pour créer et réassembler des fragments IPv4 et IPv6 [[En savoir plus](https://pcapplusplus.github.io/docs/features#packet-reassembly)]
- __Filtrage de paquets__ qui rend les filtres BPF de libpcap beaucoup plus conviviaux [[En savoir plus](https://pcapplusplus.github.io/docs/features#packet-filtering)]
- __Empreinte TLS__ - une implémentation C++ de l'empreinte TLS [JA3 et JA3S](https://github.com/salesforce/ja3) [[En savoir plus](https://pcapplusplus.github.io/docs/features#tls-fingerprinting)]
## Pour commencer
Écrire des applications avec PcapPlusPlus est très facile et intuitif. Voici une application simple qui montre comment lire un paquet depuis un fichier PCAP et l'analyser :
```cpp
#include <iostream>
#include "IPv4Layer.h"
#include "Packet.h"
#include "PcapFileDevice.h"
int main(int argc, char* argv[])
{
// open a pcap file for reading
pcpp::PcapFileReaderDevice reader("1_packet.pcap");
if (!reader.open())
{
std::cerr << "Error opening the pcap file" << std::endl;
return 1;
}
// read the first (and only) packet from the file
pcpp::RawPacket rawPacket;
if (!reader.getNextPacket(rawPacket))
{
std::cerr << "Couldn't read the first packet in the file" << std::endl;
return 1;
}
// parse the raw packet into a parsed packet
pcpp::Packet parsedPacket(&rawPacket);
// verify the packet is IPv4
if (parsedPacket.isPacketOfType(pcpp::IPv4))
{
// extract source and dest IPs
pcpp::IPv4Address srcIP = parsedPacket.getLayerOfType<pcpp::IPv4Layer>()->getSrcIPv4Address();
pcpp::IPv4Address destIP = parsedPacket.getLayerOfType<pcpp::IPv4Layer>()->getDstIPv4Address();
// print source and dest IPs
std::cout << "Source IP is '" << srcIP << "'; Dest IP is '" << destIP << "'" << std::endl;
}
// close the file
reader.close();
return 0;
}
```
Vous pouvez trouver beaucoup plus d'informations dans la page [Getting Started](https://pcapplusplus.github.io/docs/quickstart) du site web de PcapPlusPlus. Cette page vous guidera à travers quelques étapes simples pour avoir une application opérationnelle.
## Documentation de l'API
PcapPlusPlus se compose de 3 bibliothèques :
1. __Packet++__ - une bibliothèque pour analyser, créer et modifier des paquets réseau
2. __Pcap++__ - une bibliothèque pour intercepter et envoyer des paquets, fournissant des informations sur le réseau et la carte réseau, des statistiques, etc. Il s'agit en réalité d'une surcouche C++ pour les moteurs de capture de paquets tels que libpcap, WinPcap, Npcap, DPDK, AF_XDP, WinDivert et PF_RING
3. __Common++__ - une bibliothèque contenant des utilitaires de code communs utilisés à la fois par Packet++ et Pcap++
Vous pouvez trouver une documentation API complète dans la [section documentation de l'API](https://pcapplusplus.github.io/docs/api) du site web de PcapPlusPlus.
Si vous constatez des données manquantes, veuillez [nous contacter](#provide-feedback).
## Prise en charge multiplateforme
PcapPlusPlus est actuellement pris en charge sur
__Windows__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-windows.png" alt="" width="16" height="16"/>
</picture>,
__Linux__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-linux.png" alt="" width="16" height="16"/>
</picture>,
__MacOS__
<picture><source media="(prefers-color-scheme: dark)" srcset="https://github.com/PcapPlusPlus/pcapplusplus.github.io/raw/master/static/img/os-logos/logo-apple-dark.png"/>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-apple.png" alt="" width="16" height="16"/>
</picture>,
__Android__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-android.png" alt="" width="16" height="16"/>
</picture> et
__FreeBSD__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-freebsd.png" alt="" width="16" height="16"/>
</picture>.
Veuillez visiter le site web de PcapPlusPlus pour voir toutes les [plateformes prises en charge](https://pcapplusplus.github.io/docs/platforms) et vous référer à la section [Download](#download) pour commencer à utiliser PcapPlusPlus sur votre plateforme.
## Protocoles réseau pris en charge
PcapPlusPlus prend actuellement en charge l'analyse, la modification et la création de paquets des protocoles suivants :
### Couche liaison de données (L2)
1. Cisco HDLC
2. Ethernet II
3. GENEVE
4. IEEE 802.3 Ethernet
5. LLC (seul BPDU est pris en charge)
6. Null/Loopback
7. Packet trailer (aussi appelé footer ou padding)
8. PPPoE
9. SLL (Linux cooked capture)
10. SLL2 (Linux cooked capture v2)
11. STP
12. VLAN
13. VXLAN
14. Wake on LAN (WoL)
15. NFLOG (Linux Netfilter NFLOG) - analyse uniquement (pas de capacités de modification)
### Couche réseau (L3)
16. ARP
17. GRE
18. ICMP
19. ICMPv6
20. IGMP (IGMPv1, IGMPv2 et IGMPv3 sont pris en charge)
21. IPv4
22. IPv6
23. MPLS
24. NDP
25. Raw IP (IPv4 & IPv6)
26. VRRP (IPv4 & IPv6)
27. WireGuard
### Couche transport (L4)
28. COTP
29. GTP (v1 & v2)
30. IPSec AH & ESP - analyse uniquement (pas de capacités de modification)
31. QUIC v1 - analyse uniquement (pas de capacités de modification)
32. TCP
33. TPKT
34. UDP
### Couche session (L5)
35. SDP
36. SIP
### Couche présentation (L6)
37. SSL/TLS - analyse uniquement (pas de capacités de modification)
### Couche application (L7)
38. Décodeur et encodeur ASN.1
39. BGP (v4)
40. Décodeurs de clés cryptographiques
41. DHCP
42. DHCPv6
43. DNS
44. DoIP
45. FTP
46. GVCP
47. En-têtes HTTP (requête & réponse)
48. LDAP
49. Modbus
50. MySQL - analyse uniquement (pas de capacités de modification)
51. NTP (v3, v4)
52. Décodeur et encodeur PEM
53. PostgreSQL Wire Protocol (PGWire) - analyse uniquement (pas de capacités de modification)
54. Radius
55. S7 Communication (S7comm)
56. SMTP
57. SOME/IP
58. SSH - analyse uniquement (pas de capacités de modification)
59. Telnet - analyse uniquement (pas de capacités de modification)
60. Certificats X509 - analyse uniquement (pas de capacités de modification)
61. Charge utile générique
## Prise en charge de DPDK et PF_RING
[The Data Plane Development Kit (DPDK)](https://www.dpdk.org/) est un ensemble de bibliothèques de plan de données et de pilotes de contrôleurs d'interface réseau pour le traitement rapide des paquets.
[PF_RING™](https://www.ntop.org/products/packet-capture/pf_ring/) est un nouveau type de socket réseau qui améliore considérablement la vitesse de capture des paquets.
Les deux frameworks offrent un traitement très rapide des paquets (jusqu'à la vitesse de ligne) et sont utilisés dans de nombreuses applications réseau telles que les routeurs, les pare-feu, les répartiteurs de charge, etc.
PcapPlusPLus fournit une couche d'abstraction C++ au-dessus de DPDK et PF_RING. Cette couche d'abstraction offre une interface facile à utiliser qui élimine une grande partie du code répétitif lié à l'utilisation de ces frameworks. Vous pouvez en apprendre davantage en consultant les pages de support [DPDK](https://pcapplusplus.github.io/docs/dpdk) et [PF_RING](https://pcapplusplus.github.io/docs/features#pf_ring-support) sur le site web de PcapPlusPlus.
## Benchmarks
Nous avons utilisé le projet [packet-capture-benchmarks](https://github.com/mfontanini/packet-capture-benchmarks) de Matias Fontanini pour comparer les performances de PcapPlusPlus avec d'autres bibliothèques C++ similaires (telles que `libtins` et `libcrafter`).
Vous pouvez consulter les résultats sur la page [Benchmarks](https://pcapplusplus.github.io/docs/benchmark) du site web de PcapPlusPlus.
## Donner votre avis
Nous serions ravis de recevoir vos retours, n'hésitez pas à nous contacter de l'une des manières suivantes :
- Ouvrir un ticket GitHub
- Publier un message dans le groupe Google PcapPlusPlus : <https://groups.google.com/d/forum/pcapplusplus-support>
- Poser une question sur Stack Overflow : <https://stackoverflow.com/questions/tagged/pcapplusplus>
- Envoyer un e-mail à : <[email protected]>
- Nous suivre sur X : <https://x.com/seladb>
Si vous aimez ce projet, veuillez __nous mettre une étoile sur GitHub — cela aide !__ :star: :star:
Veuillez consulter le [site web de PcapPlusPlus](https://pcapplusplus.github.io/community) pour en savoir plus.
## Contribuer
Nous apprécierions grandement toute contribution à ce projet. Si vous souhaitez contribuer, veuillez consulter la [page de contribution](https://pcapplusplus.github.io/community#contribute) du site web de PcapPlusPlus.
## Licence
PcapPlusPlus est publié sous la [licence Unlicense](https://choosealicense.com/licenses/unlicense/).
[](https://choosealicense.com/licenses/unlicense/)