1.. SPDX-License-Identifier: BSD-3-Clause 2 Copyright 2020 Mellanox Technologies, Ltd 3 4dpdk-test-regex Tool 5==================== 6 7The ``dpdk-test-regex`` tool is a Data Plane Development Kit (DPDK) 8application that allows functional testing and performance measurement for 9the RegEx PMDs. 10 11It is based on precompiled rule file, and an input file, both of them can 12be selected using command-line options. 13 14In general case, each PMD has its own rule file. 15 16By default the test supports one QP per core, however a higher number of cores 17and QPs can be configured. The QPs are evenly distributed on the cores. All QPs 18are assigned the same number of segments of input file to parse. Given n QPs 19(per core) - the enqueue/dequeue RegEx operations are interleaved as follows:: 20 21 enqueue(QP #1) 22 enqueue(QP #2) 23 ... 24 enqueue(QP #n) 25 dequeue(QP #1) 26 dequeue(QP #2) 27 ... 28 dequeue(QP #n) 29 30 31The test outputs the following data per QP and core: 32 33* Performance, in gigabit per second. 34 35* Matching results (rule id, position, length), for each job. 36 37* Matching results in absolute location (rule id, position , length), 38 relative to the start of the input data. 39 40 41Limitations 42~~~~~~~~~~~ 43 44* Supports only precompiled rules. 45 46 47Application Options 48~~~~~~~~~~~~~~~~~~~ 49 50``--rules NAME`` 51 precompiled rule file 52 53``--data NAME`` 54 data file to use 55 56``--nb_jobs N`` 57 number of jobs to use 58 59``--nb_qps N`` 60 number of QPs to use 61 62``--nb_lcores N`` 63 number of cores to use 64 65``--perf N`` 66 only outputs the performance data 67 68``--nb_iter N`` 69 number of iteration to run 70 71``--help`` 72 print application options 73 74 75Running the Tool 76---------------- 77 78**Step 1: Compile a rule file** 79 80In order for the RegEx to work it must have a precompiled rule file. 81to generate this file there is a need to use a RegEx compiler that matches the 82RegEx PMD. 83 84**Step 2: Generate a data file** 85 86The data file, will be used as a source data for the RegEx to work on. 87 88**Step 3: Run the tool** 89 90The tool has a number of command line options. Here is the sample command line:: 91 92 ./dpdk-test-regex -a 83:00.0 -- --rules rule_file.rof2 --data data_file.txt --job 100 \ 93 --nb_qps 4 --nb_lcores 2 94