X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fcryptodevs%2Farmv8.rst;h=f0f30fe0003a818685ab669619c68a7fe2767e07;hb=5a3cca342417f7d4be4ac4b6225ca509617777c4;hp=de63793f7132171bdcda045196362f817b4e9286;hpb=54c7fdba7c9af89c83a0573976c544ad6be0a82d;p=dpdk.git diff --git a/doc/guides/cryptodevs/armv8.rst b/doc/guides/cryptodevs/armv8.rst index de63793f71..f0f30fe000 100644 --- a/doc/guides/cryptodevs/armv8.rst +++ b/doc/guides/cryptodevs/armv8.rst @@ -1,32 +1,5 @@ -.. BSD LICENSE - Copyright (C) Cavium networks Ltd. 2017. - - 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 Cavium networks 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. - +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2017 Cavium, Inc ARMv8 Crypto Poll Mode Driver ============================= @@ -53,23 +26,23 @@ Supported authentication algorithms: Installation ------------ -In order to enable this virtual crypto PMD, user must: - -* Download ARMv8 crypto library source code from - `here `_ +To build DPDK with this virtual crypto PMD, the user is required to: -* Export the environmental variable ARMV8_CRYPTO_LIB_PATH with - the path where the ``armv8_crypto`` library was downloaded - or cloned. +* Download AArch64 crypto library source code from + `here `_. -* Build the library by invoking: +* Build the ``AArch64cryptolib`` library: .. code-block:: console - make -C $ARMV8_CRYPTO_LIB_PATH/ + make + +* Build DPDK with meson option ``-Darmv8_crypto_dir=``: -* Set CONFIG_RTE_LIBRTE_PMD_ARMV8_CRYPTO=y in - config/defconfig_arm64-armv8a-linuxapp-gcc +.. code-block:: console + + meson -Darmv8_crypto_dir= build + ninja -C build The corresponding device can be created only if the following features are supported by the CPU: @@ -82,11 +55,12 @@ are supported by the CPU: Initialization -------------- +Use ``--vdev "crypto_armv8"`` in the EAL options to create virtual crypto device. + User can use app/test application to check how to use this PMD and to verify crypto processing. Test name is cryptodev_sw_armv8_autotest. -For performance test cryptodev_sw_armv8_perftest can be used. Limitations -----------