1.. SPDX-License-Identifier: BSD-3-Clause 2 Copyright(c) 2017 Cavium, Inc 3 4ARMv8 Crypto Poll Mode Driver 5============================= 6 7This code provides the initial implementation of the ARMv8 crypto PMD. 8The driver uses ARMv8 cryptographic extensions to process chained crypto 9operations in an optimized way. The core functionality is provided by 10a low-level library, written in the assembly code. 11 12Features 13-------- 14 15ARMv8 Crypto PMD has support for the following algorithm pairs: 16 17Supported cipher algorithms: 18 19* ``RTE_CRYPTO_CIPHER_AES_CBC`` 20 21Supported authentication algorithms: 22 23* ``RTE_CRYPTO_AUTH_SHA1_HMAC`` 24* ``RTE_CRYPTO_AUTH_SHA256_HMAC`` 25 26Installation 27------------ 28 29To build DPDK with this virtual crypto PMD, the user is required to: 30 31* Download AArch64 crypto library source code from 32 `here <https://github.com/ARM-software/AArch64cryptolib>`_. 33 34* Build the ``AArch64cryptolib`` library: 35 36.. code-block:: console 37 38 make 39 40* Build DPDK with meson option ``-Darmv8_crypto_dir=<path_to_AArch64cryptolib>``: 41 42.. code-block:: console 43 44 meson -Darmv8_crypto_dir=<path_to_AArch64cryptolib> build 45 ninja -C build 46 47The corresponding device can be created only if the following features 48are supported by the CPU: 49 50* ``RTE_CPUFLAG_AES`` 51* ``RTE_CPUFLAG_SHA1`` 52* ``RTE_CPUFLAG_SHA2`` 53* ``RTE_CPUFLAG_NEON`` 54 55Initialization 56-------------- 57 58Use ``--vdev "crypto_armv8"`` in the EAL options to create virtual crypto device. 59 60User can use app/test application to check how to use this PMD and to verify 61crypto processing. 62 63Test name is cryptodev_sw_armv8_autotest. 64 65Limitations 66----------- 67 68* Maximum number of sessions is 2048. 69* Only chained operations are supported. 70* AES-128-CBC is the only supported cipher variant. 71* Cipher input data has to be a multiple of 16 bytes. 72* Digest input data has to be a multiple of 8 bytes. 73