lib/librte_cryptodev/rte_cryptodev.c

   1 /*-
   2  *   BSD LICENSE
   3  *
   4  *   Copyright(c) 2015-2017 Intel Corporation. All rights reserved.
   5  *
   6  *   Redistribution and use in source and binary forms, with or without
   7  *   modification, are permitted provided that the following conditions
   8  *   are met:
   9  *
  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
  15  *       distribution.
  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.
  19  *
  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.
  31  */
  32
  33 #include <sys/types.h>
  34 #include <sys/queue.h>
  35 #include <ctype.h>
  36 #include <stdio.h>
  37 #include <stdlib.h>
  38 #include <string.h>
  39 #include <stdarg.h>
  40 #include <errno.h>
  41 #include <stdint.h>
  42 #include <inttypes.h>
  43 #include <netinet/in.h>
  44
  45 #include <rte_byteorder.h>
  46 #include <rte_log.h>
  47 #include <rte_debug.h>
  48 #include <rte_dev.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>
  55 #include <rte_eal.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>
  63 #include <rte_mbuf.h>
  64 #include <rte_errno.h>
  65 #include <rte_spinlock.h>
  66 #include <rte_string_fns.h>
  67
  68 #include "rte_crypto.h"
  69 #include "rte_cryptodev.h"
  70 #include "rte_cryptodev_pmd.h"
  71
  72 struct rte_cryptodev rte_crypto_devices[RTE_CRYPTO_MAX_DEVS];
  73
  74 struct rte_cryptodev *rte_cryptodevs = &rte_crypto_devices[0];
  75
  76 static struct rte_cryptodev_global cryptodev_globals = {
  77                 .devs                   = &rte_crypto_devices[0],
  78                 .data                   = { NULL },
  79                 .nb_devs                = 0,
  80                 .max_devs               = RTE_CRYPTO_MAX_DEVS
  81 };
  82
  83 struct rte_cryptodev_global *rte_cryptodev_globals = &cryptodev_globals;
  84
  85 /* spinlock for crypto device callbacks */
  86 static rte_spinlock_t rte_cryptodev_cb_lock = RTE_SPINLOCK_INITIALIZER;
  87
  88
  89 /**
  90  * The user application callback description.
  91  *
  92  * It contains callback address to be registered by user application,
  93  * the pointer to the parameters for callback, and the event type.
  94  */
  95 struct rte_cryptodev_callback {
  96         TAILQ_ENTRY(rte_cryptodev_callback) next; /**< Callbacks list */
  97         rte_cryptodev_cb_fn cb_fn;              /**< Callback address */
  98         void *cb_arg;                           /**< Parameter for callback */
  99         enum rte_cryptodev_event_type event;    /**< Interrupt event type */
 100         uint32_t active;                        /**< Callback is executing */
 101 };
 102
 103 /**
 104  * The crypto cipher algorithm strings identifiers.
 105  * It could be used in application command line.
 106  */
 107 const char *
 108 rte_crypto_cipher_algorithm_strings[] = {
 109         [RTE_CRYPTO_CIPHER_3DES_CBC]    = "3des-cbc",
 110         [RTE_CRYPTO_CIPHER_3DES_ECB]    = "3des-ecb",
 111         [RTE_CRYPTO_CIPHER_3DES_CTR]    = "3des-ctr",
 112
 113         [RTE_CRYPTO_CIPHER_AES_CBC]     = "aes-cbc",
 114         [RTE_CRYPTO_CIPHER_AES_CCM]     = "aes-ccm",
 115         [RTE_CRYPTO_CIPHER_AES_CTR]     = "aes-ctr",
 116         [RTE_CRYPTO_CIPHER_AES_DOCSISBPI]       = "aes-docsisbpi",
 117         [RTE_CRYPTO_CIPHER_AES_ECB]     = "aes-ecb",
 118         [RTE_CRYPTO_CIPHER_AES_GCM]     = "aes-gcm",
 119         [RTE_CRYPTO_CIPHER_AES_F8]      = "aes-f8",
 120         [RTE_CRYPTO_CIPHER_AES_XTS]     = "aes-xts",
 121
 122         [RTE_CRYPTO_CIPHER_ARC4]        = "arc4",
 123
 124         [RTE_CRYPTO_CIPHER_DES_CBC]     = "des-cbc",
 125         [RTE_CRYPTO_CIPHER_DES_DOCSISBPI]       = "des-docsisbpi",
 126
 127         [RTE_CRYPTO_CIPHER_NULL]        = "null",
 128
 129         [RTE_CRYPTO_CIPHER_KASUMI_F8]   = "kasumi-f8",
 130         [RTE_CRYPTO_CIPHER_SNOW3G_UEA2] = "snow3g-uea2",
 131         [RTE_CRYPTO_CIPHER_ZUC_EEA3]    = "zuc-eea3"
 132 };
 133
 134 /**
 135  * The crypto cipher operation strings identifiers.
 136  * It could be used in application command line.
 137  */
 138 const char *
 139 rte_crypto_cipher_operation_strings[] = {
 140                 [RTE_CRYPTO_CIPHER_OP_ENCRYPT]  = "encrypt",
 141                 [RTE_CRYPTO_CIPHER_OP_DECRYPT]  = "decrypt"
 142 };
 143
 144 /**
 145  * The crypto auth algorithm strings identifiers.
 146  * It could be used in application command line.
 147  */
 148 const char *
 149 rte_crypto_auth_algorithm_strings[] = {
 150         [RTE_CRYPTO_AUTH_AES_CBC_MAC]   = "aes-cbc-mac",
 151         [RTE_CRYPTO_AUTH_AES_CCM]       = "aes-ccm",
 152         [RTE_CRYPTO_AUTH_AES_CMAC]      = "aes-cmac",
 153         [RTE_CRYPTO_AUTH_AES_GCM]       = "aes-gcm",
 154         [RTE_CRYPTO_AUTH_AES_GMAC]      = "aes-gmac",
 155         [RTE_CRYPTO_AUTH_AES_XCBC_MAC]  = "aes-xcbc-mac",
 156
 157         [RTE_CRYPTO_AUTH_MD5]           = "md5",
 158         [RTE_CRYPTO_AUTH_MD5_HMAC]      = "md5-hmac",
 159
 160         [RTE_CRYPTO_AUTH_NULL]          = "null",
 161
 162         [RTE_CRYPTO_AUTH_SHA1]          = "sha1",
 163         [RTE_CRYPTO_AUTH_SHA1_HMAC]     = "sha1-hmac",
 164
 165         [RTE_CRYPTO_AUTH_SHA224]        = "sha2-224",
 166         [RTE_CRYPTO_AUTH_SHA224_HMAC]   = "sha2-224-hmac",
 167         [RTE_CRYPTO_AUTH_SHA256]        = "sha2-256",
 168         [RTE_CRYPTO_AUTH_SHA256_HMAC]   = "sha2-256-hmac",
 169         [RTE_CRYPTO_AUTH_SHA384]        = "sha2-384",
 170         [RTE_CRYPTO_AUTH_SHA384_HMAC]   = "sha2-384-hmac",
 171         [RTE_CRYPTO_AUTH_SHA512]        = "sha2-512",
 172         [RTE_CRYPTO_AUTH_SHA512_HMAC]   = "sha2-512-hmac",
 173
 174         [RTE_CRYPTO_AUTH_KASUMI_F9]     = "kasumi-f9",
 175         [RTE_CRYPTO_AUTH_SNOW3G_UIA2]   = "snow3g-uia2",
 176         [RTE_CRYPTO_AUTH_ZUC_EIA3]      = "zuc-eia3"
 177 };
 178
 179 int
 180 rte_cryptodev_get_cipher_algo_enum(enum rte_crypto_cipher_algorithm *algo_enum,
 181                 const char *algo_string)
 182 {
 183         unsigned int i;
 184
 185         for (i = 1; i < RTE_DIM(rte_crypto_cipher_algorithm_strings); i++) {
 186                 if (strcmp(algo_string, rte_crypto_cipher_algorithm_strings[i]) == 0) {
 187                         *algo_enum = (enum rte_crypto_cipher_algorithm) i;
 188                         return 0;
 189                 }
 190         }
 191
 192         /* Invalid string */
 193         return -1;
 194 }
 195
 196 int
 197 rte_cryptodev_get_auth_algo_enum(enum rte_crypto_auth_algorithm *algo_enum,
 198                 const char *algo_string)
 199 {
 200         unsigned int i;
 201
 202         for (i = 1; i < RTE_DIM(rte_crypto_auth_algorithm_strings); i++) {
 203                 if (strcmp(algo_string, rte_crypto_auth_algorithm_strings[i]) == 0) {
 204                         *algo_enum = (enum rte_crypto_auth_algorithm) i;
 205                         return 0;
 206                 }
 207         }
 208
 209         /* Invalid string */
 210         return -1;
 211 }
 212
 213 /**
 214  * The crypto auth operation strings identifiers.
 215  * It could be used in application command line.
 216  */
 217 const char *
 218 rte_crypto_auth_operation_strings[] = {
 219                 [RTE_CRYPTO_AUTH_OP_VERIFY]     = "verify",
 220                 [RTE_CRYPTO_AUTH_OP_GENERATE]   = "generate"
 221 };
 222
 223 const struct rte_cryptodev_symmetric_capability *
 224 rte_cryptodev_sym_capability_get(uint8_t dev_id,
 225                 const struct rte_cryptodev_sym_capability_idx *idx)
 226 {
 227         const struct rte_cryptodev_capabilities *capability;
 228         struct rte_cryptodev_info dev_info;
 229         int i = 0;
 230
 231         rte_cryptodev_info_get(dev_id, &dev_info);
 232
 233         while ((capability = &dev_info.capabilities[i++])->op !=
 234                         RTE_CRYPTO_OP_TYPE_UNDEFINED) {
 235                 if (capability->op != RTE_CRYPTO_OP_TYPE_SYMMETRIC)
 236                         continue;
 237
 238                 if (capability->sym.xform_type != idx->type)
 239                         continue;
 240
 241                 if (idx->type == RTE_CRYPTO_SYM_XFORM_AUTH &&
 242                         capability->sym.auth.algo == idx->algo.auth)
 243                         return &capability->sym;
 244
 245                 if (idx->type == RTE_CRYPTO_SYM_XFORM_CIPHER &&
 246                         capability->sym.cipher.algo == idx->algo.cipher)
 247                         return &capability->sym;
 248         }
 249
 250         return NULL;
 251
 252 }
 253
 254 #define param_range_check(x, y) \
 255         (((x < y.min) || (x > y.max)) || \
 256         (y.increment != 0 && (x % y.increment) != 0))
 257
 258 int
 259 rte_cryptodev_sym_capability_check_cipher(
 260                 const struct rte_cryptodev_symmetric_capability *capability,
 261                 uint16_t key_size, uint16_t iv_size)
 262 {
 263         if (param_range_check(key_size, capability->cipher.key_size))
 264                 return -1;
 265
 266         if (param_range_check(iv_size, capability->cipher.iv_size))
 267                 return -1;
 268
 269         return 0;
 270 }
 271
 272 int
 273 rte_cryptodev_sym_capability_check_auth(
 274                 const struct rte_cryptodev_symmetric_capability *capability,
 275                 uint16_t key_size, uint16_t digest_size, uint16_t aad_size,
 276                 uint16_t iv_size)
 277 {
 278         if (param_range_check(key_size, capability->auth.key_size))
 279                 return -1;
 280
 281         if (param_range_check(digest_size, capability->auth.digest_size))
 282                 return -1;
 283
 284         if (param_range_check(aad_size, capability->auth.aad_size))
 285                 return -1;
 286
 287         if (param_range_check(iv_size, capability->auth.iv_size))
 288                 return -1;
 289
 290         return 0;
 291 }
 292
 293
 294 const char *
 295 rte_cryptodev_get_feature_name(uint64_t flag)
 296 {
 297         switch (flag) {
 298         case RTE_CRYPTODEV_FF_SYMMETRIC_CRYPTO:
 299                 return "SYMMETRIC_CRYPTO";
 300         case RTE_CRYPTODEV_FF_ASYMMETRIC_CRYPTO:
 301                 return "ASYMMETRIC_CRYPTO";
 302         case RTE_CRYPTODEV_FF_SYM_OPERATION_CHAINING:
 303                 return "SYM_OPERATION_CHAINING";
 304         case RTE_CRYPTODEV_FF_CPU_SSE:
 305                 return "CPU_SSE";
 306         case RTE_CRYPTODEV_FF_CPU_AVX:
 307                 return "CPU_AVX";
 308         case RTE_CRYPTODEV_FF_CPU_AVX2:
 309                 return "CPU_AVX2";
 310         case RTE_CRYPTODEV_FF_CPU_AESNI:
 311                 return "CPU_AESNI";
 312         case RTE_CRYPTODEV_FF_HW_ACCELERATED:
 313                 return "HW_ACCELERATED";
 314         case RTE_CRYPTODEV_FF_MBUF_SCATTER_GATHER:
 315                 return "MBUF_SCATTER_GATHER";
 316         case RTE_CRYPTODEV_FF_CPU_NEON:
 317                 return "CPU_NEON";
 318         case RTE_CRYPTODEV_FF_CPU_ARM_CE:
 319                 return "CPU_ARM_CE";
 320         default:
 321                 return NULL;
 322         }
 323 }
 324
 325 int
 326 rte_cryptodev_create_vdev(const char *name, const char *args)
 327 {
 328         return rte_vdev_init(name, args);
 329 }
 330
 331 struct rte_cryptodev *
 332 rte_cryptodev_pmd_get_dev(uint8_t dev_id)
 333 {
 334         return &rte_cryptodev_globals->devs[dev_id];
 335 }
 336
 337 struct rte_cryptodev *
 338 rte_cryptodev_pmd_get_named_dev(const char *name)
 339 {
 340         struct rte_cryptodev *dev;
 341         unsigned int i;
 342
 343         if (name == NULL)
 344                 return NULL;
 345
 346         for (i = 0; i < rte_cryptodev_globals->max_devs; i++) {
 347                 dev = &rte_cryptodev_globals->devs[i];
 348
 349                 if ((dev->attached == RTE_CRYPTODEV_ATTACHED) &&
 350                                 (strcmp(dev->data->name, name) == 0))
 351                         return dev;
 352         }
 353
 354         return NULL;
 355 }
 356
 357 unsigned int
 358 rte_cryptodev_pmd_is_valid_dev(uint8_t dev_id)
 359 {
 360         struct rte_cryptodev *dev = NULL;
 361
 362         if (dev_id >= rte_cryptodev_globals->nb_devs)
 363                 return 0;
 364
 365         dev = rte_cryptodev_pmd_get_dev(dev_id);
 366         if (dev->attached != RTE_CRYPTODEV_ATTACHED)
 367                 return 0;
 368         else
 369                 return 1;
 370 }
 371
 372
 373 int
 374 rte_cryptodev_get_dev_id(const char *name)
 375 {
 376         unsigned i;
 377
 378         if (name == NULL)
 379                 return -1;
 380
 381         for (i = 0; i < rte_cryptodev_globals->nb_devs; i++)
 382                 if ((strcmp(rte_cryptodev_globals->devs[i].data->name, name)
 383                                 == 0) &&
 384                                 (rte_cryptodev_globals->devs[i].attached ==
 385                                                 RTE_CRYPTODEV_ATTACHED))
 386                         return i;
 387
 388         return -1;
 389 }
 390
 391 uint8_t
 392 rte_cryptodev_count(void)
 393 {
 394         return rte_cryptodev_globals->nb_devs;
 395 }
 396
 397 uint8_t
 398 rte_cryptodev_count_devtype(enum rte_cryptodev_type type)
 399 {
 400         uint8_t i, dev_count = 0;
 401
 402         for (i = 0; i < rte_cryptodev_globals->max_devs; i++)
 403                 if (rte_cryptodev_globals->devs[i].dev_type == type &&
 404                         rte_cryptodev_globals->devs[i].attached ==
 405                                         RTE_CRYPTODEV_ATTACHED)
 406                         dev_count++;
 407
 408         return dev_count;
 409 }
 410
 411 uint8_t
 412 rte_cryptodev_devices_get(const char *driver_name, uint8_t *devices,
 413         uint8_t nb_devices)
 414 {
 415         uint8_t i, count = 0;
 416         struct rte_cryptodev *devs = rte_cryptodev_globals->devs;
 417         uint8_t max_devs = rte_cryptodev_globals->max_devs;
 418
 419         for (i = 0; i < max_devs && count < nb_devices; i++) {
 420
 421                 if (devs[i].attached == RTE_CRYPTODEV_ATTACHED) {
 422                         int cmp;
 423
 424                         cmp = strncmp(devs[i].device->driver->name,
 425                                         driver_name,
 426                                         strlen(driver_name));
 427
 428                         if (cmp == 0)
 429                                 devices[count++] = devs[i].data->dev_id;
 430                 }
 431         }
 432
 433         return count;
 434 }
 435
 436 int
 437 rte_cryptodev_socket_id(uint8_t dev_id)
 438 {
 439         struct rte_cryptodev *dev;
 440
 441         if (!rte_cryptodev_pmd_is_valid_dev(dev_id))
 442                 return -1;
 443
 444         dev = rte_cryptodev_pmd_get_dev(dev_id);
 445
 446         return dev->data->socket_id;
 447 }
 448
 449 static inline int
 450 rte_cryptodev_data_alloc(uint8_t dev_id, struct rte_cryptodev_data **data,
 451                 int socket_id)
 452 {
 453         char mz_name[RTE_CRYPTODEV_NAME_MAX_LEN];
 454         const struct rte_memzone *mz;
 455         int n;
 456
 457         /* generate memzone name */
 458         n = snprintf(mz_name, sizeof(mz_name), "rte_cryptodev_data_%u", dev_id);
 459         if (n >= (int)sizeof(mz_name))
 460                 return -EINVAL;
 461
 462         if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
 463                 mz = rte_memzone_reserve(mz_name,
 464                                 sizeof(struct rte_cryptodev_data),
 465                                 socket_id, 0);
 466         } else
 467                 mz = rte_memzone_lookup(mz_name);
 468
 469         if (mz == NULL)
 470                 return -ENOMEM;
 471
 472         *data = mz->addr;
 473         if (rte_eal_process_type() == RTE_PROC_PRIMARY)
 474                 memset(*data, 0, sizeof(struct rte_cryptodev_data));
 475
 476         return 0;
 477 }
 478
 479 static uint8_t
 480 rte_cryptodev_find_free_device_index(void)
 481 {
 482         uint8_t dev_id;
 483
 484         for (dev_id = 0; dev_id < RTE_CRYPTO_MAX_DEVS; dev_id++) {
 485                 if (rte_crypto_devices[dev_id].attached ==
 486                                 RTE_CRYPTODEV_DETACHED)
 487                         return dev_id;
 488         }
 489         return RTE_CRYPTO_MAX_DEVS;
 490 }
 491
 492 struct rte_cryptodev *
 493 rte_cryptodev_pmd_allocate(const char *name, int socket_id)
 494 {
 495         struct rte_cryptodev *cryptodev;
 496         uint8_t dev_id;
 497
 498         if (rte_cryptodev_pmd_get_named_dev(name) != NULL) {
 499                 CDEV_LOG_ERR("Crypto device with name %s already "
 500                                 "allocated!", name);
 501                 return NULL;
 502         }
 503
 504         dev_id = rte_cryptodev_find_free_device_index();
 505         if (dev_id == RTE_CRYPTO_MAX_DEVS) {
 506                 CDEV_LOG_ERR("Reached maximum number of crypto devices");
 507                 return NULL;
 508         }
 509
 510         cryptodev = rte_cryptodev_pmd_get_dev(dev_id);
 511
 512         if (cryptodev->data == NULL) {
 513                 struct rte_cryptodev_data *cryptodev_data =
 514                                 cryptodev_globals.data[dev_id];
 515
 516                 int retval = rte_cryptodev_data_alloc(dev_id, &cryptodev_data,
 517                                 socket_id);
 518
 519                 if (retval < 0 || cryptodev_data == NULL)
 520                         return NULL;
 521
 522                 cryptodev->data = cryptodev_data;
 523
 524                 snprintf(cryptodev->data->name, RTE_CRYPTODEV_NAME_MAX_LEN,
 525                                 "%s", name);
 526
 527                 cryptodev->data->dev_id = dev_id;
 528                 cryptodev->data->socket_id = socket_id;
 529                 cryptodev->data->dev_started = 0;
 530
 531                 cryptodev->attached = RTE_CRYPTODEV_ATTACHED;
 532
 533                 cryptodev_globals.nb_devs++;
 534         }
 535
 536         return cryptodev;
 537 }
 538
 539 int
 540 rte_cryptodev_pmd_release_device(struct rte_cryptodev *cryptodev)
 541 {
 542         int ret;
 543
 544         if (cryptodev == NULL)
 545                 return -EINVAL;
 546
 547         /* Close device only if device operations have been set */
 548         if (cryptodev->dev_ops) {
 549                 ret = rte_cryptodev_close(cryptodev->data->dev_id);
 550                 if (ret < 0)
 551                         return ret;
 552         }
 553
 554         cryptodev->attached = RTE_CRYPTODEV_DETACHED;
 555         cryptodev_globals.nb_devs--;
 556         return 0;
 557 }
 558
 559 uint16_t
 560 rte_cryptodev_queue_pair_count(uint8_t dev_id)
 561 {
 562         struct rte_cryptodev *dev;
 563
 564         dev = &rte_crypto_devices[dev_id];
 565         return dev->data->nb_queue_pairs;
 566 }
 567
 568 static int
 569 rte_cryptodev_queue_pairs_config(struct rte_cryptodev *dev, uint16_t nb_qpairs,
 570                 int socket_id)
 571 {
 572         struct rte_cryptodev_info dev_info;
 573         void **qp;
 574         unsigned i;
 575
 576         if ((dev == NULL) || (nb_qpairs < 1)) {
 577                 CDEV_LOG_ERR("invalid param: dev %p, nb_queues %u",
 578                                                         dev, nb_qpairs);
 579                 return -EINVAL;
 580         }
 581
 582         CDEV_LOG_DEBUG("Setup %d queues pairs on device %u",
 583                         nb_qpairs, dev->data->dev_id);
 584
 585         memset(&dev_info, 0, sizeof(struct rte_cryptodev_info));
 586
 587         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
 588         (*dev->dev_ops->dev_infos_get)(dev, &dev_info);
 589
 590         if (nb_qpairs > (dev_info.max_nb_queue_pairs)) {
 591                 CDEV_LOG_ERR("Invalid num queue_pairs (%u) for dev %u",
 592                                 nb_qpairs, dev->data->dev_id);
 593             return -EINVAL;
 594         }
 595
 596         if (dev->data->queue_pairs == NULL) { /* first time configuration */
 597                 dev->data->queue_pairs = rte_zmalloc_socket(
 598                                 "cryptodev->queue_pairs",
 599                                 sizeof(dev->data->queue_pairs[0]) * nb_qpairs,
 600                                 RTE_CACHE_LINE_SIZE, socket_id);
 601
 602                 if (dev->data->queue_pairs == NULL) {
 603                         dev->data->nb_queue_pairs = 0;
 604                         CDEV_LOG_ERR("failed to get memory for qp meta data, "
 605                                                         "nb_queues %u",
 606                                                         nb_qpairs);
 607                         return -(ENOMEM);
 608                 }
 609         } else { /* re-configure */
 610                 int ret;
 611                 uint16_t old_nb_queues = dev->data->nb_queue_pairs;
 612
 613                 qp = dev->data->queue_pairs;
 614
 615                 RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_release,
 616                                 -ENOTSUP);
 617
 618                 for (i = nb_qpairs; i < old_nb_queues; i++) {
 619                         ret = (*dev->dev_ops->queue_pair_release)(dev, i);
 620                         if (ret < 0)
 621                                 return ret;
 622                 }
 623
 624                 qp = rte_realloc(qp, sizeof(qp[0]) * nb_qpairs,
 625                                 RTE_CACHE_LINE_SIZE);
 626                 if (qp == NULL) {
 627                         CDEV_LOG_ERR("failed to realloc qp meta data,"
 628                                                 " nb_queues %u", nb_qpairs);
 629                         return -(ENOMEM);
 630                 }
 631
 632                 if (nb_qpairs > old_nb_queues) {
 633                         uint16_t new_qs = nb_qpairs - old_nb_queues;
 634
 635                         memset(qp + old_nb_queues, 0,
 636                                 sizeof(qp[0]) * new_qs);
 637                 }
 638
 639                 dev->data->queue_pairs = qp;
 640
 641         }
 642         dev->data->nb_queue_pairs = nb_qpairs;
 643         return 0;
 644 }
 645
 646 int
 647 rte_cryptodev_queue_pair_start(uint8_t dev_id, uint16_t queue_pair_id)
 648 {
 649         struct rte_cryptodev *dev;
 650
 651         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 652                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 653                 return -EINVAL;
 654         }
 655
 656         dev = &rte_crypto_devices[dev_id];
 657         if (queue_pair_id >= dev->data->nb_queue_pairs) {
 658                 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
 659                 return -EINVAL;
 660         }
 661
 662         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_start, -ENOTSUP);
 663
 664         return dev->dev_ops->queue_pair_start(dev, queue_pair_id);
 665
 666 }
 667
 668 int
 669 rte_cryptodev_queue_pair_stop(uint8_t dev_id, uint16_t queue_pair_id)
 670 {
 671         struct rte_cryptodev *dev;
 672
 673         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 674                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 675                 return -EINVAL;
 676         }
 677
 678         dev = &rte_crypto_devices[dev_id];
 679         if (queue_pair_id >= dev->data->nb_queue_pairs) {
 680                 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
 681                 return -EINVAL;
 682         }
 683
 684         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_stop, -ENOTSUP);
 685
 686         return dev->dev_ops->queue_pair_stop(dev, queue_pair_id);
 687
 688 }
 689
 690 static int
 691 rte_cryptodev_sym_session_pool_create(struct rte_cryptodev *dev,
 692                 unsigned nb_objs, unsigned obj_cache_size, int socket_id);
 693
 694 int
 695 rte_cryptodev_configure(uint8_t dev_id, struct rte_cryptodev_config *config)
 696 {
 697         struct rte_cryptodev *dev;
 698         int diag;
 699
 700         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 701                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 702                 return -EINVAL;
 703         }
 704
 705         dev = &rte_crypto_devices[dev_id];
 706
 707         if (dev->data->dev_started) {
 708                 CDEV_LOG_ERR(
 709                     "device %d must be stopped to allow configuration", dev_id);
 710                 return -EBUSY;
 711         }
 712
 713         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP);
 714
 715         /* Setup new number of queue pairs and reconfigure device. */
 716         diag = rte_cryptodev_queue_pairs_config(dev, config->nb_queue_pairs,
 717                         config->socket_id);
 718         if (diag != 0) {
 719                 CDEV_LOG_ERR("dev%d rte_crypto_dev_queue_pairs_config = %d",
 720                                 dev_id, diag);
 721                 return diag;
 722         }
 723
 724         /* Setup Session mempool for device */
 725         diag = rte_cryptodev_sym_session_pool_create(dev,
 726                         config->session_mp.nb_objs,
 727                         config->session_mp.cache_size,
 728                         config->socket_id);
 729         if (diag != 0)
 730                 return diag;
 731
 732         return (*dev->dev_ops->dev_configure)(dev, config);
 733 }
 734
 735
 736 int
 737 rte_cryptodev_start(uint8_t dev_id)
 738 {
 739         struct rte_cryptodev *dev;
 740         int diag;
 741
 742         CDEV_LOG_DEBUG("Start dev_id=%" PRIu8, dev_id);
 743
 744         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 745                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 746                 return -EINVAL;
 747         }
 748
 749         dev = &rte_crypto_devices[dev_id];
 750
 751         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP);
 752
 753         if (dev->data->dev_started != 0) {
 754                 CDEV_LOG_ERR("Device with dev_id=%" PRIu8 " already started",
 755                         dev_id);
 756                 return 0;
 757         }
 758
 759         diag = (*dev->dev_ops->dev_start)(dev);
 760         if (diag == 0)
 761                 dev->data->dev_started = 1;
 762         else
 763                 return diag;
 764
 765         return 0;
 766 }
 767
 768 void
 769 rte_cryptodev_stop(uint8_t dev_id)
 770 {
 771         struct rte_cryptodev *dev;
 772
 773         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 774                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 775                 return;
 776         }
 777
 778         dev = &rte_crypto_devices[dev_id];
 779
 780         RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop);
 781
 782         if (dev->data->dev_started == 0) {
 783                 CDEV_LOG_ERR("Device with dev_id=%" PRIu8 " already stopped",
 784                         dev_id);
 785                 return;
 786         }
 787
 788         (*dev->dev_ops->dev_stop)(dev);
 789         dev->data->dev_started = 0;
 790 }
 791
 792 int
 793 rte_cryptodev_close(uint8_t dev_id)
 794 {
 795         struct rte_cryptodev *dev;
 796         int retval;
 797
 798         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 799                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 800                 return -1;
 801         }
 802
 803         dev = &rte_crypto_devices[dev_id];
 804
 805         /* Device must be stopped before it can be closed */
 806         if (dev->data->dev_started == 1) {
 807                 CDEV_LOG_ERR("Device %u must be stopped before closing",
 808                                 dev_id);
 809                 return -EBUSY;
 810         }
 811
 812         /* We can't close the device if there are outstanding sessions in use */
 813         if (dev->data->session_pool != NULL) {
 814                 if (!rte_mempool_full(dev->data->session_pool)) {
 815                         CDEV_LOG_ERR("dev_id=%u close failed, session mempool "
 816                                         "has sessions still in use, free "
 817                                         "all sessions before calling close",
 818                                         (unsigned)dev_id);
 819                         return -EBUSY;
 820                 }
 821         }
 822
 823         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_close, -ENOTSUP);
 824         retval = (*dev->dev_ops->dev_close)(dev);
 825
 826         if (retval < 0)
 827                 return retval;
 828
 829         return 0;
 830 }
 831
 832 int
 833 rte_cryptodev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
 834                 const struct rte_cryptodev_qp_conf *qp_conf, int socket_id)
 835 {
 836         struct rte_cryptodev *dev;
 837
 838         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 839                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 840                 return -EINVAL;
 841         }
 842
 843         dev = &rte_crypto_devices[dev_id];
 844         if (queue_pair_id >= dev->data->nb_queue_pairs) {
 845                 CDEV_LOG_ERR("Invalid queue_pair_id=%d", queue_pair_id);
 846                 return -EINVAL;
 847         }
 848
 849         if (dev->data->dev_started) {
 850                 CDEV_LOG_ERR(
 851                     "device %d must be stopped to allow configuration", dev_id);
 852                 return -EBUSY;
 853         }
 854
 855         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_pair_setup, -ENOTSUP);
 856
 857         return (*dev->dev_ops->queue_pair_setup)(dev, queue_pair_id, qp_conf,
 858                         socket_id);
 859 }
 860
 861
 862 int
 863 rte_cryptodev_stats_get(uint8_t dev_id, struct rte_cryptodev_stats *stats)
 864 {
 865         struct rte_cryptodev *dev;
 866
 867         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 868                 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
 869                 return -ENODEV;
 870         }
 871
 872         if (stats == NULL) {
 873                 CDEV_LOG_ERR("Invalid stats ptr");
 874                 return -EINVAL;
 875         }
 876
 877         dev = &rte_crypto_devices[dev_id];
 878         memset(stats, 0, sizeof(*stats));
 879
 880         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->stats_get, -ENOTSUP);
 881         (*dev->dev_ops->stats_get)(dev, stats);
 882         return 0;
 883 }
 884
 885 void
 886 rte_cryptodev_stats_reset(uint8_t dev_id)
 887 {
 888         struct rte_cryptodev *dev;
 889
 890         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 891                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 892                 return;
 893         }
 894
 895         dev = &rte_crypto_devices[dev_id];
 896
 897         RTE_FUNC_PTR_OR_RET(*dev->dev_ops->stats_reset);
 898         (*dev->dev_ops->stats_reset)(dev);
 899 }
 900
 901
 902 void
 903 rte_cryptodev_info_get(uint8_t dev_id, struct rte_cryptodev_info *dev_info)
 904 {
 905         struct rte_cryptodev *dev;
 906
 907         if (dev_id >= cryptodev_globals.nb_devs) {
 908                 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
 909                 return;
 910         }
 911
 912         dev = &rte_crypto_devices[dev_id];
 913
 914         memset(dev_info, 0, sizeof(struct rte_cryptodev_info));
 915
 916         RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_infos_get);
 917         (*dev->dev_ops->dev_infos_get)(dev, dev_info);
 918
 919         dev_info->driver_name = dev->device->driver->name;
 920 }
 921
 922
 923 int
 924 rte_cryptodev_callback_register(uint8_t dev_id,
 925                         enum rte_cryptodev_event_type event,
 926                         rte_cryptodev_cb_fn cb_fn, void *cb_arg)
 927 {
 928         struct rte_cryptodev *dev;
 929         struct rte_cryptodev_callback *user_cb;
 930
 931         if (!cb_fn)
 932                 return -EINVAL;
 933
 934         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 935                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 936                 return -EINVAL;
 937         }
 938
 939         dev = &rte_crypto_devices[dev_id];
 940         rte_spinlock_lock(&rte_cryptodev_cb_lock);
 941
 942         TAILQ_FOREACH(user_cb, &(dev->link_intr_cbs), next) {
 943                 if (user_cb->cb_fn == cb_fn &&
 944                         user_cb->cb_arg == cb_arg &&
 945                         user_cb->event == event) {
 946                         break;
 947                 }
 948         }
 949
 950         /* create a new callback. */
 951         if (user_cb == NULL) {
 952                 user_cb = rte_zmalloc("INTR_USER_CALLBACK",
 953                                 sizeof(struct rte_cryptodev_callback), 0);
 954                 if (user_cb != NULL) {
 955                         user_cb->cb_fn = cb_fn;
 956                         user_cb->cb_arg = cb_arg;
 957                         user_cb->event = event;
 958                         TAILQ_INSERT_TAIL(&(dev->link_intr_cbs), user_cb, next);
 959                 }
 960         }
 961
 962         rte_spinlock_unlock(&rte_cryptodev_cb_lock);
 963         return (user_cb == NULL) ? -ENOMEM : 0;
 964 }
 965
 966 int
 967 rte_cryptodev_callback_unregister(uint8_t dev_id,
 968                         enum rte_cryptodev_event_type event,
 969                         rte_cryptodev_cb_fn cb_fn, void *cb_arg)
 970 {
 971         int ret;
 972         struct rte_cryptodev *dev;
 973         struct rte_cryptodev_callback *cb, *next;
 974
 975         if (!cb_fn)
 976                 return -EINVAL;
 977
 978         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
 979                 CDEV_LOG_ERR("Invalid dev_id=%" PRIu8, dev_id);
 980                 return -EINVAL;
 981         }
 982
 983         dev = &rte_crypto_devices[dev_id];
 984         rte_spinlock_lock(&rte_cryptodev_cb_lock);
 985
 986         ret = 0;
 987         for (cb = TAILQ_FIRST(&dev->link_intr_cbs); cb != NULL; cb = next) {
 988
 989                 next = TAILQ_NEXT(cb, next);
 990
 991                 if (cb->cb_fn != cb_fn || cb->event != event ||
 992                                 (cb->cb_arg != (void *)-1 &&
 993                                 cb->cb_arg != cb_arg))
 994                         continue;
 995
 996                 /*
 997                  * if this callback is not executing right now,
 998                  * then remove it.
 999                  */
1000                 if (cb->active == 0) {
1001                         TAILQ_REMOVE(&(dev->link_intr_cbs), cb, next);
1002                         rte_free(cb);
1003                 } else {
1004                         ret = -EAGAIN;
1005                 }
1006         }
1007
1008         rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1009         return ret;
1010 }
1011
1012 void
1013 rte_cryptodev_pmd_callback_process(struct rte_cryptodev *dev,
1014         enum rte_cryptodev_event_type event)
1015 {
1016         struct rte_cryptodev_callback *cb_lst;
1017         struct rte_cryptodev_callback dev_cb;
1018
1019         rte_spinlock_lock(&rte_cryptodev_cb_lock);
1020         TAILQ_FOREACH(cb_lst, &(dev->link_intr_cbs), next) {
1021                 if (cb_lst->cb_fn == NULL || cb_lst->event != event)
1022                         continue;
1023                 dev_cb = *cb_lst;
1024                 cb_lst->active = 1;
1025                 rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1026                 dev_cb.cb_fn(dev->data->dev_id, dev_cb.event,
1027                                                 dev_cb.cb_arg);
1028                 rte_spinlock_lock(&rte_cryptodev_cb_lock);
1029                 cb_lst->active = 0;
1030         }
1031         rte_spinlock_unlock(&rte_cryptodev_cb_lock);
1032 }
1033
1034
1035 static void
1036 rte_cryptodev_sym_session_init(struct rte_mempool *mp,
1037                 void *opaque_arg,
1038                 void *_sess,
1039                 __rte_unused unsigned i)
1040 {
1041         struct rte_cryptodev_sym_session *sess = _sess;
1042         struct rte_cryptodev *dev = opaque_arg;
1043
1044         memset(sess, 0, mp->elt_size);
1045
1046         sess->dev_id = dev->data->dev_id;
1047         sess->dev_type = dev->dev_type;
1048         sess->mp = mp;
1049
1050         if (dev->dev_ops->session_initialize)
1051                 (*dev->dev_ops->session_initialize)(mp, sess);
1052 }
1053
1054 static int
1055 rte_cryptodev_sym_session_pool_create(struct rte_cryptodev *dev,
1056                 unsigned nb_objs, unsigned obj_cache_size, int socket_id)
1057 {
1058         char mp_name[RTE_CRYPTODEV_NAME_MAX_LEN];
1059         unsigned priv_sess_size;
1060
1061         unsigned n = snprintf(mp_name, sizeof(mp_name), "cdev_%d_sess_mp",
1062                         dev->data->dev_id);
1063         if (n > sizeof(mp_name)) {
1064                 CDEV_LOG_ERR("Unable to create unique name for session mempool");
1065                 return -ENOMEM;
1066         }
1067
1068         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->session_get_size, -ENOTSUP);
1069         priv_sess_size = (*dev->dev_ops->session_get_size)(dev);
1070         if (priv_sess_size == 0) {
1071                 CDEV_LOG_ERR("%s returned and invalid private session size ",
1072                                                 dev->data->name);
1073                 return -ENOMEM;
1074         }
1075
1076         unsigned elt_size = sizeof(struct rte_cryptodev_sym_session) +
1077                         priv_sess_size;
1078
1079         dev->data->session_pool = rte_mempool_lookup(mp_name);
1080         if (dev->data->session_pool != NULL) {
1081                 if ((dev->data->session_pool->elt_size != elt_size) ||
1082                                 (dev->data->session_pool->cache_size <
1083                                 obj_cache_size) ||
1084                                 (dev->data->session_pool->size < nb_objs)) {
1085
1086                         CDEV_LOG_ERR("%s mempool already exists with different"
1087                                         " initialization parameters", mp_name);
1088                         dev->data->session_pool = NULL;
1089                         return -ENOMEM;
1090                 }
1091         } else {
1092                 dev->data->session_pool = rte_mempool_create(
1093                                 mp_name, /* mempool name */
1094                                 nb_objs, /* number of elements*/
1095                                 elt_size, /* element size*/
1096                                 obj_cache_size, /* Cache size*/
1097                                 0, /* private data size */
1098                                 NULL, /* obj initialization constructor */
1099                                 NULL, /* obj initialization constructor arg */
1100                                 rte_cryptodev_sym_session_init,
1101                                 /**< obj constructor*/
1102                                 dev, /* obj constructor arg */
1103                                 socket_id, /* socket id */
1104                                 0); /* flags */
1105
1106                 if (dev->data->session_pool == NULL) {
1107                         CDEV_LOG_ERR("%s mempool allocation failed", mp_name);
1108                         return -ENOMEM;
1109                 }
1110         }
1111
1112         CDEV_LOG_DEBUG("%s mempool created!", mp_name);
1113         return 0;
1114 }
1115
1116 struct rte_cryptodev_sym_session *
1117 rte_cryptodev_sym_session_create(uint8_t dev_id,
1118                 struct rte_crypto_sym_xform *xform)
1119 {
1120         struct rte_cryptodev *dev;
1121         struct rte_cryptodev_sym_session *sess;
1122         void *_sess;
1123
1124         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1125                 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
1126                 return NULL;
1127         }
1128
1129         dev = &rte_crypto_devices[dev_id];
1130
1131         /* Allocate a session structure from the session pool */
1132         if (rte_mempool_get(dev->data->session_pool, &_sess)) {
1133                 CDEV_LOG_ERR("Couldn't get object from session mempool");
1134                 return NULL;
1135         }
1136
1137         sess = _sess;
1138
1139         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->session_configure, NULL);
1140         if (dev->dev_ops->session_configure(dev, xform, sess->_private) ==
1141                         NULL) {
1142                 CDEV_LOG_ERR("dev_id %d failed to configure session details",
1143                                 dev_id);
1144
1145                 /* Return session to mempool */
1146                 rte_mempool_put(sess->mp, _sess);
1147                 return NULL;
1148         }
1149
1150         return sess;
1151 }
1152
1153 int
1154 rte_cryptodev_queue_pair_attach_sym_session(uint16_t qp_id,
1155                 struct rte_cryptodev_sym_session *sess)
1156 {
1157         struct rte_cryptodev *dev;
1158
1159         if (!rte_cryptodev_pmd_is_valid_dev(sess->dev_id)) {
1160                 CDEV_LOG_ERR("Invalid dev_id=%d", sess->dev_id);
1161                 return -EINVAL;
1162         }
1163
1164         dev = &rte_crypto_devices[sess->dev_id];
1165
1166         /* The API is optional, not returning error if driver do not suuport */
1167         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->qp_attach_session, 0);
1168         if (dev->dev_ops->qp_attach_session(dev, qp_id, sess->_private)) {
1169                 CDEV_LOG_ERR("dev_id %d failed to attach qp: %d with session",
1170                                 sess->dev_id, qp_id);
1171                 return -EPERM;
1172         }
1173
1174         return 0;
1175 }
1176
1177 int
1178 rte_cryptodev_queue_pair_detach_sym_session(uint16_t qp_id,
1179                 struct rte_cryptodev_sym_session *sess)
1180 {
1181         struct rte_cryptodev *dev;
1182
1183         if (!rte_cryptodev_pmd_is_valid_dev(sess->dev_id)) {
1184                 CDEV_LOG_ERR("Invalid dev_id=%d", sess->dev_id);
1185                 return -EINVAL;
1186         }
1187
1188         dev = &rte_crypto_devices[sess->dev_id];
1189
1190         /* The API is optional, not returning error if driver do not suuport */
1191         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->qp_detach_session, 0);
1192         if (dev->dev_ops->qp_detach_session(dev, qp_id, sess->_private)) {
1193                 CDEV_LOG_ERR("dev_id %d failed to detach qp: %d from session",
1194                                 sess->dev_id, qp_id);
1195                 return -EPERM;
1196         }
1197
1198         return 0;
1199 }
1200 struct rte_cryptodev_sym_session *
1201 rte_cryptodev_sym_session_free(uint8_t dev_id,
1202                 struct rte_cryptodev_sym_session *sess)
1203 {
1204         struct rte_cryptodev *dev;
1205
1206         if (!rte_cryptodev_pmd_is_valid_dev(dev_id)) {
1207                 CDEV_LOG_ERR("Invalid dev_id=%d", dev_id);
1208                 return sess;
1209         }
1210
1211         dev = &rte_crypto_devices[dev_id];
1212
1213         /* Check the session belongs to this device type */
1214         if (sess->dev_type != dev->dev_type)
1215                 return sess;
1216
1217         /* Let device implementation clear session material */
1218         RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->session_clear, sess);
1219         dev->dev_ops->session_clear(dev, (void *)sess->_private);
1220
1221         /* Return session to mempool */
1222         rte_mempool_put(sess->mp, (void *)sess);
1223
1224         return NULL;
1225 }
1226
1227 /** Initialise rte_crypto_op mempool element */
1228 static void
1229 rte_crypto_op_init(struct rte_mempool *mempool,
1230                 void *opaque_arg,
1231                 void *_op_data,
1232                 __rte_unused unsigned i)
1233 {
1234         struct rte_crypto_op *op = _op_data;
1235         enum rte_crypto_op_type type = *(enum rte_crypto_op_type *)opaque_arg;
1236
1237         memset(_op_data, 0, mempool->elt_size);
1238
1239         __rte_crypto_op_reset(op, type);
1240
1241         op->phys_addr = rte_mem_virt2phy(_op_data);
1242         op->mempool = mempool;
1243 }
1244
1245
1246 struct rte_mempool *
1247 rte_crypto_op_pool_create(const char *name, enum rte_crypto_op_type type,
1248                 unsigned nb_elts, unsigned cache_size, uint16_t priv_size,
1249                 int socket_id)
1250 {
1251         struct rte_crypto_op_pool_private *priv;
1252
1253         unsigned elt_size = sizeof(struct rte_crypto_op) +
1254                         sizeof(struct rte_crypto_sym_op) +
1255                         priv_size;
1256
1257         /* lookup mempool in case already allocated */
1258         struct rte_mempool *mp = rte_mempool_lookup(name);
1259
1260         if (mp != NULL) {
1261                 priv = (struct rte_crypto_op_pool_private *)
1262                                 rte_mempool_get_priv(mp);
1263
1264                 if (mp->elt_size != elt_size ||
1265                                 mp->cache_size < cache_size ||
1266                                 mp->size < nb_elts ||
1267                                 priv->priv_size <  priv_size) {
1268                         mp = NULL;
1269                         CDEV_LOG_ERR("Mempool %s already exists but with "
1270                                         "incompatible parameters", name);
1271                         return NULL;
1272                 }
1273                 return mp;
1274         }
1275
1276         mp = rte_mempool_create(
1277                         name,
1278                         nb_elts,
1279                         elt_size,
1280                         cache_size,
1281                         sizeof(struct rte_crypto_op_pool_private),
1282                         NULL,
1283                         NULL,
1284                         rte_crypto_op_init,
1285                         &type,
1286                         socket_id,
1287                         0);
1288
1289         if (mp == NULL) {
1290                 CDEV_LOG_ERR("Failed to create mempool %s", name);
1291                 return NULL;
1292         }
1293
1294         priv = (struct rte_crypto_op_pool_private *)
1295                         rte_mempool_get_priv(mp);
1296
1297         priv->priv_size = priv_size;
1298         priv->type = type;
1299
1300         return mp;
1301 }
1302
1303 int
1304 rte_cryptodev_pmd_create_dev_name(char *name, const char *dev_name_prefix)
1305 {
1306         struct rte_cryptodev *dev = NULL;
1307         uint32_t i = 0;
1308
1309         if (name == NULL)
1310                 return -EINVAL;
1311
1312         for (i = 0; i < RTE_CRYPTO_MAX_DEVS; i++) {
1313                 int ret = snprintf(name, RTE_CRYPTODEV_NAME_MAX_LEN,
1314                                 "%s_%u", dev_name_prefix, i);
1315
1316                 if (ret < 0)
1317                         return ret;
1318
1319                 dev = rte_cryptodev_pmd_get_named_dev(name);
1320                 if (!dev)
1321                         return 0;
1322         }
1323
1324         return -1;
1325 }