1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2015-2017 Intel Corporation
15 #include <netinet/in.h>
17 #include <rte_byteorder.h>
19 #include <rte_debug.h>
21 #include <rte_interrupts.h>
22 #include <rte_memory.h>
23 #include <rte_memcpy.h>
24 #include <rte_memzone.h>
25 #include <rte_launch.h>
26 #include <rte_tailq.h>
28 #include <rte_per_lcore.h>
29 #include <rte_lcore.h>
30 #include <rte_atomic.h>
31 #include <rte_branch_prediction.h>
32 #include <rte_common.h>
33 #include <rte_mempool.h>
34 #include <rte_malloc.h>
36 #include <rte_errno.h>
37 #include <rte_spinlock.h>
38 #include <rte_string_fns.h>
40 #include "rte_crypto.h"
41 #include "rte_cryptodev.h"
42 #include "rte_cryptodev_pmd.h"
44 static uint8_t nb_drivers;
46 struct rte_cryptodev rte_crypto_devices[RTE_CRYPTO_MAX_DEVS];
48 struct rte_cryptodev *rte_cryptodevs = &rte_crypto_devices[0];
50 static struct rte_cryptodev_global cryptodev_globals = {
51 .devs = &rte_crypto_devices[0],
54 .max_devs = RTE_CRYPTO_MAX_DEVS
57 struct rte_cryptodev_global *rte_cryptodev_globals = &cryptodev_globals;
59 /* spinlock for crypto device callbacks */
60 static rte_spinlock_t rte_cryptodev_cb_lock = RTE_SPINLOCK_INITIALIZER;
64 * The user application callback description.
66 * It contains callback address to be registered by user application,
67 * the pointer to the parameters for callback, and the event type.
69 struct rte_cryptodev_callback {
70 TAILQ_ENTRY(rte_cryptodev_callback) next; /**< Callbacks list */
71 rte_cryptodev_cb_fn cb_fn; /**< Callback address */
72 void *cb_arg; /**< Parameter for callback */
73 enum rte_cryptodev_event_type event; /**< Interrupt event type */
74 uint32_t active; /**< Callback is executing */
78 * The crypto cipher algorithm strings identifiers.
79 * It could be used in application command line.
82 rte_crypto_cipher_algorithm_strings[] = {
83 [RTE_CRYPTO_CIPHER_3DES_CBC] = "3des-cbc",
84 [RTE_CRYPTO_CIPHER_3DES_ECB] = "3des-ecb",
85 [RTE_CRYPTO_CIPHER_3DES_CTR] = "3des-ctr",
87 [RTE_CRYPTO_CIPHER_AES_CBC] = "aes-cbc",
88 [RTE_CRYPTO_CIPHER_AES_CTR] = "aes-ctr",
89 [RTE_CRYPTO_CIPHER_AES_DOCSISBPI] = "aes-docsisbpi",
90 [RTE_CRYPTO_CIPHER_AES_ECB] = "aes-ecb",
91 [RTE_CRYPTO_CIPHER_AES_F8] = "aes-f8",
92 [RTE_CRYPTO_CIPHER_AES_XTS] = "aes-xts",
94 [RTE_CRYPTO_CIPHER_ARC4] = "arc4",
96 [RTE_CRYPTO_CIPHER_DES_CBC] = "des-cbc",
97 [RTE_CRYPTO_CIPHER_DES_DOCSISBPI] = "des-docsisbpi",
99 [RTE_CRYPTO_CIPHER_NULL] = "null",
101 [RTE_CRYPTO_CIPHER_KASUMI_F8] = "kasumi-f8",
102 [RTE_CRYPTO_CIPHER_SNOW3G_UEA2] = "snow3g-uea2",
103 [RTE_CRYPTO_CIPHER_ZUC_EEA3] = "zuc-eea3"
107 * The crypto cipher operation strings identifiers.
108 * It could be used in application command line.
111 rte_crypto_cipher_operation_strings[] = {
112 [RTE_CRYPTO_CIPHER_OP_ENCRYPT] = "encrypt",
113 [RTE_CRYPTO_CIPHER_OP_DECRYPT] = "decrypt"
117 * The crypto auth algorithm strings identifiers.
118 * It could be used in application command line.
121 rte_crypto_auth_algorithm_strings[] = {
122 [RTE_CRYPTO_AUTH_AES_CBC_MAC] = "aes-cbc-mac",
123 [RTE_CRYPTO_AUTH_AES_CMAC] = "aes-cmac",
124 [RTE_CRYPTO_AUTH_AES_GMAC] = "aes-gmac",
125 [RTE_CRYPTO_AUTH_AES_XCBC_MAC] = "aes-xcbc-mac",
127 [RTE_CRYPTO_AUTH_MD5] = "md5",
128 [RTE_CRYPTO_AUTH_MD5_HMAC] = "md5-hmac",
130 [RTE_CRYPTO_AUTH_NULL] = "null",
132 [RTE_CRYPTO_AUTH_SHA1] = "sha1",
133 [RTE_CRYPTO_AUTH_SHA1_HMAC] = "sha1-hmac",
135 [RTE_CRYPTO_AUTH_SHA224] = "sha2-224",
136 [RTE_CRYPTO_AUTH_SHA224_HMAC] = "sha2-224-hmac",
137 [RTE_CRYPTO_AUTH_SHA256] = "sha2-256",
138 [RTE_CRYPTO_AUTH_SHA256_HMAC] = "sha2-256-hmac",
139 [RTE_CRYPTO_AUTH_SHA384] = "sha2-384",
140 [RTE_CRYPTO_AUTH_SHA384_HMAC] = "sha2-384-hmac",
141 [RTE_CRYPTO_AUTH_SHA512] = "sha2-512",
142 [RTE_CRYPTO_AUTH_SHA512_HMAC] = "sha2-512-hmac",
144 [RTE_CRYPTO_AUTH_KASUMI_F9] = "kasumi-f9",
145 [RTE_CRYPTO_AUTH_SNOW3G_UIA2] = "snow3g-uia2",
146 [RTE_CRYPTO_AUTH_ZUC_EIA3] = "zuc-eia3"
150 * The crypto AEAD algorithm strings identifiers.
151 * It could be used in application command line.
154 rte_crypto_aead_algorithm_strings[] = {
155 [RTE_CRYPTO_AEAD_AES_CCM] = "aes-ccm",
156 [RTE_CRYPTO_AEAD_AES_GCM] = "aes-gcm",
160 * The crypto AEAD operation strings identifiers.
161 * It could be used in application command line.
164 rte_crypto_aead_operation_strings[] = {
165 [RTE_CRYPTO_AEAD_OP_ENCRYPT] = "encrypt",
166 [RTE_CRYPTO_AEAD_OP_DECRYPT] = "decrypt"
170 rte_cryptodev_get_cipher_algo_enum(enum rte_crypto_cipher_algorithm *algo_enum,
171 const char *algo_string)
175 for (i = 1; i < RTE_DIM(rte_crypto_cipher_algorithm_strings); i++) {
176 if (strcmp(algo_string, rte_crypto_cipher_algorithm_strings[i]) == 0) {
177 *algo_enum = (enum rte_crypto_cipher_algorithm) i;
187 rte_cryptodev_get_auth_algo_enum(enum rte_crypto_auth_algorithm *algo_enum,
188 const char *algo_string)
192 for (i = 1; i < RTE_DIM(rte_crypto_auth_algorithm_strings); i++) {
193 if (strcmp(algo_string, rte_crypto_auth_algorithm_strings[i]) == 0) {
194 *algo_enum = (enum rte_crypto_auth_algorithm) i;
204 rte_cryptodev_get_aead_algo_enum(enum rte_crypto_aead_algorithm *algo_enum,
205 const char *algo_string)
209 for (i = 1; i < RTE_DIM(rte_crypto_aead_algorithm_strings); i++) {
210 if (strcmp(algo_string, rte_crypto_aead_algorithm_strings[i]) == 0) {
211 *algo_enum = (enum rte_crypto_aead_algorithm) i;
221 * The crypto auth operation strings identifiers.
222 * It could be used in application command line.
225 rte_crypto_auth_operation_strings[] = {
226 [RTE_CRYPTO_AUTH_OP_VERIFY] = "verify",
227 [RTE_CRYPTO_AUTH_OP_GENERATE] = "generate"
230 const struct rte_cryptodev_symmetric_capability *
231 rte_cryptodev_sym_capability_get(uint8_t dev_id,
232 const struct rte_cryptodev_sym_capability_idx *idx)
234 const struct rte_cryptodev_capabilities *capability;
235 struct rte_cryptodev_info dev_info;
238 rte_cryptodev_info_get(dev_id, &dev_info);
240 while ((capability = &dev_info.capabilities[i++])->op !=
241 RTE_CRYPTO_OP_TYPE_UNDEFINED) {
242 if (capability->op != RTE_CRYPTO_OP_TYPE_SYMMETRIC)
245 if (capability->sym.xform_type != idx->type)
248 if (idx->type == RTE_CRYPTO_SYM_XFORM_AUTH &&
249 capability->sym.auth.algo == idx->algo.auth)
250 return &capability->sym;
252 if (idx->type == RTE_CRYPTO_SYM_XFORM_CIPHER &&
253 capability->sym.cipher.algo == idx->algo.cipher)
254 return &capability->sym;
256 if (idx->type == RTE_CRYPTO_SYM_XFORM_AEAD &&
257 capability->sym.aead.algo == idx->algo.aead)
258 return &capability->sym;
265 #define param_range_check(x, y) \
266 (((x < y.min) || (x > y.max)) || \
267 (y.increment != 0 && (x % y.increment) != 0))
270 rte_cryptodev_sym_capability_check_cipher(
271 const struct rte_cryptodev_symmetric_capability *capability,
272 uint16_t key_size, uint16_t iv_size)
274 if (param_range_check(key_size, capability->cipher.key_size))
277 if (param_range_check(iv_size, capability->cipher.iv_size))
284 rte_cryptodev_sym_capability_check_auth(
285 const struct rte_cryptodev_symmetric_capability *capability,
286 uint16_t key_size, uint16_t digest_size, uint16_t iv_size)
288 if (param_range_check(key_size, capability->auth.key_size))
291 if (param_range_check(digest_size, capability->auth.digest_size))
294 if (param_range_check(iv_size, capability->auth.iv_size))
301 rte_cryptodev_sym_capability_check_aead(
302 const struct rte_cryptodev_symmetric_capability *capability,
303 uint16_t key_size, uint16_t digest_size, uint16_t aad_size,
306 if (param_range_check(key_size, capability->aead.key_size))
309 if (param_range_check(digest_size, capability->aead.digest_size))
312 if (param_range_check(aad_size, capability->aead.aad_size))
315 if (param_range_check(iv_size, capability->aead.iv_size))
322 rte_cryptodev_get_feature_name(uint64_t flag)
325 case RTE_CRYPTODEV_FF_SYMMETRIC_CRYPTO:
326 return "SYMMETRIC_CRYPTO";
327 case RTE_CRYPTODEV_FF_ASYMMETRIC_CRYPTO:
328 return "ASYMMETRIC_CRYPTO";
329 case RTE_CRYPTODEV_FF_SYM_OPERATION_CHAINING:
330 return "SYM_OPERATION_CHAINING";
331 case RTE_CRYPTODEV_FF_CPU_SSE:
333 case RTE_CRYPTODEV_FF_CPU_AVX:
335 case RTE_CRYPTODEV_FF_CPU_AVX2:
337 case RTE_CRYPTODEV_FF_CPU_AVX512:
339 case RTE_CRYPTODEV_FF_CPU_AESNI:
341 case RTE_CRYPTODEV_FF_HW_ACCELERATED:
342 return "HW_ACCELERATED";
343 case RTE_CRYPTODEV_FF_MBUF_SCATTER_GATHER:
344 return "MBUF_SCATTER_GATHER";
345 case RTE_CRYPTODEV_FF_CPU_NEON:
347 case RTE_CRYPTODEV_FF_CPU_ARM_CE:
354 struct rte_cryptodev *
355 rte_cryptodev_pmd_get_dev(uint8_t dev_id)
357 return &rte_cryptodev_globals->devs[dev_id];
360 struct rte_cryptodev *
361 rte_cryptodev_pmd_get_named_dev(const char *name)
363 struct rte_cryptodev *dev;
369 for (i = 0; i < rte_cryptodev_globals->max_devs; i++) {
370 dev = &rte_cryptodev_globals->devs[i];
372 if ((dev->attached == RTE_CRYPTODEV_ATTACHED) &&
373 (strcmp(dev->data->name, name) == 0))
381 rte_cryptodev_pmd_is_valid_dev(uint8_t dev_id)
383 struct rte_cryptodev *dev = NULL;
385 if (dev_id >= rte_cryptodev_globals->nb_devs)
388 dev = rte_cryptodev_pmd_get_dev(dev_id);
389 if (dev->attached != RTE_CRYPTODEV_ATTACHED)
397 rte_cryptodev_get_dev_id(const char *name)
404 for (i = 0; i < rte_cryptodev_globals->nb_devs; i++)
405 if ((strcmp(rte_cryptodev_globals->devs[i].data->name, name)
407 (rte_cryptodev_globals->devs[i].attached ==
408 RTE_CRYPTODEV_ATTACHED))
415 rte_cryptodev_count(void)
417 return rte_cryptodev_globals->nb_devs;
421 rte_cryptodev_device_count_by_driver(uint8_t driver_id)
423 uint8_t i, dev_count = 0;
425 for (i = 0; i < rte_cryptodev_globals->max_devs; i++)
426 if (rte_cryptodev_globals->devs[i].driver_id == driver_id &&
427 rte_cryptodev_globals->devs[i].attached ==
428 RTE_CRYPTODEV_ATTACHED)
435 rte_cryptodev_devices_get(const char *driver_name, uint8_t *devices,
438 uint8_t i, count = 0;
439 struct rte_cryptodev *devs = rte_cryptodev_globals->devs;
440 uint8_t max_devs = rte_cryptodev_globals->max_devs;
442 for (i = 0; i < max_devs && count < nb_devices; i++) {
444 if (devs[i].attached == RTE_CRYPTODEV_ATTACHED) {
447 cmp = strncmp(devs[i].device->driver->name,
449 strlen(driver_name));
452 devices[count++] = devs[i].data->dev_id;
460 rte_cryptodev_get_sec_ctx(uint8_t dev_id)
462 if (rte_crypto_devices[dev_id].feature_flags &
463 RTE_CRYPTODEV_FF_SECURITY)
464 return rte_crypto_devices[dev_id].security_ctx;
470 rte_cryptodev_socket_id(uint8_t dev_id)
472 struct rte_cryptodev *dev;
474 if (!rte_cryptodev_pmd_is_valid_dev(dev_id))
477 dev = rte_cryptodev_pmd_get_dev(dev_id);
479 return dev->data->socket_id;
483 rte_cryptodev_data_alloc(uint8_t dev_id, struct rte_cryptodev_data **data,
486 char mz_name[RTE_CRYPTODEV_NAME_MAX_LEN];
487 const struct rte_memzone *mz;
490 /* generate memzone name */
491 n = snprintf(mz_name, sizeof(mz_name), "rte_cryptodev_data_%u", dev_id);
492 if (n >= (int)sizeof(mz_name))
495 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
496 mz = rte_memzone_reserve(mz_name,
497 sizeof(struct rte_cryptodev_data),
500 mz = rte_memzone_lookup(mz_name);
506 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
507 memset(*data, 0, sizeof(struct rte_cryptodev_data));
513 rte_cryptodev_find_free_device_index(void)
517 for (dev_id = 0; dev_id < RTE_CRYPTO_MAX_DEVS; dev_id++) {
518 if (rte_crypto_devices[dev_id].attached ==
519 RTE_CRYPTODEV_DETACHED)
522 return RTE_CRYPTO_MAX_DEVS;
525 struct rte_cryptodev *
526 rte_cryptodev_pmd_allocate(const char *name, int socket_id)
528 struct rte_cryptodev *cryptodev;
531 if (rte_cryptodev_pmd_get_named_dev(name) != NULL) {
532 CDEV_LOG_ERR("Crypto device with name %s already "
537 dev_id = rte_cryptodev_find_free_device_index();
538 if (dev_id == RTE_CRYPTO_MAX_DEVS) {
539 CDEV_LOG_ERR("Reached maximum number of crypto devices");
543 cryptodev = rte_cryptodev_pmd_get_dev(dev_id);
545 if (cryptodev->data == NULL) {
546 struct rte_cryptodev_data *cryptodev_data =
547 cryptodev_globals.data[dev_id];
549 int retval = rte_cryptodev_data_alloc(dev_id, &cryptodev_data,
552 if (retval < 0 || cryptodev_data == NULL)
555 cryptodev->data = cryptodev_data;
557 snprintf(cryptodev->data->name, RTE_CRYPTODEV_NAME_MAX_LEN,
560 cryptodev->data->dev_id = dev_id;
561 cryptodev->data->socket_id = socket_id;
562 cryptodev->data->dev_started = 0;
564 /* init user callbacks */
565 TAILQ_INIT(&(cryptodev->link_intr_cbs));
567 cryptodev->attached = RTE_CRYPTODEV_ATTACHED;
569 cryptodev_globals.nb_devs++;
576 rte_cryptodev_pmd_release_device(struct rte_cryptodev *cryptodev)
580 if (cryptodev == NULL)
583 /* Close device only if device operations have been set */
584 if (cryptodev->dev_ops) {
585 ret = rte_cryptodev_close(cryptodev->data->dev_id);
590 cryptodev->attached = RTE_CRYPTODEV_DETACHED;
591 cryptodev_globals.nb_devs--;
596 rte_cryptodev_queue_pair_count(uint8_t dev_id)
598 struct rte_cryptodev *dev;
600 dev = &rte_crypto_devices[dev_id];
601 return dev->data->nb_queue_pairs;
605 rte_cryptodev_queue_pairs_config(struct rte_cryptodev *dev, uint16_t nb_qpairs,
608 struct rte_cryptodev_info dev_info;
612 if ((dev == NULL) || (nb_qpairs < 1)) {
613 CDEV_LOG_ERR("invalid param: dev %p, nb_queues %u",
618 CDEV_LOG_DEBUG("Setup %d queues pairs on device %u",
619 nb_qpairs, dev->data->dev_id);
621 memset(&dev_info, 0, sizeof(struct rte_cryptodev_info));
623 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
624 (*dev->dev_ops->dev_infos_get)(dev, &dev_info);
626 if (nb_qpairs > (dev_info.max_nb_queue_pairs)) {
627 CDEV_LOG_ERR("Invalid num queue_pairs (%u) for dev %u",
628 nb_qpairs, dev->data->dev_id);
632 if (dev->data->queue_pairs == NULL) { /* first time configuration */
633 dev->data->queue_pairs = rte_zmalloc_socket(
634 "cryptodev->queue_pairs",
635 sizeof(dev->data->queue_pairs[0]) * nb_qpairs,
636 RTE_CACHE_LINE_SIZE, socket_id);
638 if (dev->data->queue_pairs == NULL) {
639 dev->data->nb_queue_pairs = 0;
640 CDEV_LOG_ERR("failed to get memory for qp meta data, "
645 } else { /* re-configure */
647 uint16_t old_nb_queues = dev->data->nb_queue_pairs;
649 qp = dev->data->queue_pairs;
651 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_release,
654 for (i = nb_qpairs; i < old_nb_queues; i++) {
655 ret = (*dev->dev_ops->queue_pair_release)(dev, i);
660 qp = rte_realloc(qp, sizeof(qp[0]) * nb_qpairs,
661 RTE_CACHE_LINE_SIZE);
663 CDEV_LOG_ERR("failed to realloc qp meta data,"
664 " nb_queues %u", nb_qpairs);
668 if (nb_qpairs > old_nb_queues) {
669 uint16_t new_qs = nb_qpairs - old_nb_queues;
671 memset(qp + old_nb_queues, 0,
672 sizeof(qp[0]) * new_qs);
675 dev->data->queue_pairs = qp;
678 dev->data->nb_queue_pairs = nb_qpairs;
683 rte_cryptodev_queue_pair_start(uint8_t dev_id, uint16_t queue_pair_id)
685 struct rte_cryptodev *dev;
687 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
688 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
692 dev = &rte_crypto_devices[dev_id];
693 if (queue_pair_id >= dev->data->nb_queue_pairs) {
694 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
698 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_start, -ENOTSUP);
700 return dev->dev_ops->queue_pair_start(dev, queue_pair_id);
705 rte_cryptodev_queue_pair_stop(uint8_t dev_id, uint16_t queue_pair_id)
707 struct rte_cryptodev *dev;
709 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
710 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
714 dev = &rte_crypto_devices[dev_id];
715 if (queue_pair_id >= dev->data->nb_queue_pairs) {
716 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
720 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_stop, -ENOTSUP);
722 return dev->dev_ops->queue_pair_stop(dev, queue_pair_id);
727 rte_cryptodev_configure(uint8_t dev_id, struct rte_cryptodev_config *config)
729 struct rte_cryptodev *dev;
732 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
733 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
737 dev = &rte_crypto_devices[dev_id];
739 if (dev->data->dev_started) {
741 "device %d must be stopped to allow configuration", dev_id);
745 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP);
747 /* Setup new number of queue pairs and reconfigure device. */
748 diag = rte_cryptodev_queue_pairs_config(dev, config->nb_queue_pairs,
751 CDEV_LOG_ERR("dev%d rte_crypto_dev_queue_pairs_config = %d",
756 return (*dev->dev_ops->dev_configure)(dev, config);
761 rte_cryptodev_start(uint8_t dev_id)
763 struct rte_cryptodev *dev;
766 CDEV_LOG_DEBUG("Start dev_id=%" PRIu8, dev_id);
768 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
769 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
773 dev = &rte_crypto_devices[dev_id];
775 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP);
777 if (dev->data->dev_started != 0) {
778 CDEV_LOG_ERR("Device with dev_id=%" PRIu8 " already started",
783 diag = (*dev->dev_ops->dev_start)(dev);
785 dev->data->dev_started = 1;
793 rte_cryptodev_stop(uint8_t dev_id)
795 struct rte_cryptodev *dev;
797 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
798 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
802 dev = &rte_crypto_devices[dev_id];
804 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop);
806 if (dev->data->dev_started == 0) {
807 CDEV_LOG_ERR("Device with dev_id=%" PRIu8 " already stopped",
812 (*dev->dev_ops->dev_stop)(dev);
813 dev->data->dev_started = 0;
817 rte_cryptodev_close(uint8_t dev_id)
819 struct rte_cryptodev *dev;
822 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
823 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
827 dev = &rte_crypto_devices[dev_id];
829 /* Device must be stopped before it can be closed */
830 if (dev->data->dev_started == 1) {
831 CDEV_LOG_ERR("Device %u must be stopped before closing",
836 /* We can't close the device if there are outstanding sessions in use */
837 if (dev->data->session_pool != NULL) {
838 if (!rte_mempool_full(dev->data->session_pool)) {
839 CDEV_LOG_ERR("dev_id=%u close failed, session mempool "
840 "has sessions still in use, free "
841 "all sessions before calling close",
847 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_close, -ENOTSUP);
848 retval = (*dev->dev_ops->dev_close)(dev);
857 rte_cryptodev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
858 const struct rte_cryptodev_qp_conf *qp_conf, int socket_id,
859 struct rte_mempool *session_pool)
862 struct rte_cryptodev *dev;
864 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
865 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
869 dev = &rte_crypto_devices[dev_id];
870 if (queue_pair_id >= dev->data->nb_queue_pairs) {
871 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
875 if (dev->data->dev_started) {
877 "device %d must be stopped to allow configuration", dev_id);
881 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_setup, -ENOTSUP);
883 return (*dev->dev_ops->queue_pair_setup)(dev, queue_pair_id, qp_conf,
884 socket_id, session_pool);
889 rte_cryptodev_stats_get(uint8_t dev_id, struct rte_cryptodev_stats *stats)
891 struct rte_cryptodev *dev;
893 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
894 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
899 CDEV_LOG_ERR("Invalid stats ptr");
903 dev = &rte_crypto_devices[dev_id];
904 memset(stats, 0, sizeof(*stats));
906 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->stats_get, -ENOTSUP);
907 (*dev->dev_ops->stats_get)(dev, stats);
912 rte_cryptodev_stats_reset(uint8_t dev_id)
914 struct rte_cryptodev *dev;
916 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
917 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
921 dev = &rte_crypto_devices[dev_id];
923 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->stats_reset);
924 (*dev->dev_ops->stats_reset)(dev);
929 rte_cryptodev_info_get(uint8_t dev_id, struct rte_cryptodev_info *dev_info)
931 struct rte_cryptodev *dev;
933 if (dev_id >= cryptodev_globals.nb_devs) {
934 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
938 dev = &rte_crypto_devices[dev_id];
940 memset(dev_info, 0, sizeof(struct rte_cryptodev_info));
942 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_infos_get);
943 (*dev->dev_ops->dev_infos_get)(dev, dev_info);
945 dev_info->driver_name = dev->device->driver->name;
950 rte_cryptodev_callback_register(uint8_t dev_id,
951 enum rte_cryptodev_event_type event,
952 rte_cryptodev_cb_fn cb_fn, void *cb_arg)
954 struct rte_cryptodev *dev;
955 struct rte_cryptodev_callback *user_cb;
960 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
961 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
965 dev = &rte_crypto_devices[dev_id];
966 rte_spinlock_lock(&rte_cryptodev_cb_lock);
968 TAILQ_FOREACH(user_cb, &(dev->link_intr_cbs), next) {
969 if (user_cb->cb_fn == cb_fn &&
970 user_cb->cb_arg == cb_arg &&
971 user_cb->event == event) {
976 /* create a new callback. */
977 if (user_cb == NULL) {
978 user_cb = rte_zmalloc("INTR_USER_CALLBACK",
979 sizeof(struct rte_cryptodev_callback), 0);
980 if (user_cb != NULL) {
981 user_cb->cb_fn = cb_fn;
982 user_cb->cb_arg = cb_arg;
983 user_cb->event = event;
984 TAILQ_INSERT_TAIL(&(dev->link_intr_cbs), user_cb, next);
988 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
989 return (user_cb == NULL) ? -ENOMEM : 0;
993 rte_cryptodev_callback_unregister(uint8_t dev_id,
994 enum rte_cryptodev_event_type event,
995 rte_cryptodev_cb_fn cb_fn, void *cb_arg)
998 struct rte_cryptodev *dev;
999 struct rte_cryptodev_callback *cb, *next;
1004 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1005 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
1009 dev = &rte_crypto_devices[dev_id];
1010 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1013 for (cb = TAILQ_FIRST(&dev->link_intr_cbs); cb != NULL; cb = next) {
1015 next = TAILQ_NEXT(cb, next);
1017 if (cb->cb_fn != cb_fn || cb->event != event ||
1018 (cb->cb_arg != (void *)-1 &&
1019 cb->cb_arg != cb_arg))
1023 * if this callback is not executing right now,
1026 if (cb->active == 0) {
1027 TAILQ_REMOVE(&(dev->link_intr_cbs), cb, next);
1034 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1039 rte_cryptodev_pmd_callback_process(struct rte_cryptodev *dev,
1040 enum rte_cryptodev_event_type event)
1042 struct rte_cryptodev_callback *cb_lst;
1043 struct rte_cryptodev_callback dev_cb;
1045 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1046 TAILQ_FOREACH(cb_lst, &(dev->link_intr_cbs), next) {
1047 if (cb_lst->cb_fn == NULL || cb_lst->event != event)
1051 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1052 dev_cb.cb_fn(dev->data->dev_id, dev_cb.event,
1054 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1057 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1062 rte_cryptodev_sym_session_init(uint8_t dev_id,
1063 struct rte_cryptodev_sym_session *sess,
1064 struct rte_crypto_sym_xform *xforms,
1065 struct rte_mempool *mp)
1067 struct rte_cryptodev *dev;
1071 dev = rte_cryptodev_pmd_get_dev(dev_id);
1073 if (sess == NULL || xforms == NULL || dev == NULL)
1076 index = dev->driver_id;
1078 if (sess->sess_private_data[index] == NULL) {
1079 ret = dev->dev_ops->session_configure(dev, xforms, sess, mp);
1082 "dev_id %d failed to configure session details",
1091 struct rte_cryptodev_sym_session *
1092 rte_cryptodev_sym_session_create(struct rte_mempool *mp)
1094 struct rte_cryptodev_sym_session *sess;
1096 /* Allocate a session structure from the session pool */
1097 if (rte_mempool_get(mp, (void **)&sess)) {
1098 CDEV_LOG_ERR("couldn't get object from session mempool");
1102 /* Clear device session pointer.
1103 * Include the flag indicating presence of private data
1105 memset(sess, 0, (sizeof(void *) * nb_drivers) + sizeof(uint8_t));
1111 rte_cryptodev_queue_pair_attach_sym_session(uint8_t dev_id, uint16_t qp_id,
1112 struct rte_cryptodev_sym_session *sess)
1114 struct rte_cryptodev *dev;
1116 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1117 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
1121 dev = &rte_crypto_devices[dev_id];
1123 /* The API is optional, not returning error if driver do not suuport */
1124 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->qp_attach_session, 0);
1126 void *sess_priv = get_session_private_data(sess, dev->driver_id);
1128 if (dev->dev_ops->qp_attach_session(dev, qp_id, sess_priv)) {
1129 CDEV_LOG_ERR("dev_id %d failed to attach qp: %d with session",
1138 rte_cryptodev_queue_pair_detach_sym_session(uint8_t dev_id, uint16_t qp_id,
1139 struct rte_cryptodev_sym_session *sess)
1141 struct rte_cryptodev *dev;
1143 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1144 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
1148 dev = &rte_crypto_devices[dev_id];
1150 /* The API is optional, not returning error if driver do not suuport */
1151 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->qp_detach_session, 0);
1153 void *sess_priv = get_session_private_data(sess, dev->driver_id);
1155 if (dev->dev_ops->qp_detach_session(dev, qp_id, sess_priv)) {
1156 CDEV_LOG_ERR("dev_id %d failed to detach qp: %d from session",
1165 rte_cryptodev_sym_session_clear(uint8_t dev_id,
1166 struct rte_cryptodev_sym_session *sess)
1168 struct rte_cryptodev *dev;
1170 dev = rte_cryptodev_pmd_get_dev(dev_id);
1172 if (dev == NULL || sess == NULL)
1175 dev->dev_ops->session_clear(dev, sess);
1181 rte_cryptodev_sym_session_free(struct rte_cryptodev_sym_session *sess)
1185 struct rte_mempool *sess_mp;
1190 /* Check that all device private data has been freed */
1191 for (i = 0; i < nb_drivers; i++) {
1192 sess_priv = get_session_private_data(sess, i);
1193 if (sess_priv != NULL)
1197 /* Return session to mempool */
1198 sess_mp = rte_mempool_from_obj(sess);
1199 rte_mempool_put(sess_mp, sess);
1205 rte_cryptodev_get_header_session_size(void)
1208 * Header contains pointers to the private data
1209 * of all registered drivers, and a flag which
1210 * indicates presence of private data
1212 return ((sizeof(void *) * nb_drivers) + sizeof(uint8_t));
1216 rte_cryptodev_get_private_session_size(uint8_t dev_id)
1218 struct rte_cryptodev *dev;
1219 unsigned int header_size = sizeof(void *) * nb_drivers;
1220 unsigned int priv_sess_size;
1222 if (!rte_cryptodev_pmd_is_valid_dev(dev_id))
1225 dev = rte_cryptodev_pmd_get_dev(dev_id);
1227 if (*dev->dev_ops->session_get_size == NULL)
1230 priv_sess_size = (*dev->dev_ops->session_get_size)(dev);
1233 * If size is less than session header size,
1234 * return the latter, as this guarantees that
1235 * sessionless operations will work
1237 if (priv_sess_size < header_size)
1240 return priv_sess_size;
1244 int __rte_experimental
1245 rte_cryptodev_sym_session_set_private_data(
1246 struct rte_cryptodev_sym_session *sess,
1250 uint16_t off_set = sizeof(void *) * nb_drivers;
1251 uint8_t *private_data_present = (uint8_t *)sess + off_set;
1256 *private_data_present = 1;
1257 off_set += sizeof(uint8_t);
1258 rte_memcpy((uint8_t *)sess + off_set, data, size);
1262 void * __rte_experimental
1263 rte_cryptodev_sym_session_get_private_data(
1264 struct rte_cryptodev_sym_session *sess)
1266 uint16_t off_set = sizeof(void *) * nb_drivers;
1267 uint8_t *private_data_present = (uint8_t *)sess + off_set;
1269 if (sess == NULL || !*private_data_present)
1272 off_set += sizeof(uint8_t);
1273 return (uint8_t *)sess + off_set;
1276 /** Initialise rte_crypto_op mempool element */
1278 rte_crypto_op_init(struct rte_mempool *mempool,
1281 __rte_unused unsigned i)
1283 struct rte_crypto_op *op = _op_data;
1284 enum rte_crypto_op_type type = *(enum rte_crypto_op_type *)opaque_arg;
1286 memset(_op_data, 0, mempool->elt_size);
1288 __rte_crypto_op_reset(op, type);
1290 op->phys_addr = rte_mem_virt2iova(_op_data);
1291 op->mempool = mempool;
1295 struct rte_mempool *
1296 rte_crypto_op_pool_create(const char *name, enum rte_crypto_op_type type,
1297 unsigned nb_elts, unsigned cache_size, uint16_t priv_size,
1300 struct rte_crypto_op_pool_private *priv;
1302 unsigned elt_size = sizeof(struct rte_crypto_op) +
1303 sizeof(struct rte_crypto_sym_op) +
1306 /* lookup mempool in case already allocated */
1307 struct rte_mempool *mp = rte_mempool_lookup(name);
1310 priv = (struct rte_crypto_op_pool_private *)
1311 rte_mempool_get_priv(mp);
1313 if (mp->elt_size != elt_size ||
1314 mp->cache_size < cache_size ||
1315 mp->size < nb_elts ||
1316 priv->priv_size < priv_size) {
1318 CDEV_LOG_ERR("Mempool %s already exists but with "
1319 "incompatible parameters", name);
1325 mp = rte_mempool_create(
1330 sizeof(struct rte_crypto_op_pool_private),
1339 CDEV_LOG_ERR("Failed to create mempool %s", name);
1343 priv = (struct rte_crypto_op_pool_private *)
1344 rte_mempool_get_priv(mp);
1346 priv->priv_size = priv_size;
1353 rte_cryptodev_pmd_create_dev_name(char *name, const char *dev_name_prefix)
1355 struct rte_cryptodev *dev = NULL;
1361 for (i = 0; i < RTE_CRYPTO_MAX_DEVS; i++) {
1362 int ret = snprintf(name, RTE_CRYPTODEV_NAME_MAX_LEN,
1363 "%s_%u", dev_name_prefix, i);
1368 dev = rte_cryptodev_pmd_get_named_dev(name);
1376 TAILQ_HEAD(cryptodev_driver_list, cryptodev_driver);
1378 static struct cryptodev_driver_list cryptodev_driver_list =
1379 TAILQ_HEAD_INITIALIZER(cryptodev_driver_list);
1382 rte_cryptodev_driver_id_get(const char *name)
1384 struct cryptodev_driver *driver;
1385 const char *driver_name;
1388 RTE_LOG(DEBUG, CRYPTODEV, "name pointer NULL");
1392 TAILQ_FOREACH(driver, &cryptodev_driver_list, next) {
1393 driver_name = driver->driver->name;
1394 if (strncmp(driver_name, name, strlen(driver_name)) == 0)
1401 rte_cryptodev_name_get(uint8_t dev_id)
1403 struct rte_cryptodev *dev = rte_cryptodev_pmd_get_dev(dev_id);
1408 return dev->data->name;
1412 rte_cryptodev_driver_name_get(uint8_t driver_id)
1414 struct cryptodev_driver *driver;
1416 TAILQ_FOREACH(driver, &cryptodev_driver_list, next)
1417 if (driver->id == driver_id)
1418 return driver->driver->name;
1423 rte_cryptodev_allocate_driver(struct cryptodev_driver *crypto_drv,
1424 const struct rte_driver *drv)
1426 crypto_drv->driver = drv;
1427 crypto_drv->id = nb_drivers;
1429 TAILQ_INSERT_TAIL(&cryptodev_driver_list, crypto_drv, next);
1431 return nb_drivers++;