From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by dpdk.org (Postfix) with ESMTP id A5A7C2BD5 for ; Thu, 7 Mar 2019 11:09:12 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 Mar 2019 02:09:11 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.58,451,1544515200"; d="scan'208";a="123417377" Received: from fmsmsx103.amr.corp.intel.com ([10.18.124.201]) by orsmga008.jf.intel.com with ESMTP; 07 Mar 2019 02:09:11 -0800 Received: from fmsmsx161.amr.corp.intel.com (10.18.125.9) by FMSMSX103.amr.corp.intel.com (10.18.124.201) with Microsoft SMTP Server (TLS) id 14.3.408.0; Thu, 7 Mar 2019 02:09:11 -0800 Received: from shsmsx103.ccr.corp.intel.com (10.239.4.69) by FMSMSX161.amr.corp.intel.com (10.18.125.9) with Microsoft SMTP Server (TLS) id 14.3.408.0; Thu, 7 Mar 2019 02:09:09 -0800 Received: from shsmsx101.ccr.corp.intel.com ([169.254.1.158]) by SHSMSX103.ccr.corp.intel.com ([169.254.4.134]) with mapi id 14.03.0415.000; Thu, 7 Mar 2019 18:09:08 +0800 From: "Tu, Lijuan" To: "Zhao, XinfengX" , "dts@dpdk.org" CC: "Zhao, XinfengX" Thread-Topic: [dts] [PATCH] test_plan: modify the cryptodev perf test plan Thread-Index: AQHU0y6TnQOLhhl9IUCLodQWSTSCVaX/9TMQ Date: Thu, 7 Mar 2019 10:09:07 +0000 Message-ID: <8CE3E05A3F976642AAB0F4675D0AD20E0BA3F655@SHSMSX101.ccr.corp.intel.com> References: <1551744911-314990-1-git-send-email-xinfengx.zhao@intel.com> In-Reply-To: <1551744911-314990-1-git-send-email-xinfengx.zhao@intel.com> Accept-Language: zh-CN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.0.400.15 dlp-reaction: no-action x-ctpclassification: CTP_NT x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMmIyZWNmYzAtN2E2YS00ZjBmLThlZTItNjI4NTkyZGEzOTc0IiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiY3lTMWJDZVlzajN4bjVvd0J2aWRrR2ZiSXplNjREUGh1dk1aK1BxV1NnWlE4TkZmZTZLeHNZaTE0cmkxOGg5RCJ9 x-originating-ip: [10.239.127.40] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dts] [PATCH] test_plan: modify the cryptodev perf test plan X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Mar 2019 10:09:13 -0000 Applied, thanks > -----Original Message----- > From: dts [mailto:dts-bounces@dpdk.org] On Behalf Of Xinfeng Zhao > Sent: Tuesday, March 5, 2019 8:15 AM > To: dts@dpdk.org > Cc: Zhao, XinfengX > Subject: [dts] [PATCH] test_plan: modify the cryptodev perf test plan >=20 > 1. rename test plan for reviewer requirement > 2. add openssl algorithm >=20 > Signed-off-by: Xinfeng Zhao > --- > .../crypto_perf_cryptodev_perf_test_plan.rst | 313 > +++++++++++++++++++++ > .../cryptodev_perf_crypto-perf_test_plan.rst | 286 ---------------= ---- > 2 files changed, 313 insertions(+), 286 deletions(-) > create mode 100644 test_plans/crypto_perf_cryptodev_perf_test_plan.rst > delete mode 100644 test_plans/cryptodev_perf_crypto-perf_test_plan.rst >=20 > diff --git a/test_plans/crypto_perf_cryptodev_perf_test_plan.rst > b/test_plans/crypto_perf_cryptodev_perf_test_plan.rst > new file mode 100644 > index 0000000..00b4cd7 > --- /dev/null > +++ b/test_plans/crypto_perf_cryptodev_perf_test_plan.rst > @@ -0,0 +1,313 @@ > +.. Copyright (c) <2016-2017> Intel Corporation > + All rights reserved. > + > + Redistribution and use in source and binary forms, with or without > + modification, are permitted provided that the following conditions > + are met: > + > + - Redistributions of source code must retain the above copyright > + notice, this list of conditions and the following disclaimer. > + > + - Redistributions in binary form must reproduce the above copyright > + notice, this list of conditions and the following disclaimer in > + the documentation and/or other materials provided with the > + distribution. > + > + - Neither the name of Intel Corporation nor the names of its > + contributors may be used to endorse or promote products derived > + from this software without specific prior written permission. > + > + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND > CONTRIBUTORS > + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT > + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS > + FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE > + COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, > INDIRECT, > + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES > + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS > OR > + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) > + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN > CONTRACT, > + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) > + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED > + OF THE POSSIBILITY OF SUCH DAMAGE. > + > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Cryptodev Performance Application Tests > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > + > +Description > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +This document provides the test plan for testing Cryptodev performance b= y > +crypto perf application. The crypto perf application is a DPDK app under > +DPDK app folder. > + > +Crypto perf application supports most of Cryptodev PMDs (polling mode dr= iver) > +Intel QuickAssist Technology DH895xxC/DH_C62xx hardware > +accelerator (QAT PMD), AESNI MB PMD, AESNI GCM PMD, KASUMI PMD, > +SNOW3G PMD or ZUC PMD. > + > +AESNI MB PMD algorithm table > +The table below contains AESNI MB algorithms which supported in crypto p= erf. > +Part of the algorithms are not supported currently. > + > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| Algorithm | Mode | Detail = | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| aes | cbc | Encrypt/Decrypt;Key size: 128, 192, 25= 6 bits > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| aes | ctr | Encrypt/Decrypt;Key size: 128, 192, 25= 6 bits > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| sha | | sha1, sha2-224, sha2-384, sha2-256, sh= a2-512 > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| hmac | | Support md5 and sha implementations sh= a1, sha2-224, > sha2-256, | > +| | | = | > +| | | sha2-384, sha2-512 = | > +| | | = | > +| | | Key Size versus Block size support: Ke= y Size must be <=3D > block size; | > +| | | = | > +| | | Mac Len Supported sha1 10, 12, 16, 20 = bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-256 16, 24, 32 = bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-384 24,32, 40, = 48 bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-512 32, 40, 48,= 56, 64 bytes; > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > + > +QAT algorithm table: > +The table below contains QAT Algorithms which supported in crypto perf. > +Part of the algorithms are not supported currently. > + > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +|Algorithm| Mode | Detail = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| aes | cbc | Encrypt/Decrypt;Key size: 128, 192, 256= bits > | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| aes | ctr | Encrypt/Decrypt;Key size: 128, 192, 256= bits > | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| 3des | cbc | Encrypt/Decrypt;Key size: 128, 192 bits > | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| 3des | ctr | Encrypt/Decrypt;Key size: 128, 192 bits > | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| sha | | sha1, sha2-224, sha2-256, sha2-384, sha= 2-512 > | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| hmac | | Support md5 and sha implementations sha= 1, sha2-224, > sha2-256, | > +| | | = | > +| | | sha2-384, sha2-512 = | > +| | | = | > +| | | Key Size versus Block size support: Key= Size must be <=3D > block size; | > +| | | = | > +| | | Mac Len Supported sha1 10, 12, 16, 20 b= ytes; > | > +| | | = | > +| | | Mac Len Supported sha2-256 16, 24, 32 b= ytes; > | > +| | | = | > +| | | Mac Len Supported sha2-384 24,32, 40, 4= 8 bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-512 32, 40, 48, = 56, 64 bytes; > | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| aes | gcm | Key Sizes:128, 192, 256 bits; = | > +| | | = | > +| | | Associated Data Length: 0 ~ 240 bytes; = | > +| | | = | > +| | | Payload Length: 0 ~ (2^32 -1) bytes; = | > +| | | = | > +| | | IV source: external; = | > +| | | = | > +| | | IV Lengths: 96 bits; = | > +| | | = | > +| | | Tag Lengths: 8, 12, 16 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| kasumi | f8 | Encrypt/Decrypt; Key size: 128 = | > ++ +-------------------+-----------------------------------------= -------------------------- > --------+ > +| | f9 | Generate/Verify; Key size: 128 = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| snow3g | uea2 | Encrypt/Decrypt; Key size: 128 > | > ++ +-------------------+-----------------------------------------= -------------------------- > --------+ > +| | uia2 | Generate/Verify; Key size: 128 = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > + > +AESNI_GCM algorithm table > +The table below contains AESNI GCM PMD algorithms which are supported > +in crypto perf > + > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +|Algorithm| Mode | Detail = | > +| | = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| aes | gcm | Encrypt/Decrypt;Key Sizes:128, 256 bits= ; > | > +| | | = | > +| | | IV source: external; = | > +| | | = | > +| | | IV Lengths: 96 bits; = | > +| | | = | > +| | | Generate/Verify;Key Sizes:128,192,256 b= its; > | > +| | | = | > +| | | Associated Data Length: 0 ~ 240 bytes; = | > +| | | = | > +| | | Payload Length: 0 ~ (2^32 -1) bytes; = | > +| | | = | > +| | | Tag Lengths: 8, 12, 16 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| aes | gmac | Generate/Verify;Key Sizes:128,192,256 b= its; > | > +| | | = | > +| | | Associated Data Length: 0 ~ 240 bytes; = | > +| | | = | > +| | | Payload Length: 0 ~ (2^32 -1) bytes; = | > +| | | = | > +| | | Tag Lengths: 8, 12, 16 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > + > +OPENSSL algorithm table > +The table below contains OPENSSL algorithms which are supported in crypt= o > perf. > + > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| Algorithm | Mode | Detail = | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| aes | cbc | Encrypt/Decrypt;Key size: 128, 192, 25= 6 bits > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| aes | ctr | Encrypt/Decrypt;Key size: 128, 192, 25= 6 bits > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| sha | | sha1, sha2-224, sha2-384, sha2-256, sh= a2-512 > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > +| hmac | | Support md5 and sha implementations sh= a1, sha2-224, > sha2-256, | > +| | | = | > +| | | sha2-384, sha2-512 = | > +| | | = | > +| | | Key Size versus Block size support: Ke= y Size must be <=3D > block size; | > +| | | = | > +| | | Mac Len Supported sha1 10, 12, 16, 20 = bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-256 16, 24, 32 = bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-384 24,32, 40, = 48 bytes; > | > +| | | = | > +| | | Mac Len Supported sha2-512 32, 40, 48,= 56, 64 bytes; > | > ++-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > + > +NULL algorithm table > +The table below contains NULL algorithms which are supported in crypto p= erf. > +Part of the algorithms are not supported currently. > + > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +|Algorithm| Mode | Detail = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| null | null | Encrypt/Decrypt;Key Sizes:0 bits; = | > +| | | = | > +| | | IV Lengths: 0 bits; = | > +| | | = | > +| | | Generate/Verify;Key Sizes:0 bits; = | > +| | | = | > +| | | Associated Data Length: 1 bytes; = | > +| | | = | > +| | | Payload Length: 0 bytes; = | > +| | | = | > +| | | Tag Lengths: 0 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > + > +KASUMI algorithm table > +The table below contains KASUMI algorithms which are supported in crypto > perf. > + > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +|Algorithm| Mode | Detail = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| kasumi | f8 | Encrypt/Decrypt;Key Sizes:128 bits; > | > +| | | = | > +| | | IV source: external; = | > +| | | = | > +| | | IV Lengths: 64 bits; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| kasumi | f9 | Generate/Verify;Key Sizes:128 bits; > | > +| | | = | > +| | | Payload Length: 64 bytes; = | > +| | | = | > +| | | Tag Lengths: 4 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > + > +SNOW3G algorithm table > +The table below contains SNOW3G algorithms which are supported in crypto > perf. > + > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +|Algorithm| Mode | Detail = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| snow3g | uea2 | Encrypt/Decrypt;Key Sizes:128 bits; > | > +| | | = | > +| | | IV source: external; = | > +| | | = | > +| | | IV Lengths: 128 bits; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| snow3g | uia2 | Generate/Verify;Key Sizes:128 bits; > | > +| | | = | > +| | | Payload Length: 128 bytes; = | > +| | | = | > +| | | Tag Lengths: 4 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > + > +ZUC algorithm table > +The table below contains ZUC algorithms which are supported in crypto pe= rf. > + > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +|Algorithm| Mode | Detail = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| zuc | eea3 | Encrypt/Decrypt;Key Sizes:128 bits; > | > +| | | = | > +| | | IV source: external; = | > +| | | = | > +| | | IV Lengths: 128 bits; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > +| zuc | eia2 | Generate/Verify;Key Sizes:128 bits; > | > +| | | = | > +| | | Payload Length: 128 bytes; = | > +| | | = | > +| | | Tag Lengths: 4 bytes; = | > ++---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > + > + > +Prerequisites > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +To test Cryptodev performance, an application > +test_crypto_perf is added into DPDK. > + > +The test commands of test_crypto_perf is below:: > + > + ./build/app/dpdk-test-crypto-perf -c COREMASK --vdev > (AESNI_MB|QAT|AESNI_GCM|OPENSSL|SNOW3G|KASUMI|ZUC|NULL) -w > (PCI:DEVICE:FUNCTION) -w (PCI:DEVICE:FUNCTION) -- --ptest > (throughput|latency) --devtype > (crypto_aesni_mb|crypto_qat|crypto_aes_gcm|crypto_openssl|crypto_snow3g > |crypto_kasumi|crypto_zuc|crypto_null) --optype (aead|cipher-only|auth- > only|cipher-then-auth|auth-then-cipher) --cipher-algo (ALGO) --cipher-op > (encrypt|decrypt) --cipher-key-sz (key_size) --cipher-iv-sz (iv_size) --a= uth-algo > (ALGO) --auth-op (generate|verify) --auth-key-sz (key_size) --auth-aad-sz > (aad_size) --auth-digest-sz (digest_size) --total-ops (ops_number) --burs= t-sz > (burst_size) --buffer-sz (buffer_size) > + > + > + > +Test case: Cryptodev performance test > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +common:: > + > + --vdev > (AESNI_MB|QAT|AESNI_GCM|OPENSSL|SNOW3G|KASUMI|ZUC|NULL) this > value can be set as : crypto_aesni_mb_pmd, crypto_aes_gcm_pmd, > crypto_openssl_pmd, crypto_snow3g_pmd, crypto_kasumi_pmd, > crypto_zuc_pmd or crypto_null_pmd . if pmd is QAT this parameter should = not > be set > + > + -w (PCI:DEVICE:FUNCTION) this value is the port whitelist or QAT dev= ice > whitelist . if vdev is set and devtype is not crypto_qat , the QAT devic= e whitelist > is not needed , but you also can set it on the cmd line . > + > + --optype (aead|cipher-only|auth-only|cipher-then-auth|auth-then-ciph= er): if > cipher-algo is aes-gcm or gmac this value must be set to aead . otherwise= it will > be set to others. please notice , null algorithm only support cipher-only= test. > + > +other parameters please reference above table's parameter . > + > +QAT PMD Command line Eg:: > + > + ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf -w 0000:1a= :01.0 -- > --ptest throughput --devtype crypto_qat --optype cipher-then-auth --ciph= er- > algo aes-cbc --cipher-op encrypt --cipher-key-sz 16 --cipher-iv-sz 16 --a= uth-algo > sha1-hmac --auth-op generate --auth-key-sz 64 --auth-aad-sz 0 --auth-dige= st-sz > 20 --total-ops 10000000 --burst-sz 32 --buffer-sz 1024 > + > +AESNI_MB PMD Command line Eg:: > + > + ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_aesni_mb_pmd -- --ptest throughput --devtype crypto_aesni_mb -- > optype cipher-then-auth --cipher-algo aes-cbc --cipher-op encrypt --ciph= er-key- > sz 16 --cipher-iv-sz 16 --auth-algo sha1-hmac --auth-op generate --auth-k= ey-sz > 64 --auth-aad-sz 0 --auth-digest-sz 20 --total-ops 10000000 --burst-sz 32= -- > buffer-sz 1024 > + > +AESNI_GCM PMD Command line Eg:: > + > + ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_aesni_gcm_pmd -- --ptest throughput --devtype crypto_aesni_gcm -= - > optype aead --cipher-algo aes-gcm --cipher-op encrypt --cipher-key-sz 16= -- > cipher-iv-sz 12 --auth-algo aes-gcm --auth-op generate --auth-key-sz 16 -= -auth- > aad-sz 4 --auth-digest-sz 12 --total-ops 10000000 --burst-sz 32 --buffer-= sz 1024 > + > +KASUMI PMD Command line Eg:: > + > + ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_kasumi_pmd -- --ptest throughput --devtype crypto_kasumi --optype > cipher-then-auth --cipher-algo kasumi-f8 --cipher-op encrypt --cipher-ke= y-sz 16 > --cipher-iv-sz 8 --auth-algo kasumi-f9 --auth-op generate --auth-key-sz 1= 6 -- > auth-aad-sz 8 --auth-digest-sz 4 --total-ops 10000000 --burst-sz 32 --buf= fer-sz > 1024 > + > +SNOW3G PMD Command line Eg:: > + > + ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_snow3g_pmd -- --ptest throughput --devtype crypto_snow3g --optype > cipher-then-auth --cipher-algo snow3g-uea2 --cipher-op encrypt --cipher-= key-sz > 16 --cipher-iv-sz 16 --auth-algo snow3g-uia2 --auth-op generate --auth-ke= y-sz > 16 --auth-aad-sz 16 --auth-digest-sz 4 --total-ops 10000000 --burst-sz 32= -- > buffer-sz 1024 > + > +ZUC PMD Command line Eg:: > + > + ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_zuc_pmd -- --ptest throughput --devtype crypto_zuc_mb --optype > cipher-then-auth --cipher-algo zuc-eea3 --cipher-op encrypt --cipher-key= -sz 16 - > -cipher-iv-sz 16 --auth-algo zuc-eia3 --auth-op generate --auth-key-sz 1= 6 --auth- > aad-sz 16 --auth-digest-sz 4 --total-ops 10000000 --burst-sz 32 --buffer-= sz 1024 > diff --git a/test_plans/cryptodev_perf_crypto-perf_test_plan.rst > b/test_plans/cryptodev_perf_crypto-perf_test_plan.rst > deleted file mode 100644 > index 05d0a2e..0000000 > --- a/test_plans/cryptodev_perf_crypto-perf_test_plan.rst > +++ /dev/null > @@ -1,286 +0,0 @@ > -.. Copyright (c) <2016-2017> Intel Corporation > - All rights reserved. > - > - Redistribution and use in source and binary forms, with or without > - modification, are permitted provided that the following conditions > - are met: > - > - - Redistributions of source code must retain the above copyright > - notice, this list of conditions and the following disclaimer. > - > - - Redistributions in binary form must reproduce the above copyright > - notice, this list of conditions and the following disclaimer in > - the documentation and/or other materials provided with the > - distribution. > - > - - Neither the name of Intel Corporation nor the names of its > - contributors may be used to endorse or promote products derived > - from this software without specific prior written permission. > - > - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND > CONTRIBUTORS > - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT > - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS > - FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE > - COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, > INDIRECT, > - INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES > - (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS > OR > - SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) > - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN > CONTRACT, > - STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) > - ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED > - OF THE POSSIBILITY OF SUCH DAMAGE. > - > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > -Cryptodev Performance Application Tests > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > - > - > -Description > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > - > -This document provides the test plan for testing Cryptodev performance b= y > -crypto perf application. The crypto perf application is a DPDK app under > -DPDK app folder. > - > -Crypto perf application supports most of Cryptodev PMDs (polling mode dr= iver) > -Intel QuickAssist Technology DH895xxC/DH_C62xx hardware > -accelerator (QAT PMD), AESNI MB PMD, AESNI GCM PMD, KASUMI PMD, > -SNOW3G PMD or ZUC PMD. > - > -AESNI MB PMD algorithm table > -The table below contains AESNI MB algorithms which supported in crypto p= erf. > -Part of the algorithms are not supported currently. > - > -+-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > -| Algorithm | Mode | Detail = | > -+-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > -| aes | cbc | Encrypt/Decrypt;Key size: 128, 192, 25= 6 bits > | > -+-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > -| aes | ctr | Encrypt/Decrypt;Key size: 128, 192, 25= 6 bits > | > -+-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > -| sha | | sha1, sha2-224, sha2-384, sha2-256, sh= a2-512 > | > -+-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > -| hmac | | Support md5 and sha implementations sh= a1, sha2-224, > sha2-256, | > -| | | = | > -| | | sha2-384, sha2-512 = | > -| | | = | > -| | | Key Size versus Block size support: Ke= y Size must be <=3D > block size; | > -| | | = | > -| | | Mac Len Supported sha1 10, 12, 16, 20 = bytes; > | > -| | | = | > -| | | Mac Len Supported sha2-256 16, 24, 32 = bytes; > | > -| | | = | > -| | | Mac Len Supported sha2-384 24,32, 40, = 48 bytes; > | > -| | | = | > -| | | Mac Len Supported sha2-512 32, 40, 48,= 56, 64 bytes; > | > -+-----------+-------------------+---------------------------------------= ----------------------- > -------------+ > - > -QAT algorithm table: > -The table below contains QAT Algorithms which supported in crypto perf. > -Part of the algorithms are not supported currently. > - > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -|Algorithm| Mode | Detail = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| aes | cbc | Encrypt/Decrypt;Key size: 128, 192, 256= bits > | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| aes | ctr | Encrypt/Decrypt;Key size: 128, 192, 256= bits > | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| 3des | cbc | Encrypt/Decrypt;Key size: 128, 192 bits > | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| 3des | ctr | Encrypt/Decrypt;Key size: 128, 192 bits > | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| sha | | sha1, sha2-224, sha2-256, sha2-384, sha= 2-512 > | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| hmac | | Support md5 and sha implementations sha= 1, sha2-224, > sha2-256, | > -| | | = | > -| | | sha2-384, sha2-512 = | > -| | | = | > -| | | Key Size versus Block size support: Key= Size must be <=3D block > size; | > -| | | = | > -| | | Mac Len Supported sha1 10, 12, 16, 20 b= ytes; > | > -| | | = | > -| | | Mac Len Supported sha2-256 16, 24, 32 b= ytes; > | > -| | | = | > -| | | Mac Len Supported sha2-384 24,32, 40, 4= 8 bytes; > | > -| | | = | > -| | | Mac Len Supported sha2-512 32, 40, 48, = 56, 64 bytes; > | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| aes | gcm | Key Sizes:128, 192, 256 bits; = | > -| | | = | > -| | | Associated Data Length: 0 ~ 240 bytes; = | > -| | | = | > -| | | Payload Length: 0 ~ (2^32 -1) bytes; = | > -| | | = | > -| | | IV source: external; = | > -| | | = | > -| | | IV Lengths: 96 bits; = | > -| | | = | > -| | | Tag Lengths: 8, 12, 16 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| kasumi | f8 | Encrypt/Decrypt; Key size: 128 = | > -+ +-------------------+-----------------------------------------= -------------------------- > --------+ > -| | f9 | Generate/Verify; Key size: 128 = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| snow3g | uea2 | Encrypt/Decrypt; Key size: 128 > | > -+ +-------------------+-----------------------------------------= -------------------------- > --------+ > -| | uia2 | Generate/Verify; Key size: 128 = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > - > -AESNI_GCM algorithm table > -The table below contains AESNI GCM PMD algorithms which are supported > -in crypto perf > - > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -|Algorithm| Mode | Detail = | > -| | = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| aes | gcm | Encrypt/Decrypt;Key Sizes:128, 256 bits= ; > | > -| | | = | > -| | | IV source: external; = | > -| | | = | > -| | | IV Lengths: 96 bits; = | > -| | | = | > -| | | Generate/Verify;Key Sizes:128,192,256 b= its; > | > -| | | = | > -| | | Associated Data Length: 0 ~ 240 bytes; = | > -| | | = | > -| | | Payload Length: 0 ~ (2^32 -1) bytes; = | > -| | | = | > -| | | Tag Lengths: 8, 12, 16 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| aes | gmac | Generate/Verify;Key Sizes:128,192,256 b= its; > | > -| | | = | > -| | | Associated Data Length: 0 ~ 240 bytes; = | > -| | | = | > -| | | Payload Length: 0 ~ (2^32 -1) bytes; = | > -| | | = | > -| | | Tag Lengths: 8, 12, 16 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > - > -NULL algorithm table > -The table below contains NULL algorithms which are supported in crypto p= erf. > -Part of the algorithms are not supported currently. > - > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -|Algorithm| Mode | Detail = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| null | null | Encrypt/Decrypt;Key Sizes:0 bits; = | > -| | | = | > -| | | IV Lengths: 0 bits; = | > -| | | = | > -| | | Generate/Verify;Key Sizes:0 bits; = | > -| | | = | > -| | | Associated Data Length: 1 bytes; = | > -| | | = | > -| | | Payload Length: 0 bytes; = | > -| | | = | > -| | | Tag Lengths: 0 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > - > -KASUMI algorithm table > -The table below contains KASUMI algorithms which are supported in crypto > perf. > - > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -|Algorithm| Mode | Detail = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| kasumi | f8 | Encrypt/Decrypt;Key Sizes:128 bits; > | > -| | | = | > -| | | IV source: external; = | > -| | | = | > -| | | IV Lengths: 64 bits; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| kasumi | f9 | Generate/Verify;Key Sizes:128 bits; > | > -| | | = | > -| | | Payload Length: 64 bytes; = | > -| | | = | > -| | | Tag Lengths: 4 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > - > -SNOW3G algorithm table > -The table below contains SNOW3G algorithms which are supported in crypto > perf. > - > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -|Algorithm| Mode | Detail = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| snow3g | uea2 | Encrypt/Decrypt;Key Sizes:128 bits; > | > -| | | = | > -| | | IV source: external; = | > -| | | = | > -| | | IV Lengths: 128 bits; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| snow3g | uia2 | Generate/Verify;Key Sizes:128 bits; > | > -| | | = | > -| | | Payload Length: 128 bytes; = | > -| | | = | > -| | | Tag Lengths: 4 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > - > -ZUC algorithm table > -The table below contains ZUC algorithms which are supported in crypto pe= rf. > - > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -|Algorithm| Mode | Detail = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| zuc | eea3 | Encrypt/Decrypt;Key Sizes:128 bits; > | > -| | | = | > -| | | IV source: external; = | > -| | | = | > -| | | IV Lengths: 128 bits; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > -| zuc | eia2 | Generate/Verify;Key Sizes:128 bits; > | > -| | | = | > -| | | Payload Length: 128 bytes; = | > -| | | = | > -| | | Tag Lengths: 4 bytes; = | > -+---------+-------------------+-----------------------------------------= ----------------------- > -----------+ > - > - > -Prerequisites > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > - > -To test Cryptodev performance, an application > -test_crypto_perf is added into DPDK. > - > -The test commands of test_crypto_perf is below:: > - > - ./build/app/dpdk-test-crypto-perf -c COREMASK --vdev > (AESNI_MB|QAT|AESNI_GCM|OPENSSL|SNOW3G|KASUMI|ZUC|NULL) -w > (PCI:DEVICE:FUNCTION) -w (PCI:DEVICE:FUNCTION) -- --ptest > (throughput|latency) --devtype > (crypto_aesni_mb|crypto_qat|crypto_aes_gcm|crypto_openssl|crypto_snow3g > |crypto_kasumi|crypto_zuc|crypto_null) --optype (aead|cipher-only|auth- > only|cipher-then-auth|auth-then-cipher) --cipher-algo (ALGO) --cipher-op > (encrypt|decrypt) --cipher-key-sz (key_size) --cipher-iv-sz (iv_size) --a= uth-algo > (ALGO) --auth-op (generate|verify) --auth-key-sz (key_size) --auth-aad-sz > (aad_size) --auth-digest-sz (digest_size) --total-ops (ops_number) --burs= t-sz > (burst_size) --buffer-sz (buffer_size) > - > - > - > -Test case: Cryptodev performance test > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > - > -common:: > - > - --vdev > (AESNI_MB|QAT|AESNI_GCM|OPENSSL|SNOW3G|KASUMI|ZUC|NULL) this > value can be set as : crypto_aesni_mb_pmd, crypto_aes_gcm_pmd, > crypto_openssl_pmd, crypto_snow3g_pmd, crypto_kasumi_pmd, > crypto_zuc_pmd or crypto_null_pmd . if pmd is QAT this parameter should = not > be set > - > - -w (PCI:DEVICE:FUNCTION) this value is the port whitelist or QAT dev= ice > whitelist . if vdev is set and devtype is not crypto_qat , the QAT devic= e whitelist > is not needed , but you also can set it on the cmd line . > - > - --optype (aead|cipher-only|auth-only|cipher-then-auth|auth-then-ciph= er): if > cipher-algo is aes-gcm or gmac this value must be set to aead . otherwise= it will > be set to others. please notice , null algorithm only support cipher-only= test. > - > -other parameters please reference above table's parameter . > - > -QAT PMD Command line Eg:: > - > - ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf -w 0000:1a= :01.0 -- - > -ptest throughput --devtype crypto_qat --optype cipher-then-auth --ciphe= r-algo > aes-cbc --cipher-op encrypt --cipher-key-sz 16 --cipher-iv-sz 16 --auth-a= lgo sha1- > hmac --auth-op generate --auth-key-sz 64 --auth-aad-sz 0 --auth-digest-sz= 20 -- > total-ops 10000000 --burst-sz 32 --buffer-sz 1024 > - > -AESNI_MB PMD Command line Eg:: > - > - ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_aesni_mb_pmd -- --ptest throughput --devtype crypto_aesni_mb -- > optype cipher-then-auth --cipher-algo aes-cbc --cipher-op encrypt --ciph= er-key- > sz 16 --cipher-iv-sz 16 --auth-algo sha1-hmac --auth-op generate --auth-k= ey-sz > 64 --auth-aad-sz 0 --auth-digest-sz 20 --total-ops 10000000 --burst-sz 32= -- > buffer-sz 1024 > - > -AESNI_GCM PMD Command line Eg:: > - > - ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_aesni_gcm_pmd -- --ptest throughput --devtype crypto_aesni_gcm -= - > optype aead --cipher-algo aes-gcm --cipher-op encrypt --cipher-key-sz 16= -- > cipher-iv-sz 12 --auth-algo aes-gcm --auth-op generate --auth-key-sz 16 -= -auth- > aad-sz 4 --auth-digest-sz 12 --total-ops 10000000 --burst-sz 32 --buffer-= sz 1024 > - > -KASUMI PMD Command line Eg:: > - > - ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_kasumi_pmd -- --ptest throughput --devtype crypto_kasumi --optype > cipher-then-auth --cipher-algo kasumi-f8 --cipher-op encrypt --cipher-ke= y-sz 16 > --cipher-iv-sz 8 --auth-algo kasumi-f9 --auth-op generate --auth-key-sz 1= 6 -- > auth-aad-sz 8 --auth-digest-sz 4 --total-ops 10000000 --burst-sz 32 --buf= fer-sz > 1024 > - > -SNOW3G PMD Command line Eg:: > - > - ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_snow3g_pmd -- --ptest throughput --devtype crypto_snow3g --optype > cipher-then-auth --cipher-algo snow3g-uea2 --cipher-op encrypt --cipher-= key-sz > 16 --cipher-iv-sz 16 --auth-algo snow3g-uia2 --auth-op generate --auth-ke= y-sz > 16 --auth-aad-sz 16 --auth-digest-sz 4 --total-ops 10000000 --burst-sz 32= -- > buffer-sz 1024 > - > -ZUC PMD Command line Eg:: > - > - ./build/app/test-crypto-perf/dpdk-test-crypto-perf -c 0xf --vdev > crypto_zuc_pmd -- --ptest throughput --devtype crypto_zuc_mb --optype > cipher-then-auth --cipher-algo zuc-eea3 --cipher-op encrypt --cipher-key= -sz 16 - > -cipher-iv-sz 16 --auth-algo zuc-eia3 --auth-op generate --auth-key-sz 1= 6 --auth- > aad-sz 16 --auth-digest-sz 4 --total-ops 10000000 --burst-sz 32 --buffer-= sz 1024 > -- > 2.7.4