xref: /dpdk/doc/guides/cryptodevs/nitrox.rst (revision 93ba4a6e17d48ba573bbf7d7dec542a1e8d09301)
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* AES_CBC Cipher Only combination is not supported.
37* 3DES Cipher Only combination is not supported.
38* Session-less APIs are not supported.
39
40Installation
41------------
42
43For compiling the Nitrox crypto PMD, please check if the
44CONFIG_RTE_LIBRTE_PMD_NITROX setting is set to `y` in config/common_base file.
45
46* ``CONFIG_RTE_LIBRTE_PMD_NITROX=y``
47
48Initialization
49--------------
50
51Nitrox crypto PMD depend on Nitrox kernel PF driver being installed on the
52platform. Nitrox PF driver is required to create VF devices which will
53be used by the PMD. Each VF device can enable one cryptodev PMD.
54
55Nitrox kernel PF driver is available as part of CNN55XX-Driver SDK. The SDK
56and it's installation instructions can be obtained from:
57`Marvell Technical Documentation Portal <https://support.cavium.com/>`_.
58