The MVSAM CRYPTO PMD (librte_crypto_mvsam_pmd) provides poll mode crypto driver support by utilizing MUSDK library, which provides cryptographic operations acceleration by using Security Acceleration Engine (EIP197) directly from user-space with minimum overhead and high performance.
Detailed information about SoCs that use MVSAM crypto driver can be obtained here:
MVSAM CRYPTO PMD has support for:
Cipher algorithms:
Hash algorithms:
AEAD algorithms:
For supported feature flags please consult Crypto Device Supported Functionality Matrices.
MVSAM CRYPTO PMD driver compilation is disabled by default due to external dependencies. Currently there are two driver specific compilation options in config/common_base available:
CONFIG_RTE_LIBRTE_PMD_MVSAM_CRYPTO (default: n)
Toggle compilation of the librte_pmd_mvsam driver.
MVSAM CRYPTO PMD requires MUSDK built with EIP197 support thus following extra option must be passed to the library configuration script:
--enable-sam [--enable-sam-statistics] [--enable-sam-debug]
For instructions how to build required kernel modules please refer to doc/musdk_get_started.txt.
After successfully building MVSAM CRYPTO PMD, the following modules need to be loaded:
insmod musdk_cma.ko
insmod crypto_safexcel.ko rings=0,0
insmod mv_sam_uio.ko
The following parameters (all optional) are exported by the driver:
l2fwd-crypto example application can be used to verify MVSAM CRYPTO PMD operation:
./l2fwd-crypto --vdev=eth_mvpp2,iface=eth0 --vdev=crypto_mvsam -- \
--cipher_op ENCRYPT --cipher_algo aes-cbc \
--cipher_key 00:01:02:03:04:05:06:07:08:09:0a:0b:0c:0d:0e:0f \
--auth_op GENERATE --auth_algo sha1-hmac \
--auth_key 10:11:12:13:14:15:16:17:18:19:1a:1b:1c:1d:1e:1f