From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id B503EA00BE; Fri, 10 Dec 2021 04:49:40 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B061441147; Fri, 10 Dec 2021 04:49:40 +0100 (CET) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by mails.dpdk.org (Postfix) with ESMTP id 6796E40041 for ; Fri, 10 Dec 2021 04:49:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1639108179; x=1670644179; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=5pn+2leBxfBa9ibIppIi3PgeDAriIq0u8dyT0D9nrO8=; b=ZZSxXyYRY7dXdfYjU4sYGGugVFZs/2i6m6v+7qo1D+8Fr4aHThrcPT5e rQNxxQ2qS+b/Vlvz+Fvlz8DC6q13qqpDcuMuzh9VLhdMQOf/qpoVdcOjy lSyGeqON/crN+zDMXKm5NUaz3mRjh0sABVJ/MJ8u2E6MIAzWrqklhn7ki ztcI9u3Ccf7VGfyIwUHlsGYM4DRZRU5nfSycFpUR6+Pbdl4BdXfOMW0LN eHGsxESuJUDIkAeisSmBMXJ0gvIAO7FaFZsgQGPUkQqGpELEuki6Ab+vF jomihYdpoHx3hin9ZPWqTfcmuDz07ekxrhdCmCMtFGUvmWDmtjfTal18h w==; X-IronPort-AV: E=McAfee;i="6200,9189,10193"; a="324527577" X-IronPort-AV: E=Sophos;i="5.88,194,1635231600"; d="scan'208";a="324527577" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Dec 2021 19:49:38 -0800 X-IronPort-AV: E=Sophos;i="5.88,194,1635231600"; d="scan'208";a="516594261" Received: from unknown (HELO localhost.localdomain) ([10.240.183.163]) by orsmga008-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-SHA; 09 Dec 2021 19:49:37 -0800 From: Yu Jiang To: lijuan.tu@intel.com, dts@dpdk.org Cc: Yu Jiang Subject: [dts][PATCH V1 2/3] test_plans/compressdev_isal/qat_zlib_pmd: fix dpdk app/examples name to adapt meson build Date: Fri, 10 Dec 2021 11:49:07 +0800 Message-Id: <1639108148-29874-3-git-send-email-yux.jiang@intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1639108148-29874-1-git-send-email-yux.jiang@intel.com> References: <1639108148-29874-1-git-send-email-yux.jiang@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=y Content-Transfer-Encoding: 8bit X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dts-bounces@dpdk.org fix dpdk app/examples name to adapt meson build Signed-off-by: Yu Jiang --- test_plans/compressdev_isal_pmd_test_plan.rst | 44 ++++++++++++++------ test_plans/compressdev_qat_pmd_test_plan.rst | 58 +++++++++++++++++++-------- test_plans/compressdev_zlib_pmd_test_plan.rst | 38 +++++++++++++++--- 3 files changed, 105 insertions(+), 35 deletions(-) diff --git a/test_plans/compressdev_isal_pmd_test_plan.rst b/test_plans/compressdev_isal_pmd_test_plan.rst index 6ea21b8..54f8c62 100644 --- a/test_plans/compressdev_isal_pmd_test_plan.rst +++ b/test_plans/compressdev_isal_pmd_test_plan.rst @@ -45,27 +45,47 @@ 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/isal.html Prerequisites ---------------------- -In order to enable this virtual compression PMD, user must: - Set CONFIG_RTE_LIBRTE_PMD_ISAL=y in config/common_base. +A compress performance test app is added into DPDK to test CompressDev. +RTE_COMPRESS_ISAL 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. -and enable compressdev unit test: +Software +-------- - Set CONFIG_RTE_COMPRESSDEV_TEST=y in config/common_base. +dpdk: http://dpdk.org/git/dpdk +multi-buffer library: https://github.com/01org/intel-ipsec-mb +Intel QuickAssist Technology Driver: https://01.org/packet-processing/intel%C2%AE-quickassist-technology-drivers-and-patches +Intel’s ISA-L library: https://github.com/01org/isa-l -A compress performance test app is added into DPDK to test CompressDev. +General set up +-------------- +1, Compile DPDK:: -Calgary corpus is a collection of text and binary data files, commonly used -for comparing data compression algorithms. + 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 + +Test case +========= Test Case: Compressdev ISA-L PMD Unit test ---------------------------------------------------------------- Start test application and run isal pmd unit test:: - ./app/test -l1 -n1 -a vdev_bus_id --vdev=compress_isal + ./x86_64-native-linuxapp-gcc/app/test/dpdk-test -l1 -n1 -a vdev_bus_id --vdev=compress_isal RTE>>compressdev_autotest Verify all test cases passed in the test. @@ -74,7 +94,7 @@ Test Case: Compressdev ISA-L PMD fixed function test --------------------------------------------------------- Run Compressdev isal pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ --vdev=compress_isal -- --driver-name compress_isal --input-file file_name \ --compress-level level --num-iter number --huffman-enc fixed @@ -86,7 +106,7 @@ Test Case: Compressdev ISA-L PMD dynamic function test --------------------------------------------------------- Run Compressdev isal pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ --vdev=compress_isal -- --driver-name compress_isal --input-file file_name \ --compress-level level --num-iter number --huffman-enc dynamic @@ -98,7 +118,7 @@ Test Case: Compressdev ISA-L PMD fixed performance test ----------------------------------------------------------- Run Compressdev isal pmd performance test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ --vdev=compress_isal -- --driver-name compress_isal --input-file file_name \ --compress-level level --seg-sz size --num-iter number --huffman-enc fixed @@ -110,7 +130,7 @@ Test Case: Compressdev ISA-L PMD dynamic performance test ---------------------------------------------------------------- Run Compressdev isal pmd performance test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ --vdev=compress_isal -- --driver-name compress_isal --input-file file_name \ --compress-level level --seg-sz size --num-iter number --huffman-enc dynamic diff --git a/test_plans/compressdev_qat_pmd_test_plan.rst b/test_plans/compressdev_qat_pmd_test_plan.rst index a23be22..61fb2ee 100644 --- a/test_plans/compressdev_qat_pmd_test_plan.rst +++ b/test_plans/compressdev_qat_pmd_test_plan.rst @@ -50,25 +50,49 @@ 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/qat_comp.html Prerequisites ---------------------- Intel QAT devices should be available in the platform. - -enable compressdev unit test: - - Set CONFIG_RTE_COMPRESSDEV_TEST=y in config/common_base. +The QAT compression PMD is built by default with a standard DPDK build +It depends on a QAT kernel driver. A compress performance test app is added into DPDK to test CompressDev. Calgary corpus is a collection of text and binary data files,commonly used for comparing data compression algorithms. +Software +-------- + +dpdk: http://dpdk.org/git/dpdk +Intel QuickAssist Technology Driver: https://01.org/packet-processing/intel%C2%AE-quickassist-technology-drivers-and-patches + +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 + +Test case +========= + Test Case: Compressdev QAT PMD Unit test ---------------------------------------------------------------- Start test application and run qat pmd unit test:: - ./app/test -l1 -n1 -a qat_device_bus_id --log-level=qat:8 + ./x86_64-native-linuxapp-gcc/app/test/dpdk-test -l1 -n1 -a qat_device_bus_id --log-level=qat:8 RTE>>compressdev_autotest Verify all test cases passed in the test. @@ -77,7 +101,7 @@ Test Case: Compressdev QAT PMD fixed function test ---------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --huffman-enc fixed @@ -89,7 +113,7 @@ Test Case: Compressdev QAT PMD dynamic function test ----------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --huffman-enc dynamic @@ -101,7 +125,7 @@ Test Case: Compressdev QAT PMD big sgl fixed function test -------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name --seg-sz segsize \ --compress-level level --num-iter number --extended-input-sz size \ --max-num-sgl-segs seg --huffman-enc fixed @@ -114,7 +138,7 @@ Test Case: Compressdev QAT PMD big sgl dynamic function test -------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name --seg-sz segsize \ --compress-level level --num-iter number --extended-input-sz size \ --max-num-sgl-segs seg --huffman-enc dynamic @@ -127,7 +151,7 @@ Test Case: Compressdev QAT PMD big seg-sz fixed function test -------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name --seg-sz segsize \ --compress-level level --num-iter number --extended-input-sz size \ --max-num-sgl-segs seg --huffman-enc fixed @@ -140,7 +164,7 @@ Test Case: Compressdev QAT PMD big seg-sz dynamic function test --------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name --seg-sz segsize \ --compress-level level --num-iter number --extended-input-sz size \ --max-num-sgl-segs seg --huffman-enc dynamic @@ -153,7 +177,7 @@ Test Case: Compressdev QAT PMD external mbufs fixed function test ------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --external-mbufs \ --huffman-enc fixed @@ -166,7 +190,7 @@ Test Case: Compressdev QAT PMD external mbufs dynamic function test -------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --external-mbufs \ --huffman-enc dynamic @@ -179,7 +203,7 @@ Test Case: Compressdev QAT PMD im buffer split op fixed function test ------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --seg-sz segsize \ --max-num-sgl-segs seg --extended-input-sz size \ @@ -193,7 +217,7 @@ Test Case: Compressdev QAT PMD im buffer split op dynamic function test -------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --seg-sz segsize \ --max-num-sgl-segs seg --extended-input-sz size \ @@ -207,7 +231,7 @@ Test Case: Compressdev QAT PMD fixed performance test -------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --huffman-enc fixed @@ -219,7 +243,7 @@ Test Case: Compressdev QAT PMD dynamic performance test --------------------------------------------------------------------------- Run Compressdev qat pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ + ./x86_64-native-linuxapp-gcc/app/dpdk-test-compress-perf -a qat_device_bus_id -l 4 \ -- --driver-name compress_qat --input-file file_name \ --compress-level level --num-iter number --huffman-enc dynamic diff --git a/test_plans/compressdev_zlib_pmd_test_plan.rst b/test_plans/compressdev_zlib_pmd_test_plan.rst index f42ef32..5d20dc6 100644 --- a/test_plans/compressdev_zlib_pmd_test_plan.rst +++ b/test_plans/compressdev_zlib_pmd_test_plan.rst @@ -36,6 +36,7 @@ CompressDev ZLIB PMD Tests Description ------------------- + The ZLIB PMD (librte_pmd_zlib) provides poll mode compression & decompression driver based on SW zlib library. @@ -44,6 +45,7 @@ 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 Prerequisites ---------------------- @@ -56,15 +58,39 @@ and enable compressdev unit test: Set CONFIG_RTE_COMPRESSDEV_TEST=y in config/common_base. 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. +Software +-------- + +dpdk: http://dpdk.org/git/dpdk +ZLIB library: zlib sources from http://zlib.net/ + +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 + +Test case +========= + Test Case: Compressdev ZLIB PMD Unit test ---------------------------------------------------------------- Start test application and run zlib pmd unit test:: - ./app/test -l1 -n1 -a vdev_bus_id --vdev=compress_zlib + ./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. @@ -73,7 +99,7 @@ Test Case: Compressdev ZLIB PMD fixed function test ------------------------------------------------------------- Run Compressdev zlib pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./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 @@ -85,7 +111,7 @@ Test Case: Compressdev ZLIB PMD dynamic function test ------------------------------------------------------------- Run Compressdev zlib pmd test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./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 @@ -97,7 +123,7 @@ Test Case: Compressdev ZLIB PMD fixed performance test ---------------------------------------------------------------------------- Run Compressdev zlib pmd performance test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./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 @@ -109,7 +135,7 @@ Test Case: Compressdev ZLIB PMD dynamic performance test --------------------------------------------------------------------------- Run Compressdev zlib pmd performance test with below sample commands:: - ./app/dpdk-test-compress-perf -a vdev_bus_id -l 4 \ + ./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 -- 2.7.4