doc: add note for pdump initialization
authorReshma Pattan <reshma.pattan@intel.com>
Mon, 3 Jul 2017 14:17:58 +0000 (15:17 +0100)
committerThomas Monjalon <thomas@monjalon.net>
Sun, 9 Jul 2017 22:46:38 +0000 (00:46 +0200)
Updated note to make users aware that the packet capture framework
is initialized by default only in testpmd. Other primary applications
need to explicitly modify the code to do this initialization.

Signed-off-by: Reshma Pattan <reshma.pattan@intel.com>
doc/guides/tools/pdump.rst

index 57097e4..b46a92f 100644 (file)
@@ -38,6 +38,12 @@ a DPDK secondary process and is capable of enabling packet capture on dpdk ports
    .. Note::
       * The ``dpdk-pdump`` tool can only be used in conjunction with a primary
         application which has the packet capture framework initialized already.
+        In dpdk, only the ``testpmd`` is modified to initialize packet capture
+        framework, other applications remain untouched. So, if the ``dpdk-pdump``
+        tool has to be used with any application other than the testpmd, user
+        needs to explicitly modify that application to call packet capture
+        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,