xref: /dpdk/doc/guides/cryptodevs/nitrox.rst (revision ea0e711b8ae02a7bc95de732f6e64781df74b2ca)
1..  SPDX-License-Identifier: BSD-3-Clause
2    Copyright(C) 2019 Marvell International Ltd.
3
4Marvell NITROX Crypto Poll Mode Driver
5======================================
6
7The Nitrox crypto poll mode driver provides support for offloading
8cryptographic operations to the NITROX V security processor. Detailed
9information about the NITROX V security processor can be obtained here:
10
11* https://www.marvell.com/security-solutions/nitrox-security-processors/nitrox-v/
12
13Features
14--------
15
16Nitrox crypto PMD has support for:
17
18Cipher algorithms:
19
20* ``RTE_CRYPTO_CIPHER_AES_CBC``
21* ``RTE_CRYPTO_CIPHER_3DES_CBC``
22
23Hash algorithms:
24
25* ``RTE_CRYPTO_AUTH_SHA1_HMAC``
26* ``RTE_CRYPTO_AUTH_SHA224_HMAC``
27* ``RTE_CRYPTO_AUTH_SHA256_HMAC``
28
29Supported AEAD algorithms:
30
31* ``RTE_CRYPTO_AEAD_AES_GCM``
32
33Limitations
34-----------
35
36* Session-less APIs are not supported.
37
38Installation
39------------
40
41For compiling the Nitrox crypto PMD, please check if the
42CONFIG_RTE_LIBRTE_PMD_NITROX setting is set to `y` in config/common_base file.
43
44* ``CONFIG_RTE_LIBRTE_PMD_NITROX=y``
45
46Initialization
47--------------
48
49Nitrox crypto PMD depend on Nitrox kernel PF driver being installed on the
50platform. Nitrox PF driver is required to create VF devices which will
51be used by the PMD. Each VF device can enable one cryptodev PMD.
52
53Nitrox kernel PF driver is available as part of CNN55XX-Driver SDK. The SDK
54and it's installation instructions can be obtained from:
55`Marvell Technical Documentation Portal <https://support.cavium.com/>`_.
56