rte_crypto.h

Go to the documentation of this file.

/*-
 *   BSD LICENSE
 *
 *   Copyright(c) 2015 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>

enum rte_crypto_cipher_algorithm {
        RTE_CRYPTO_CIPHER_NULL = 1,
        RTE_CRYPTO_CIPHER_3DES_CBC,
        RTE_CRYPTO_CIPHER_3DES_CTR,
        RTE_CRYPTO_CIPHER_3DES_ECB,
        RTE_CRYPTO_CIPHER_AES_CBC,
        RTE_CRYPTO_CIPHER_AES_CCM,
        RTE_CRYPTO_CIPHER_AES_CTR,
        RTE_CRYPTO_CIPHER_AES_ECB,
        RTE_CRYPTO_CIPHER_AES_F8,
        RTE_CRYPTO_CIPHER_AES_GCM,
        RTE_CRYPTO_CIPHER_AES_XTS,
        RTE_CRYPTO_CIPHER_ARC4,
        RTE_CRYPTO_CIPHER_KASUMI_F8,
        RTE_CRYPTO_CIPHER_SNOW3G_UEA2,
        RTE_CRYPTO_CIPHER_ZUC_EEA3
};

enum rte_crypto_cipher_operation {
        RTE_CRYPTO_CIPHER_OP_ENCRYPT,
        RTE_CRYPTO_CIPHER_OP_DECRYPT
};

struct rte_crypto_key {
        uint8_t *data;  
        phys_addr_t phys_addr;
        size_t length;  
};

struct rte_crypto_cipher_xform {
        enum rte_crypto_cipher_operation op;
        enum rte_crypto_cipher_algorithm algo;
        struct rte_crypto_key key;
};

enum rte_crypto_auth_algorithm {
        RTE_CRYPTO_AUTH_NULL = 1,
        RTE_CRYPTO_AUTH_AES_CBC_MAC,
        RTE_CRYPTO_AUTH_AES_CCM,
        RTE_CRYPTO_AUTH_AES_CMAC,
        RTE_CRYPTO_AUTH_AES_GCM,
        RTE_CRYPTO_AUTH_AES_GMAC,
        RTE_CRYPTO_AUTH_AES_XCBC_MAC,
        RTE_CRYPTO_AUTH_KASUMI_F9,
        RTE_CRYPTO_AUTH_MD5,
        RTE_CRYPTO_AUTH_MD5_HMAC,
        RTE_CRYPTO_AUTH_SHA1,
        RTE_CRYPTO_AUTH_SHA1_HMAC,
        RTE_CRYPTO_AUTH_SHA224,
        RTE_CRYPTO_AUTH_SHA224_HMAC,
        RTE_CRYPTO_AUTH_SHA256,
        RTE_CRYPTO_AUTH_SHA256_HMAC,
        RTE_CRYPTO_AUTH_SHA384,
        RTE_CRYPTO_AUTH_SHA384_HMAC,
        RTE_CRYPTO_AUTH_SHA512,
        RTE_CRYPTO_AUTH_SHA512_HMAC,
        RTE_CRYPTO_AUTH_SNOW3G_UIA2,
        RTE_CRYPTO_AUTH_ZUC_EIA3,
};

enum rte_crypto_auth_operation {
        RTE_CRYPTO_AUTH_OP_VERIFY,      
        RTE_CRYPTO_AUTH_OP_GENERATE     
};

struct rte_crypto_auth_xform {
        enum rte_crypto_auth_operation op;
        enum rte_crypto_auth_algorithm algo;
        struct rte_crypto_key key;              
        uint32_t digest_length;
        uint32_t add_auth_data_length;
};

enum rte_crypto_xform_type {
        RTE_CRYPTO_XFORM_NOT_SPECIFIED = 0,     
        RTE_CRYPTO_XFORM_AUTH,                  
        RTE_CRYPTO_XFORM_CIPHER                 
};

struct rte_crypto_xform {
        struct rte_crypto_xform *next; 
        enum rte_crypto_xform_type type; 
        union {
                struct rte_crypto_auth_xform auth;
                struct rte_crypto_cipher_xform cipher;
        };
};

enum rte_crypto_op_sess_type {
        RTE_CRYPTO_OP_WITH_SESSION,     
        RTE_CRYPTO_OP_SESSIONLESS       
};

enum rte_crypto_op_status {
        RTE_CRYPTO_OP_STATUS_SUCCESS,
        RTE_CRYPTO_OP_STATUS_NO_SUBMITTED,
        RTE_CRYPTO_OP_STATUS_ENQUEUED,
        RTE_CRYPTO_OP_STATUS_AUTH_FAILED,
        RTE_CRYPTO_OP_STATUS_INVALID_ARGS,
        RTE_CRYPTO_OP_STATUS_ERROR,
};

struct rte_crypto_op {
        enum rte_crypto_op_sess_type type;
        enum rte_crypto_op_status status;

        struct {
                struct rte_mbuf *m;     
                uint8_t offset;         
        } dst;

        union {
                struct rte_cryptodev_session *session;
                struct rte_crypto_xform *xform;
        };

        struct {
                struct {
                         uint32_t offset;
                         uint32_t length;
                } to_cipher; 
                struct {
                         uint32_t offset;
                         uint32_t length;
                } to_hash; 
        } data; 
        struct {
                uint8_t *data;
                phys_addr_t phys_addr;
                size_t length;
        } iv;   
        struct {
                uint8_t *data;
                phys_addr_t phys_addr;  
                uint32_t length;        
        } digest; 
        struct {
                uint8_t *data;
                phys_addr_t phys_addr;  
                uint32_t length;        
        } additional_auth;
        struct rte_mempool *pool;
        void *user_data;
};


static inline void
__rte_crypto_op_reset(struct rte_crypto_op *op)
{
        op->type = RTE_CRYPTO_OP_SESSIONLESS;
        op->dst.m = NULL;
        op->dst.offset = 0;
}

static inline void
rte_crypto_op_attach_session(struct rte_crypto_op *op,
                struct rte_cryptodev_session *sess)
{
        op->session = sess;
        op->type = RTE_CRYPTO_OP_WITH_SESSION;
}

#ifdef __cplusplus
}
#endif

#endif /* _RTE_CRYPTO_H_ */