X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Ftools%2Fpdump.rst;h=6f9bd77ab135607bf1855e7d3d2bd3c5bcfd073c;hb=bc778a17fa46f1ec69180c7f660585155eefc318;hp=7c2b73e72819b7187aa7aeef1db7fbdc1a788893;hpb=89745a4ce7fbf3817d0a96e18585079b0d9e60ec;p=dpdk.git diff --git a/doc/guides/tools/pdump.rst b/doc/guides/tools/pdump.rst index 7c2b73e728..6f9bd77ab1 100644 --- a/doc/guides/tools/pdump.rst +++ b/doc/guides/tools/pdump.rst @@ -19,12 +19,12 @@ a DPDK secondary process and is capable of enabling packet capture on dpdk ports framework initialization code. Refer ``app/test-pmd/testpmd.c`` code to see how this is done. - * The ``dpdk-pdump`` tool depends on libpcap based PMD which is disabled - by default in the build configuration files, - owing to an external dependency on the libpcap development files - which must be installed on the board. - Once the libpcap development files are installed, the libpcap based PMD - can be enabled by setting CONFIG_RTE_LIBRTE_PMD_PCAP=y and recompiling the DPDK. + * The ``dpdk-pdump`` tool depends on DPDK pcap PMD, so the system should + have libpcap development files installed and the pcap PMD not disabled + in the build. + + * The ``dpdk-pdump`` tool runs as a DPDK secondary process. It exits when + the primary application exits. Running the Application @@ -34,7 +34,8 @@ The tool has a number of command line options: .. code-block:: console - ./build/app/dpdk-pdump -- + .//app/dpdk-pdump -- + [--multi] --pdump '(port= | device_id=), (queue=), (rx-dev= | @@ -43,6 +44,10 @@ The tool has a number of command line options: [mbuf-size=], [total-num-mbufs=]' +The ``--multi`` command line option is optional argument. If passed, capture +will be running on unique cores for all ``--pdump`` options. If ignored, +capture will be running on single core for all ``--pdump`` options. + The ``--pdump`` command line option is mandatory and it takes various sub arguments which are described in below section. @@ -112,4 +117,5 @@ Example .. code-block:: console - $ sudo ./build/app/dpdk-pdump -- --pdump 'port=0,queue=*,rx-dev=/tmp/rx.pcap' + $ sudo .//app/dpdk-pdump -l 3 -- --pdump 'port=0,queue=*,rx-dev=/tmp/rx.pcap' + $ sudo .//app/dpdk-pdump -l 3,4,5 -- --multi --pdump 'port=0,queue=*,rx-dev=/tmp/rx-1.pcap' --pdump 'port=1,queue=*,rx-dev=/tmp/rx-2.pcap'