4 * Copyright(c) 2015-2017 Intel Corporation. All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
10 * * Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * * Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in
14 * the documentation and/or other materials provided with the
16 * * Neither the name of Intel Corporation nor the names of its
17 * contributors may be used to endorse or promote products derived
18 * from this software without specific prior written permission.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 #include <sys/types.h>
34 #include <sys/queue.h>
43 #include <netinet/in.h>
45 #include <rte_byteorder.h>
47 #include <rte_debug.h>
49 #include <rte_interrupts.h>
50 #include <rte_memory.h>
51 #include <rte_memcpy.h>
52 #include <rte_memzone.h>
53 #include <rte_launch.h>
54 #include <rte_tailq.h>
56 #include <rte_per_lcore.h>
57 #include <rte_lcore.h>
58 #include <rte_atomic.h>
59 #include <rte_branch_prediction.h>
60 #include <rte_common.h>
61 #include <rte_mempool.h>
62 #include <rte_malloc.h>
64 #include <rte_errno.h>
65 #include <rte_spinlock.h>
66 #include <rte_string_fns.h>
68 #include "rte_crypto.h"
69 #include "rte_cryptodev.h"
70 #include "rte_cryptodev_pmd.h"
72 static uint8_t nb_drivers;
74 struct rte_cryptodev rte_crypto_devices[RTE_CRYPTO_MAX_DEVS];
76 struct rte_cryptodev *rte_cryptodevs = &rte_crypto_devices[0];
78 static struct rte_cryptodev_global cryptodev_globals = {
79 .devs = &rte_crypto_devices[0],
82 .max_devs = RTE_CRYPTO_MAX_DEVS
85 struct rte_cryptodev_global *rte_cryptodev_globals = &cryptodev_globals;
87 /* spinlock for crypto device callbacks */
88 static rte_spinlock_t rte_cryptodev_cb_lock = RTE_SPINLOCK_INITIALIZER;
92 * The user application callback description.
94 * It contains callback address to be registered by user application,
95 * the pointer to the parameters for callback, and the event type.
97 struct rte_cryptodev_callback {
98 TAILQ_ENTRY(rte_cryptodev_callback) next; /**< Callbacks list */
99 rte_cryptodev_cb_fn cb_fn; /**< Callback address */
100 void *cb_arg; /**< Parameter for callback */
101 enum rte_cryptodev_event_type event; /**< Interrupt event type */
102 uint32_t active; /**< Callback is executing */
106 * The crypto cipher algorithm strings identifiers.
107 * It could be used in application command line.
110 rte_crypto_cipher_algorithm_strings[] = {
111 [RTE_CRYPTO_CIPHER_3DES_CBC] = "3des-cbc",
112 [RTE_CRYPTO_CIPHER_3DES_ECB] = "3des-ecb",
113 [RTE_CRYPTO_CIPHER_3DES_CTR] = "3des-ctr",
115 [RTE_CRYPTO_CIPHER_AES_CBC] = "aes-cbc",
116 [RTE_CRYPTO_CIPHER_AES_CTR] = "aes-ctr",
117 [RTE_CRYPTO_CIPHER_AES_DOCSISBPI] = "aes-docsisbpi",
118 [RTE_CRYPTO_CIPHER_AES_ECB] = "aes-ecb",
119 [RTE_CRYPTO_CIPHER_AES_F8] = "aes-f8",
120 [RTE_CRYPTO_CIPHER_AES_XTS] = "aes-xts",
122 [RTE_CRYPTO_CIPHER_ARC4] = "arc4",
124 [RTE_CRYPTO_CIPHER_DES_CBC] = "des-cbc",
125 [RTE_CRYPTO_CIPHER_DES_DOCSISBPI] = "des-docsisbpi",
127 [RTE_CRYPTO_CIPHER_NULL] = "null",
129 [RTE_CRYPTO_CIPHER_KASUMI_F8] = "kasumi-f8",
130 [RTE_CRYPTO_CIPHER_SNOW3G_UEA2] = "snow3g-uea2",
131 [RTE_CRYPTO_CIPHER_ZUC_EEA3] = "zuc-eea3"
135 * The crypto cipher operation strings identifiers.
136 * It could be used in application command line.
139 rte_crypto_cipher_operation_strings[] = {
140 [RTE_CRYPTO_CIPHER_OP_ENCRYPT] = "encrypt",
141 [RTE_CRYPTO_CIPHER_OP_DECRYPT] = "decrypt"
145 * The crypto auth algorithm strings identifiers.
146 * It could be used in application command line.
149 rte_crypto_auth_algorithm_strings[] = {
150 [RTE_CRYPTO_AUTH_AES_CBC_MAC] = "aes-cbc-mac",
151 [RTE_CRYPTO_AUTH_AES_CMAC] = "aes-cmac",
152 [RTE_CRYPTO_AUTH_AES_GMAC] = "aes-gmac",
153 [RTE_CRYPTO_AUTH_AES_XCBC_MAC] = "aes-xcbc-mac",
155 [RTE_CRYPTO_AUTH_MD5] = "md5",
156 [RTE_CRYPTO_AUTH_MD5_HMAC] = "md5-hmac",
158 [RTE_CRYPTO_AUTH_NULL] = "null",
160 [RTE_CRYPTO_AUTH_SHA1] = "sha1",
161 [RTE_CRYPTO_AUTH_SHA1_HMAC] = "sha1-hmac",
163 [RTE_CRYPTO_AUTH_SHA224] = "sha2-224",
164 [RTE_CRYPTO_AUTH_SHA224_HMAC] = "sha2-224-hmac",
165 [RTE_CRYPTO_AUTH_SHA256] = "sha2-256",
166 [RTE_CRYPTO_AUTH_SHA256_HMAC] = "sha2-256-hmac",
167 [RTE_CRYPTO_AUTH_SHA384] = "sha2-384",
168 [RTE_CRYPTO_AUTH_SHA384_HMAC] = "sha2-384-hmac",
169 [RTE_CRYPTO_AUTH_SHA512] = "sha2-512",
170 [RTE_CRYPTO_AUTH_SHA512_HMAC] = "sha2-512-hmac",
172 [RTE_CRYPTO_AUTH_KASUMI_F9] = "kasumi-f9",
173 [RTE_CRYPTO_AUTH_SNOW3G_UIA2] = "snow3g-uia2",
174 [RTE_CRYPTO_AUTH_ZUC_EIA3] = "zuc-eia3"
178 * The crypto AEAD algorithm strings identifiers.
179 * It could be used in application command line.
182 rte_crypto_aead_algorithm_strings[] = {
183 [RTE_CRYPTO_AEAD_AES_CCM] = "aes-ccm",
184 [RTE_CRYPTO_AEAD_AES_GCM] = "aes-gcm",
188 * The crypto AEAD operation strings identifiers.
189 * It could be used in application command line.
192 rte_crypto_aead_operation_strings[] = {
193 [RTE_CRYPTO_AEAD_OP_ENCRYPT] = "encrypt",
194 [RTE_CRYPTO_AEAD_OP_DECRYPT] = "decrypt"
198 rte_cryptodev_get_cipher_algo_enum(enum rte_crypto_cipher_algorithm *algo_enum,
199 const char *algo_string)
203 for (i = 1; i < RTE_DIM(rte_crypto_cipher_algorithm_strings); i++) {
204 if (strcmp(algo_string, rte_crypto_cipher_algorithm_strings[i]) == 0) {
205 *algo_enum = (enum rte_crypto_cipher_algorithm) i;
215 rte_cryptodev_get_auth_algo_enum(enum rte_crypto_auth_algorithm *algo_enum,
216 const char *algo_string)
220 for (i = 1; i < RTE_DIM(rte_crypto_auth_algorithm_strings); i++) {
221 if (strcmp(algo_string, rte_crypto_auth_algorithm_strings[i]) == 0) {
222 *algo_enum = (enum rte_crypto_auth_algorithm) i;
232 rte_cryptodev_get_aead_algo_enum(enum rte_crypto_aead_algorithm *algo_enum,
233 const char *algo_string)
237 for (i = 1; i < RTE_DIM(rte_crypto_aead_algorithm_strings); i++) {
238 if (strcmp(algo_string, rte_crypto_aead_algorithm_strings[i]) == 0) {
239 *algo_enum = (enum rte_crypto_aead_algorithm) i;
249 * The crypto auth operation strings identifiers.
250 * It could be used in application command line.
253 rte_crypto_auth_operation_strings[] = {
254 [RTE_CRYPTO_AUTH_OP_VERIFY] = "verify",
255 [RTE_CRYPTO_AUTH_OP_GENERATE] = "generate"
258 const struct rte_cryptodev_symmetric_capability *
259 rte_cryptodev_sym_capability_get(uint8_t dev_id,
260 const struct rte_cryptodev_sym_capability_idx *idx)
262 const struct rte_cryptodev_capabilities *capability;
263 struct rte_cryptodev_info dev_info;
266 rte_cryptodev_info_get(dev_id, &dev_info);
268 while ((capability = &dev_info.capabilities[i++])->op !=
269 RTE_CRYPTO_OP_TYPE_UNDEFINED) {
270 if (capability->op != RTE_CRYPTO_OP_TYPE_SYMMETRIC)
273 if (capability->sym.xform_type != idx->type)
276 if (idx->type == RTE_CRYPTO_SYM_XFORM_AUTH &&
277 capability->sym.auth.algo == idx->algo.auth)
278 return &capability->sym;
280 if (idx->type == RTE_CRYPTO_SYM_XFORM_CIPHER &&
281 capability->sym.cipher.algo == idx->algo.cipher)
282 return &capability->sym;
284 if (idx->type == RTE_CRYPTO_SYM_XFORM_AEAD &&
285 capability->sym.aead.algo == idx->algo.aead)
286 return &capability->sym;
294 param_range_check(uint16_t size, const struct rte_crypto_param_range *range)
296 unsigned int next_size;
298 /* Check lower/upper bounds */
299 if (size < range->min)
302 if (size > range->max)
305 /* If range is actually only one value, size is correct */
306 if (range->increment == 0)
309 /* Check if value is one of the supported sizes */
310 for (next_size = range->min; next_size <= range->max;
311 next_size += range->increment)
312 if (size == next_size)
319 rte_cryptodev_sym_capability_check_cipher(
320 const struct rte_cryptodev_symmetric_capability *capability,
321 uint16_t key_size, uint16_t iv_size)
323 if (param_range_check(key_size, &capability->cipher.key_size) != 0)
326 if (param_range_check(iv_size, &capability->cipher.iv_size) != 0)
333 rte_cryptodev_sym_capability_check_auth(
334 const struct rte_cryptodev_symmetric_capability *capability,
335 uint16_t key_size, uint16_t digest_size, uint16_t iv_size)
337 if (param_range_check(key_size, &capability->auth.key_size) != 0)
340 if (param_range_check(digest_size, &capability->auth.digest_size) != 0)
343 if (param_range_check(iv_size, &capability->auth.iv_size) != 0)
350 rte_cryptodev_sym_capability_check_aead(
351 const struct rte_cryptodev_symmetric_capability *capability,
352 uint16_t key_size, uint16_t digest_size, uint16_t aad_size,
355 if (param_range_check(key_size, &capability->aead.key_size) != 0)
358 if (param_range_check(digest_size, &capability->aead.digest_size) != 0)
361 if (param_range_check(aad_size, &capability->aead.aad_size) != 0)
364 if (param_range_check(iv_size, &capability->aead.iv_size) != 0)
371 rte_cryptodev_get_feature_name(uint64_t flag)
374 case RTE_CRYPTODEV_FF_SYMMETRIC_CRYPTO:
375 return "SYMMETRIC_CRYPTO";
376 case RTE_CRYPTODEV_FF_ASYMMETRIC_CRYPTO:
377 return "ASYMMETRIC_CRYPTO";
378 case RTE_CRYPTODEV_FF_SYM_OPERATION_CHAINING:
379 return "SYM_OPERATION_CHAINING";
380 case RTE_CRYPTODEV_FF_CPU_SSE:
382 case RTE_CRYPTODEV_FF_CPU_AVX:
384 case RTE_CRYPTODEV_FF_CPU_AVX2:
386 case RTE_CRYPTODEV_FF_CPU_AVX512:
388 case RTE_CRYPTODEV_FF_CPU_AESNI:
390 case RTE_CRYPTODEV_FF_HW_ACCELERATED:
391 return "HW_ACCELERATED";
392 case RTE_CRYPTODEV_FF_MBUF_SCATTER_GATHER:
393 return "MBUF_SCATTER_GATHER";
394 case RTE_CRYPTODEV_FF_CPU_NEON:
396 case RTE_CRYPTODEV_FF_CPU_ARM_CE:
403 struct rte_cryptodev *
404 rte_cryptodev_pmd_get_dev(uint8_t dev_id)
406 return &rte_cryptodev_globals->devs[dev_id];
409 struct rte_cryptodev *
410 rte_cryptodev_pmd_get_named_dev(const char *name)
412 struct rte_cryptodev *dev;
418 for (i = 0; i < rte_cryptodev_globals->max_devs; i++) {
419 dev = &rte_cryptodev_globals->devs[i];
421 if ((dev->attached == RTE_CRYPTODEV_ATTACHED) &&
422 (strcmp(dev->data->name, name) == 0))
430 rte_cryptodev_pmd_is_valid_dev(uint8_t dev_id)
432 struct rte_cryptodev *dev = NULL;
434 if (dev_id >= rte_cryptodev_globals->nb_devs)
437 dev = rte_cryptodev_pmd_get_dev(dev_id);
438 if (dev->attached != RTE_CRYPTODEV_ATTACHED)
446 rte_cryptodev_get_dev_id(const char *name)
453 for (i = 0; i < rte_cryptodev_globals->nb_devs; i++)
454 if ((strcmp(rte_cryptodev_globals->devs[i].data->name, name)
456 (rte_cryptodev_globals->devs[i].attached ==
457 RTE_CRYPTODEV_ATTACHED))
464 rte_cryptodev_count(void)
466 return rte_cryptodev_globals->nb_devs;
470 rte_cryptodev_device_count_by_driver(uint8_t driver_id)
472 uint8_t i, dev_count = 0;
474 for (i = 0; i < rte_cryptodev_globals->max_devs; i++)
475 if (rte_cryptodev_globals->devs[i].driver_id == driver_id &&
476 rte_cryptodev_globals->devs[i].attached ==
477 RTE_CRYPTODEV_ATTACHED)
484 rte_cryptodev_devices_get(const char *driver_name, uint8_t *devices,
487 uint8_t i, count = 0;
488 struct rte_cryptodev *devs = rte_cryptodev_globals->devs;
489 uint8_t max_devs = rte_cryptodev_globals->max_devs;
491 for (i = 0; i < max_devs && count < nb_devices; i++) {
493 if (devs[i].attached == RTE_CRYPTODEV_ATTACHED) {
496 cmp = strncmp(devs[i].device->driver->name,
498 strlen(driver_name));
501 devices[count++] = devs[i].data->dev_id;
509 rte_cryptodev_get_sec_ctx(uint8_t dev_id)
511 if (rte_crypto_devices[dev_id].feature_flags &
512 RTE_CRYPTODEV_FF_SECURITY)
513 return rte_crypto_devices[dev_id].security_ctx;
519 rte_cryptodev_socket_id(uint8_t dev_id)
521 struct rte_cryptodev *dev;
523 if (!rte_cryptodev_pmd_is_valid_dev(dev_id))
526 dev = rte_cryptodev_pmd_get_dev(dev_id);
528 return dev->data->socket_id;
532 rte_cryptodev_data_alloc(uint8_t dev_id, struct rte_cryptodev_data **data,
535 char mz_name[RTE_CRYPTODEV_NAME_MAX_LEN];
536 const struct rte_memzone *mz;
539 /* generate memzone name */
540 n = snprintf(mz_name, sizeof(mz_name), "rte_cryptodev_data_%u", dev_id);
541 if (n >= (int)sizeof(mz_name))
544 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
545 mz = rte_memzone_reserve(mz_name,
546 sizeof(struct rte_cryptodev_data),
549 mz = rte_memzone_lookup(mz_name);
555 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
556 memset(*data, 0, sizeof(struct rte_cryptodev_data));
562 rte_cryptodev_find_free_device_index(void)
566 for (dev_id = 0; dev_id < RTE_CRYPTO_MAX_DEVS; dev_id++) {
567 if (rte_crypto_devices[dev_id].attached ==
568 RTE_CRYPTODEV_DETACHED)
571 return RTE_CRYPTO_MAX_DEVS;
574 struct rte_cryptodev *
575 rte_cryptodev_pmd_allocate(const char *name, int socket_id)
577 struct rte_cryptodev *cryptodev;
580 if (rte_cryptodev_pmd_get_named_dev(name) != NULL) {
581 CDEV_LOG_ERR("Crypto device with name %s already "
586 dev_id = rte_cryptodev_find_free_device_index();
587 if (dev_id == RTE_CRYPTO_MAX_DEVS) {
588 CDEV_LOG_ERR("Reached maximum number of crypto devices");
592 cryptodev = rte_cryptodev_pmd_get_dev(dev_id);
594 if (cryptodev->data == NULL) {
595 struct rte_cryptodev_data *cryptodev_data =
596 cryptodev_globals.data[dev_id];
598 int retval = rte_cryptodev_data_alloc(dev_id, &cryptodev_data,
601 if (retval < 0 || cryptodev_data == NULL)
604 cryptodev->data = cryptodev_data;
606 snprintf(cryptodev->data->name, RTE_CRYPTODEV_NAME_MAX_LEN,
609 cryptodev->data->dev_id = dev_id;
610 cryptodev->data->socket_id = socket_id;
611 cryptodev->data->dev_started = 0;
613 /* init user callbacks */
614 TAILQ_INIT(&(cryptodev->link_intr_cbs));
616 cryptodev->attached = RTE_CRYPTODEV_ATTACHED;
618 cryptodev_globals.nb_devs++;
625 rte_cryptodev_pmd_release_device(struct rte_cryptodev *cryptodev)
629 if (cryptodev == NULL)
632 /* Close device only if device operations have been set */
633 if (cryptodev->dev_ops) {
634 ret = rte_cryptodev_close(cryptodev->data->dev_id);
639 cryptodev->attached = RTE_CRYPTODEV_DETACHED;
640 cryptodev_globals.nb_devs--;
645 rte_cryptodev_queue_pair_count(uint8_t dev_id)
647 struct rte_cryptodev *dev;
649 dev = &rte_crypto_devices[dev_id];
650 return dev->data->nb_queue_pairs;
654 rte_cryptodev_queue_pairs_config(struct rte_cryptodev *dev, uint16_t nb_qpairs,
657 struct rte_cryptodev_info dev_info;
661 if ((dev == NULL) || (nb_qpairs < 1)) {
662 CDEV_LOG_ERR("invalid param: dev %p, nb_queues %u",
667 CDEV_LOG_DEBUG("Setup %d queues pairs on device %u",
668 nb_qpairs, dev->data->dev_id);
670 memset(&dev_info, 0, sizeof(struct rte_cryptodev_info));
672 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
673 (*dev->dev_ops->dev_infos_get)(dev, &dev_info);
675 if (nb_qpairs > (dev_info.max_nb_queue_pairs)) {
676 CDEV_LOG_ERR("Invalid num queue_pairs (%u) for dev %u",
677 nb_qpairs, dev->data->dev_id);
681 if (dev->data->queue_pairs == NULL) { /* first time configuration */
682 dev->data->queue_pairs = rte_zmalloc_socket(
683 "cryptodev->queue_pairs",
684 sizeof(dev->data->queue_pairs[0]) * nb_qpairs,
685 RTE_CACHE_LINE_SIZE, socket_id);
687 if (dev->data->queue_pairs == NULL) {
688 dev->data->nb_queue_pairs = 0;
689 CDEV_LOG_ERR("failed to get memory for qp meta data, "
694 } else { /* re-configure */
696 uint16_t old_nb_queues = dev->data->nb_queue_pairs;
698 qp = dev->data->queue_pairs;
700 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_release,
703 for (i = nb_qpairs; i < old_nb_queues; i++) {
704 ret = (*dev->dev_ops->queue_pair_release)(dev, i);
709 qp = rte_realloc(qp, sizeof(qp[0]) * nb_qpairs,
710 RTE_CACHE_LINE_SIZE);
712 CDEV_LOG_ERR("failed to realloc qp meta data,"
713 " nb_queues %u", nb_qpairs);
717 if (nb_qpairs > old_nb_queues) {
718 uint16_t new_qs = nb_qpairs - old_nb_queues;
720 memset(qp + old_nb_queues, 0,
721 sizeof(qp[0]) * new_qs);
724 dev->data->queue_pairs = qp;
727 dev->data->nb_queue_pairs = nb_qpairs;
732 rte_cryptodev_queue_pair_start(uint8_t dev_id, uint16_t queue_pair_id)
734 struct rte_cryptodev *dev;
736 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
737 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
741 dev = &rte_crypto_devices[dev_id];
742 if (queue_pair_id >= dev->data->nb_queue_pairs) {
743 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
747 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_start, -ENOTSUP);
749 return dev->dev_ops->queue_pair_start(dev, queue_pair_id);
754 rte_cryptodev_queue_pair_stop(uint8_t dev_id, uint16_t queue_pair_id)
756 struct rte_cryptodev *dev;
758 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
759 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
763 dev = &rte_crypto_devices[dev_id];
764 if (queue_pair_id >= dev->data->nb_queue_pairs) {
765 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
769 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_stop, -ENOTSUP);
771 return dev->dev_ops->queue_pair_stop(dev, queue_pair_id);
776 rte_cryptodev_configure(uint8_t dev_id, struct rte_cryptodev_config *config)
778 struct rte_cryptodev *dev;
781 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
782 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
786 dev = &rte_crypto_devices[dev_id];
788 if (dev->data->dev_started) {
790 "device %d must be stopped to allow configuration", dev_id);
794 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP);
796 /* Setup new number of queue pairs and reconfigure device. */
797 diag = rte_cryptodev_queue_pairs_config(dev, config->nb_queue_pairs,
800 CDEV_LOG_ERR("dev%d rte_crypto_dev_queue_pairs_config = %d",
805 return (*dev->dev_ops->dev_configure)(dev, config);
810 rte_cryptodev_start(uint8_t dev_id)
812 struct rte_cryptodev *dev;
815 CDEV_LOG_DEBUG("Start dev_id=%" PRIu8, dev_id);
817 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
818 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
822 dev = &rte_crypto_devices[dev_id];
824 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP);
826 if (dev->data->dev_started != 0) {
827 CDEV_LOG_ERR("Device with dev_id=%" PRIu8 " already started",
832 diag = (*dev->dev_ops->dev_start)(dev);
834 dev->data->dev_started = 1;
842 rte_cryptodev_stop(uint8_t dev_id)
844 struct rte_cryptodev *dev;
846 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
847 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
851 dev = &rte_crypto_devices[dev_id];
853 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop);
855 if (dev->data->dev_started == 0) {
856 CDEV_LOG_ERR("Device with dev_id=%" PRIu8 " already stopped",
861 (*dev->dev_ops->dev_stop)(dev);
862 dev->data->dev_started = 0;
866 rte_cryptodev_close(uint8_t dev_id)
868 struct rte_cryptodev *dev;
871 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
872 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
876 dev = &rte_crypto_devices[dev_id];
878 /* Device must be stopped before it can be closed */
879 if (dev->data->dev_started == 1) {
880 CDEV_LOG_ERR("Device %u must be stopped before closing",
885 /* We can't close the device if there are outstanding sessions in use */
886 if (dev->data->session_pool != NULL) {
887 if (!rte_mempool_full(dev->data->session_pool)) {
888 CDEV_LOG_ERR("dev_id=%u close failed, session mempool "
889 "has sessions still in use, free "
890 "all sessions before calling close",
896 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_close, -ENOTSUP);
897 retval = (*dev->dev_ops->dev_close)(dev);
906 rte_cryptodev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
907 const struct rte_cryptodev_qp_conf *qp_conf, int socket_id,
908 struct rte_mempool *session_pool)
911 struct rte_cryptodev *dev;
913 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
914 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
918 dev = &rte_crypto_devices[dev_id];
919 if (queue_pair_id >= dev->data->nb_queue_pairs) {
920 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
924 if (dev->data->dev_started) {
926 "device %d must be stopped to allow configuration", dev_id);
930 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_setup, -ENOTSUP);
932 return (*dev->dev_ops->queue_pair_setup)(dev, queue_pair_id, qp_conf,
933 socket_id, session_pool);
938 rte_cryptodev_stats_get(uint8_t dev_id, struct rte_cryptodev_stats *stats)
940 struct rte_cryptodev *dev;
942 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
943 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
948 CDEV_LOG_ERR("Invalid stats ptr");
952 dev = &rte_crypto_devices[dev_id];
953 memset(stats, 0, sizeof(*stats));
955 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->stats_get, -ENOTSUP);
956 (*dev->dev_ops->stats_get)(dev, stats);
961 rte_cryptodev_stats_reset(uint8_t dev_id)
963 struct rte_cryptodev *dev;
965 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
966 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
970 dev = &rte_crypto_devices[dev_id];
972 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->stats_reset);
973 (*dev->dev_ops->stats_reset)(dev);
978 rte_cryptodev_info_get(uint8_t dev_id, struct rte_cryptodev_info *dev_info)
980 struct rte_cryptodev *dev;
982 if (dev_id >= cryptodev_globals.nb_devs) {
983 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
987 dev = &rte_crypto_devices[dev_id];
989 memset(dev_info, 0, sizeof(struct rte_cryptodev_info));
991 RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_infos_get);
992 (*dev->dev_ops->dev_infos_get)(dev, dev_info);
994 dev_info->driver_name = dev->device->driver->name;
999 rte_cryptodev_callback_register(uint8_t dev_id,
1000 enum rte_cryptodev_event_type event,
1001 rte_cryptodev_cb_fn cb_fn, void *cb_arg)
1003 struct rte_cryptodev *dev;
1004 struct rte_cryptodev_callback *user_cb;
1009 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1010 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
1014 dev = &rte_crypto_devices[dev_id];
1015 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1017 TAILQ_FOREACH(user_cb, &(dev->link_intr_cbs), next) {
1018 if (user_cb->cb_fn == cb_fn &&
1019 user_cb->cb_arg == cb_arg &&
1020 user_cb->event == event) {
1025 /* create a new callback. */
1026 if (user_cb == NULL) {
1027 user_cb = rte_zmalloc("INTR_USER_CALLBACK",
1028 sizeof(struct rte_cryptodev_callback), 0);
1029 if (user_cb != NULL) {
1030 user_cb->cb_fn = cb_fn;
1031 user_cb->cb_arg = cb_arg;
1032 user_cb->event = event;
1033 TAILQ_INSERT_TAIL(&(dev->link_intr_cbs), user_cb, next);
1037 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1038 return (user_cb == NULL) ? -ENOMEM : 0;
1042 rte_cryptodev_callback_unregister(uint8_t dev_id,
1043 enum rte_cryptodev_event_type event,
1044 rte_cryptodev_cb_fn cb_fn, void *cb_arg)
1047 struct rte_cryptodev *dev;
1048 struct rte_cryptodev_callback *cb, *next;
1053 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1054 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
1058 dev = &rte_crypto_devices[dev_id];
1059 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1062 for (cb = TAILQ_FIRST(&dev->link_intr_cbs); cb != NULL; cb = next) {
1064 next = TAILQ_NEXT(cb, next);
1066 if (cb->cb_fn != cb_fn || cb->event != event ||
1067 (cb->cb_arg != (void *)-1 &&
1068 cb->cb_arg != cb_arg))
1072 * if this callback is not executing right now,
1075 if (cb->active == 0) {
1076 TAILQ_REMOVE(&(dev->link_intr_cbs), cb, next);
1083 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1088 rte_cryptodev_pmd_callback_process(struct rte_cryptodev *dev,
1089 enum rte_cryptodev_event_type event)
1091 struct rte_cryptodev_callback *cb_lst;
1092 struct rte_cryptodev_callback dev_cb;
1094 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1095 TAILQ_FOREACH(cb_lst, &(dev->link_intr_cbs), next) {
1096 if (cb_lst->cb_fn == NULL || cb_lst->event != event)
1100 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1101 dev_cb.cb_fn(dev->data->dev_id, dev_cb.event,
1103 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1106 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1111 rte_cryptodev_sym_session_init(uint8_t dev_id,
1112 struct rte_cryptodev_sym_session *sess,
1113 struct rte_crypto_sym_xform *xforms,
1114 struct rte_mempool *mp)
1116 struct rte_cryptodev *dev;
1120 dev = rte_cryptodev_pmd_get_dev(dev_id);
1122 if (sess == NULL || xforms == NULL || dev == NULL)
1125 index = dev->driver_id;
1127 if (sess->sess_private_data[index] == NULL) {
1128 ret = dev->dev_ops->session_configure(dev, xforms, sess, mp);
1131 "dev_id %d failed to configure session details",
1140 struct rte_cryptodev_sym_session *
1141 rte_cryptodev_sym_session_create(struct rte_mempool *mp)
1143 struct rte_cryptodev_sym_session *sess;
1145 /* Allocate a session structure from the session pool */
1146 if (rte_mempool_get(mp, (void **)&sess)) {
1147 CDEV_LOG_ERR("couldn't get object from session mempool");
1151 /* Clear device session pointer */
1152 memset(sess, 0, (sizeof(void *) * nb_drivers));
1158 rte_cryptodev_queue_pair_attach_sym_session(uint8_t dev_id, uint16_t qp_id,
1159 struct rte_cryptodev_sym_session *sess)
1161 struct rte_cryptodev *dev;
1163 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1164 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
1168 dev = &rte_crypto_devices[dev_id];
1170 /* The API is optional, not returning error if driver do not suuport */
1171 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->qp_attach_session, 0);
1173 void *sess_priv = get_session_private_data(sess, dev->driver_id);
1175 if (dev->dev_ops->qp_attach_session(dev, qp_id, sess_priv)) {
1176 CDEV_LOG_ERR("dev_id %d failed to attach qp: %d with session",
1185 rte_cryptodev_queue_pair_detach_sym_session(uint8_t dev_id, uint16_t qp_id,
1186 struct rte_cryptodev_sym_session *sess)
1188 struct rte_cryptodev *dev;
1190 if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1191 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
1195 dev = &rte_crypto_devices[dev_id];
1197 /* The API is optional, not returning error if driver do not suuport */
1198 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->qp_detach_session, 0);
1200 void *sess_priv = get_session_private_data(sess, dev->driver_id);
1202 if (dev->dev_ops->qp_detach_session(dev, qp_id, sess_priv)) {
1203 CDEV_LOG_ERR("dev_id %d failed to detach qp: %d from session",
1212 rte_cryptodev_sym_session_clear(uint8_t dev_id,
1213 struct rte_cryptodev_sym_session *sess)
1215 struct rte_cryptodev *dev;
1217 dev = rte_cryptodev_pmd_get_dev(dev_id);
1219 if (dev == NULL || sess == NULL)
1222 dev->dev_ops->session_clear(dev, sess);
1228 rte_cryptodev_sym_session_free(struct rte_cryptodev_sym_session *sess)
1232 struct rte_mempool *sess_mp;
1237 /* Check that all device private data has been freed */
1238 for (i = 0; i < nb_drivers; i++) {
1239 sess_priv = get_session_private_data(sess, i);
1240 if (sess_priv != NULL)
1244 /* Return session to mempool */
1245 sess_mp = rte_mempool_from_obj(sess);
1246 rte_mempool_put(sess_mp, sess);
1252 rte_cryptodev_get_header_session_size(void)
1255 * Header contains pointers to the private data
1256 * of all registered drivers
1258 return (sizeof(void *) * nb_drivers);
1262 rte_cryptodev_get_private_session_size(uint8_t dev_id)
1264 struct rte_cryptodev *dev;
1265 unsigned int header_size = sizeof(void *) * nb_drivers;
1266 unsigned int priv_sess_size;
1268 if (!rte_cryptodev_pmd_is_valid_dev(dev_id))
1271 dev = rte_cryptodev_pmd_get_dev(dev_id);
1273 if (*dev->dev_ops->session_get_size == NULL)
1276 priv_sess_size = (*dev->dev_ops->session_get_size)(dev);
1279 * If size is less than session header size,
1280 * return the latter, as this guarantees that
1281 * sessionless operations will work
1283 if (priv_sess_size < header_size)
1286 return priv_sess_size;
1290 /** Initialise rte_crypto_op mempool element */
1292 rte_crypto_op_init(struct rte_mempool *mempool,
1295 __rte_unused unsigned i)
1297 struct rte_crypto_op *op = _op_data;
1298 enum rte_crypto_op_type type = *(enum rte_crypto_op_type *)opaque_arg;
1300 memset(_op_data, 0, mempool->elt_size);
1302 __rte_crypto_op_reset(op, type);
1304 op->phys_addr = rte_mem_virt2iova(_op_data);
1305 op->mempool = mempool;
1309 struct rte_mempool *
1310 rte_crypto_op_pool_create(const char *name, enum rte_crypto_op_type type,
1311 unsigned nb_elts, unsigned cache_size, uint16_t priv_size,
1314 struct rte_crypto_op_pool_private *priv;
1316 unsigned elt_size = sizeof(struct rte_crypto_op) +
1317 sizeof(struct rte_crypto_sym_op) +
1320 /* lookup mempool in case already allocated */
1321 struct rte_mempool *mp = rte_mempool_lookup(name);
1324 priv = (struct rte_crypto_op_pool_private *)
1325 rte_mempool_get_priv(mp);
1327 if (mp->elt_size != elt_size ||
1328 mp->cache_size < cache_size ||
1329 mp->size < nb_elts ||
1330 priv->priv_size < priv_size) {
1332 CDEV_LOG_ERR("Mempool %s already exists but with "
1333 "incompatible parameters", name);
1339 mp = rte_mempool_create(
1344 sizeof(struct rte_crypto_op_pool_private),
1353 CDEV_LOG_ERR("Failed to create mempool %s", name);
1357 priv = (struct rte_crypto_op_pool_private *)
1358 rte_mempool_get_priv(mp);
1360 priv->priv_size = priv_size;
1367 rte_cryptodev_pmd_create_dev_name(char *name, const char *dev_name_prefix)
1369 struct rte_cryptodev *dev = NULL;
1375 for (i = 0; i < RTE_CRYPTO_MAX_DEVS; i++) {
1376 int ret = snprintf(name, RTE_CRYPTODEV_NAME_MAX_LEN,
1377 "%s_%u", dev_name_prefix, i);
1382 dev = rte_cryptodev_pmd_get_named_dev(name);
1390 TAILQ_HEAD(cryptodev_driver_list, cryptodev_driver);
1392 static struct cryptodev_driver_list cryptodev_driver_list =
1393 TAILQ_HEAD_INITIALIZER(cryptodev_driver_list);
1396 rte_cryptodev_driver_id_get(const char *name)
1398 struct cryptodev_driver *driver;
1399 const char *driver_name;
1402 RTE_LOG(DEBUG, CRYPTODEV, "name pointer NULL");
1406 TAILQ_FOREACH(driver, &cryptodev_driver_list, next) {
1407 driver_name = driver->driver->name;
1408 if (strncmp(driver_name, name, strlen(driver_name)) == 0)
1415 rte_cryptodev_name_get(uint8_t dev_id)
1417 struct rte_cryptodev *dev = rte_cryptodev_pmd_get_dev(dev_id);
1422 return dev->data->name;
1426 rte_cryptodev_driver_name_get(uint8_t driver_id)
1428 struct cryptodev_driver *driver;
1430 TAILQ_FOREACH(driver, &cryptodev_driver_list, next)
1431 if (driver->id == driver_id)
1432 return driver->driver->name;
1437 rte_cryptodev_allocate_driver(struct cryptodev_driver *crypto_drv,
1438 const struct rte_driver *drv)
1440 crypto_drv->driver = drv;
1441 crypto_drv->id = nb_drivers;
1443 TAILQ_INSERT_TAIL(&cryptodev_driver_list, crypto_drv, next);
1445 return nb_drivers++;