171. CompressDev ZLIB PMD Tests¶

171.1. Description¶

The ZLIB PMD (librte_pmd_zlib) provides poll mode compression & decompression driver based on SW zlib library.

The supported Compression/Decompression algorithm:

DEFLATE - using Fixed and Dynamic Huffman encoding

For more details, please reference to dpdk online programming guide. http://doc.dpdk.org/guides/compressdevs/zlib.html

171.2. Prerequisites¶

A compress performance test app is added into DPDK to test CompressDev. RTE_COMPRESS_ZLIB and RTE_LIB_COMPRESSDEV is enabled by default in meson build. Calgary corpus is a collection of text and binary data files, commonly used for comparing data compression algorithms.

171.3. Software¶

dpdk: http://dpdk.org/git/dpdk ZLIB library: zlib sources from http://zlib.net/

171.4. General set up¶

1, Compile DPDK:

CC=gcc meson -Denable_kmods=True -Dlibdir=lib  --default-library=static x86_64-native-linuxapp-gcc
ninja -C x86_64-native-linuxapp-gcc -j 110

2, Get the pci device id of QAT:

./dpdk/usertools/dpdk-devbind.py --status-dev crypto

3, Bind QAT VF port to dpdk:

./dpdk/usertools/dpdk-devbind.py --force --bind=vfio-pci 0000:1a:01.0 0000:1a:01.1

171.4.1. Test case¶

171.5. Test Case: Compressdev ZLIB PMD Unit test¶

Start test application and run zlib pmd unit test:

./x86_64-native-linuxapp-gcc/app/test/dpdk-test -l1 -n1 -a vdev_bus_id --vdev=compress_zlib
RTE>>compressdev_autotest

Verify all test cases passed in the test.

171.6. Test Case: Compressdev ZLIB PMD fixed function test¶

Run Compressdev zlib pmd test with below sample commands:

./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf  -a vdev_bus_id -l 4 \
--vdev=compress_zlib -- --driver-name compress_zlib --input-file file_name \
--compress-level level --num-iter number --huffman-enc fixed

Perform the test with fixed huffman-enc.

Test all the file types in calgary corpus, all files should pass the test.

171.7. Test Case: Compressdev ZLIB PMD dynamic function test¶

Run Compressdev zlib pmd test with below sample commands:

./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf  -a vdev_bus_id -l 4 \
--vdev=compress_zlib -- --driver-name compress_zlib --input-file file_name \
--compress-level level --num-iter number --huffman-enc dynamic

Perform the test with dynamic huffman-enc.

Test all the file types in calgary corpus, all files should pass the test.

171.8. Test Case: Compressdev ZLIB PMD fixed performance test¶

Run Compressdev zlib pmd performance test with below sample commands:

./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf  -a vdev_bus_id -l 4 \
--vdev=compress_zlib -- --driver-name compress_zlib --input-file file_name \
--compress-level level --seg-sz size --num-iter number --huffman-enc fixed

Perform the test with fixed huffman-enc and calgary file.

Run the test with seg-sz 1k, 2k, 4k, 8k, 16k and 32k respectively.

171.9. Test Case: Compressdev ZLIB PMD dynamic performance test¶

Run Compressdev zlib pmd performance test with below sample commands:

./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf  -a vdev_bus_id -l 4 \
--vdev=compress_zlib -- --driver-name compress_zlib --input-file file_name \
--compress-level level --seg-sz size --num-iter number --huffman-enc dynamic

Perform the test with dynamic huffman-enc and calgary file.

Run the test with seg-sz 1k, 2k, 4k, 8k, 16k and 32k respectively.