This article describes how the Data Plane Development Kit (DPDK) packet capture framework is used for capturing packets on the DPDK ports. It is written with users of DPDK in mind who want to know more about the feature and for those who want to monitor traffic on DPDK-controlled devices.
The DPDK packet capture framework was introduced in DPDK v16.07. The DPDK packet capture framework consists of the DPDK pdump library and DPDK pdump tool.
The librte_pdump library provides the APIs required to allow users to initialize the packet capture framework and to enable or disable packet capture. The library works on a client/server model and its usage is recommended for debugging purposes.
The ‘dpdk-pdump’ tool runs as a DPDK secondary process and is capable of enabling or disabling packet capture on the DPDK ports. The tool is developed based on the librte_pdump library. The dpdk-pdump tool provides command-line options with which users can request enabling or disabling of the packet capture on DPDK ports. The dpdk-pdump tool can only be used in conjunction with a primary application which has the packet capture framework initialized already.
The application which initializes the packet capture framework will act as a server and the application that enables or disables the packet capture will act as a client. The server sends the Rx and Tx packets from the DPDK ports to the client.
The DPDK ‘testpmd’ application is modified to initialize the packet capture framework and act as a server, and the dpdk-pdump tool acts as a client. To view Rx or Tx packets of testpmd, the application should be launched first, and then the dpdk-pdump tool. Packets from the testpmd will be sent to the tool, which then sends them on to the pcap pmd device and that device writes them to the pcap file or to an external interface depending on the command-line option used.
Figure 1 shows the usage of the dpdk-pdump tool for packet capturing on the DPDK port.
Figure 1: Packet capturing on DPDK port using the dpdk-pdump tool.
The following steps demonstrate how to run the dpdk-pdump tool to capture Rx side packets of dpdk_port0 and inspect them using tcpdump.
sudo ./app/testpmd -c 0xf0 -n 4 -- -i --port-topology=chained
sudo ./build/app/dpdk-pdump -- --pdump 'port=0,queue=*,rx-dev=/tmp/capture.pcap'
$tcpdump -nr /tmp/capture.pcap reading from file /tmp/capture.pcap, link-type EN10MB (Ethernet) 11:11:36.891404 IP 18.104.22.168.whois++ > 22.214.171.124.whois++: UDP, length 18 11:11:36.891442 IP 126.96.36.199.whois++ > 188.8.131.52.whois++: UDP, length 18 11:11:36.891445 IP 184.108.40.206.whois++ > 220.127.116.11.whois++: UDP, length 18
In this article we described the DPDK pdump library and the pdump tool and how they can be used to capture traffic passing on DPDK ports.
More details on librte_pdump library and dpdk-pdump tool can be found at following links.
The DPDK Programmer's Guide has a section dedicated to the librte_pdump library, which contains more information about how it works.
The Sample Applications Users Guide has a section dedicated to the dpdk-pdump application.
The article DPDK Pdump in Open vSwitch* with DPDK describes use of dpdk-pdump for DPDK devices in OvS-DPDK configurations.
If you have questions regarding usage, feel free to follow up with an email query at firstname.lastname@example.org.
Reshma Pattan is a Network Software Engineer at Intel Corporation. Her work primarily focuses on data plane library development for DPDK. Her contributions to DPDK include the addition of the packet reorder library, the packet ordering sample application, the pdump library, and the dpdk-pdump tool.
Los compiladores Intel pueden o no optimizar al mismo nivel para los microprocesadores que no son Intel en optimizaciones que no son exclusivas de los microprocesadores Intel. Estas optimizaciones incluyen los conjuntos de instrucciones SSE2, SSE3 y SSSE3, y otras optimizaciones. Intel no garantiza la disponibilidad, funcionalidad o eficacia de ninguna optimización en microprocesadores que no sean fabricados por Intel. Las optimizaciones dependientes del microprocesador en este producto fueron diseñadas para usarse con microprocesadores Intel. Ciertas optimizaciones no específicas de la microarquitectura Intel se reservan para los microprocesadores Intel. Consulte las guías de referencia y para el usuario para obtener más información acerca de los conjuntos de instrucciones específicos cubiertos por este aviso.
Revisión del aviso n.° 20110804