rte_crypto.h

Go to the documentation of this file.

/*-
 *   BSD LICENSE
 *
 *   Copyright(c) 2016-2017 Intel Corporation. All rights reserved.
 *
 *   Redistribution and use in source and binary forms, with or without
 *   modification, are permitted provided that the following conditions
 *   are met:
 *
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in
 *       the documentation and/or other materials provided with the
 *       distribution.
 *     * Neither the name of Intel Corporation nor the names of its
 *       contributors may be used to endorse or promote products derived
 *       from this software without specific prior written permission.
 *
 *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef _RTE_CRYPTO_H_
#define _RTE_CRYPTO_H_

#ifdef __cplusplus
extern "C" {
#endif


#include <rte_mbuf.h>
#include <rte_memory.h>
#include <rte_mempool.h>
#include <rte_common.h>

#include "rte_crypto_sym.h"

enum rte_crypto_op_type {
        RTE_CRYPTO_OP_TYPE_UNDEFINED,
        RTE_CRYPTO_OP_TYPE_SYMMETRIC,
};

enum rte_crypto_op_status {
        RTE_CRYPTO_OP_STATUS_SUCCESS,
        RTE_CRYPTO_OP_STATUS_NOT_PROCESSED,
        RTE_CRYPTO_OP_STATUS_AUTH_FAILED,
        RTE_CRYPTO_OP_STATUS_INVALID_SESSION,
        RTE_CRYPTO_OP_STATUS_INVALID_ARGS,
        RTE_CRYPTO_OP_STATUS_ERROR,
};

enum rte_crypto_op_sess_type {
        RTE_CRYPTO_OP_WITH_SESSION,     
        RTE_CRYPTO_OP_SESSIONLESS       
};

struct rte_crypto_op {
        uint8_t type;
        uint8_t status;
        uint8_t sess_type;
        uint8_t reserved[5];
        struct rte_mempool *mempool;
        phys_addr_t phys_addr;
        RTE_STD_C11
        union {
                struct rte_crypto_sym_op sym[0];
        }; 
};

static inline void
__rte_crypto_op_reset(struct rte_crypto_op *op, enum rte_crypto_op_type type)
{
        op->type = type;
        op->status = RTE_CRYPTO_OP_STATUS_NOT_PROCESSED;
        op->sess_type = RTE_CRYPTO_OP_SESSIONLESS;

        switch (type) {
        case RTE_CRYPTO_OP_TYPE_SYMMETRIC:
                __rte_crypto_sym_op_reset(op->sym);
                break;
        case RTE_CRYPTO_OP_TYPE_UNDEFINED:
        default:
                break;
        }
}

struct rte_crypto_op_pool_private {
        enum rte_crypto_op_type type;
        uint16_t priv_size;
};


static inline uint16_t
__rte_crypto_op_get_priv_data_size(struct rte_mempool *mempool)
{
        struct rte_crypto_op_pool_private *priv =
                (struct rte_crypto_op_pool_private *) rte_mempool_get_priv(mempool);

        return priv->priv_size;
}


extern struct rte_mempool *
rte_crypto_op_pool_create(const char *name, enum rte_crypto_op_type type,
                unsigned nb_elts, unsigned cache_size, uint16_t priv_size,
                int socket_id);

static inline int
__rte_crypto_op_raw_bulk_alloc(struct rte_mempool *mempool,
                enum rte_crypto_op_type type,
                struct rte_crypto_op **ops, uint16_t nb_ops)
{
        struct rte_crypto_op_pool_private *priv;

        priv = (struct rte_crypto_op_pool_private *) rte_mempool_get_priv(mempool);
        if (unlikely(priv->type != type &&
                        priv->type != RTE_CRYPTO_OP_TYPE_UNDEFINED))
                return -EINVAL;

        if (rte_mempool_get_bulk(mempool, (void **)ops, nb_ops) == 0)
                return nb_ops;

        return 0;
}

static inline struct rte_crypto_op *
rte_crypto_op_alloc(struct rte_mempool *mempool, enum rte_crypto_op_type type)
{
        struct rte_crypto_op *op = NULL;
        int retval;

        retval = __rte_crypto_op_raw_bulk_alloc(mempool, type, &op, 1);
        if (unlikely(retval != 1))
                return NULL;

        __rte_crypto_op_reset(op, type);

        return op;
}


static inline unsigned
rte_crypto_op_bulk_alloc(struct rte_mempool *mempool,
                enum rte_crypto_op_type type,
                struct rte_crypto_op **ops, uint16_t nb_ops)
{
        int i;

        if (unlikely(__rte_crypto_op_raw_bulk_alloc(mempool, type, ops, nb_ops)
                        != nb_ops))
                return 0;

        for (i = 0; i < nb_ops; i++)
                __rte_crypto_op_reset(ops[i], type);

        return nb_ops;
}



static inline void *
__rte_crypto_op_get_priv_data(struct rte_crypto_op *op, uint32_t size)
{
        uint32_t priv_size;

        if (likely(op->mempool != NULL)) {
                priv_size = __rte_crypto_op_get_priv_data_size(op->mempool);

                if (likely(priv_size >= size))
                        return (void *)((uint8_t *)(op + 1) +
                                        sizeof(struct rte_crypto_sym_op));
        }

        return NULL;
}

static inline void
rte_crypto_op_free(struct rte_crypto_op *op)
{
        if (op != NULL && op->mempool != NULL)
                rte_mempool_put(op->mempool, op);
}

static inline struct rte_crypto_op *
rte_crypto_sym_op_alloc_from_mbuf_priv_data(struct rte_mbuf *m)
{
        if (unlikely(m == NULL))
                return NULL;

        /*
         * check that the mbuf's private data size is sufficient to contain a
         * crypto operation
         */
        if (unlikely(m->priv_size < (sizeof(struct rte_crypto_op) +
                        sizeof(struct rte_crypto_sym_op))))
                return NULL;

        /* private data starts immediately after the mbuf header in the mbuf. */
        struct rte_crypto_op *op = (struct rte_crypto_op *)(m + 1);

        __rte_crypto_op_reset(op, RTE_CRYPTO_OP_TYPE_SYMMETRIC);

        op->mempool = NULL;
        op->sym->m_src = m;

        return op;
}

static inline struct rte_crypto_sym_xform *
rte_crypto_op_sym_xforms_alloc(struct rte_crypto_op *op, uint8_t nb_xforms)
{
        void *priv_data;
        uint32_t size;

        if (unlikely(op->type != RTE_CRYPTO_OP_TYPE_SYMMETRIC))
                return NULL;

        size = sizeof(struct rte_crypto_sym_xform) * nb_xforms;

        priv_data = __rte_crypto_op_get_priv_data(op, size);
        if (priv_data == NULL)
                return NULL;

        return __rte_crypto_sym_op_sym_xforms_alloc(op->sym, priv_data,
                        nb_xforms);
}


static inline int
rte_crypto_op_attach_sym_session(struct rte_crypto_op *op,
                struct rte_cryptodev_sym_session *sess)
{
        if (unlikely(op->type != RTE_CRYPTO_OP_TYPE_SYMMETRIC))
                return -1;

        op->sess_type = RTE_CRYPTO_OP_WITH_SESSION;

        return __rte_crypto_sym_op_attach_sym_session(op->sym, sess);
}

#ifdef __cplusplus
}
#endif

#endif /* _RTE_CRYPTO_H_ */