X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Ftools%2Ftestregex.rst;fp=doc%2Fguides%2Ftools%2Ftestregex.rst;h=a59acd919f9b2297711a6e9c883b19a1a15d6720;hb=6b99ba8d4bca072f31612cb0d86847f009e8a4aa;hp=112b2bb773e71ca90cfc9168c61724ae9d71fa3f;hpb=f5cffb7eb7fb6c2ddcfcc706c52faf538522eab7;p=dpdk.git diff --git a/doc/guides/tools/testregex.rst b/doc/guides/tools/testregex.rst index 112b2bb773..a59acd919f 100644 --- a/doc/guides/tools/testregex.rst +++ b/doc/guides/tools/testregex.rst @@ -7,13 +7,28 @@ dpdk-test-regex Tool The ``dpdk-test-regex`` tool is a Data Plane Development Kit (DPDK) application that allows functional testing and performance measurement for the RegEx PMDs. -The test supports only one core and one PMD. + It is based on precompiled rule file, and an input file, both of them can be selected using command-line options. In general case, each PMD has its own rule file. -The test outputs the following data: +By default the test supports one QP per core, however a higher number of cores +and QPs can be configured. The QPs are evenly distributed on the cores. All QPs +are assigned the same number of segments of input file to parse. Given n QPs +(per core) - the enqueue/dequeue RegEx operations are interleaved as follows:: + + enqueue(QP #1) + enqueue(QP #2) + ... + enqueue(QP #n) + dequeue(QP #1) + dequeue(QP #2) + ... + dequeue(QP #n) + + +The test outputs the following data per QP and core: * Performance, in gigabit per second. @@ -26,8 +41,6 @@ The test outputs the following data: Limitations ~~~~~~~~~~~ -* Only one queue is supported. - * Supports only precompiled rules. @@ -43,6 +56,12 @@ Application Options ``--nb_jobs N`` number of jobs to use +``--nb_qps N`` + number of QPs to use + +``--nb_lcores N`` + number of cores to use + ``--perf N`` only outputs the performance data @@ -70,4 +89,5 @@ The data file, will be used as a source data for the RegEx to work on. The tool has a number of command line options. Here is the sample command line:: - ./dpdk-test-regex -a 83:00.0 -- --rules rule_file.rof2 --data data_file.txt --job 100 + ./dpdk-test-regex -a 83:00.0 -- --rules rule_file.rof2 --data data_file.txt --job 100 \ + --nb_qps 4 --nb_lcores 2