#include <string.h>
#include <rte_config.h>
#include <rte_dev.h>
#include <rte_malloc.h>
#include <rte_mbuf.h>
#include <rte_mempool.h>
#include <rte_log.h>
#include <rte_common.h>
#include "rte_crypto.h"
#include "rte_cryptodev.h"

Data Structures
struct	rte_cryptodev_global

struct	rte_cryptodev_ops

Typedefs
typedef int(*	cryptodev_configure_t) (struct rte_cryptodev dev, struct rte_cryptodev_config config)

typedef int(*	cryptodev_start_t) (struct rte_cryptodev *dev)

typedef void(*	cryptodev_stop_t) (struct rte_cryptodev *dev)

typedef int(*	cryptodev_close_t) (struct rte_cryptodev *dev)

typedef void(*	cryptodev_stats_get_t) (struct rte_cryptodev dev, struct rte_cryptodev_stats stats)

typedef void(*	cryptodev_stats_reset_t) (struct rte_cryptodev *dev)

typedef void(*	cryptodev_info_get_t) (struct rte_cryptodev dev, struct rte_cryptodev_info dev_info)

typedef int(*	cryptodev_queue_pair_setup_t) (struct rte_cryptodev dev, uint16_t qp_id, const struct rte_cryptodev_qp_conf qp_conf, int socket_id)

typedef int(*	cryptodev_queue_pair_release_t) (struct rte_cryptodev *dev, uint16_t qp_id)

typedef int(*	cryptodev_sym_create_session_pool_t) (struct rte_cryptodev *dev, unsigned nb_objs, unsigned obj_cache_size, int socket_id)

typedef unsigned(*	cryptodev_sym_get_session_private_size_t) (struct rte_cryptodev *dev)

typedef unsigned int(*	cryptodev_asym_get_session_private_size_t) (struct rte_cryptodev *dev)

typedef int(*	cryptodev_sym_configure_session_t) (struct rte_cryptodev dev, struct rte_crypto_sym_xform xform, struct rte_cryptodev_sym_session session, struct rte_mempool mp)

typedef int(*	cryptodev_asym_configure_session_t) (struct rte_cryptodev dev, struct rte_crypto_asym_xform xform, struct rte_cryptodev_asym_session session, struct rte_mempool mp)

typedef void(*	cryptodev_sym_free_session_t) (struct rte_cryptodev dev, struct rte_cryptodev_sym_session sess)

typedef void(*	cryptodev_asym_free_session_t) (struct rte_cryptodev dev, struct rte_cryptodev_asym_session sess)

typedef uint32_t(*	cryptodev_sym_cpu_crypto_process_t) (struct rte_cryptodev dev, struct rte_cryptodev_sym_session sess, union rte_crypto_sym_ofs ofs, struct rte_crypto_sym_vec *vec)

Functions
struct rte_cryptodev *	rte_cryptodev_pmd_get_dev (uint8_t dev_id)

struct rte_cryptodev *	rte_cryptodev_pmd_get_named_dev (const char *name)

unsigned int	rte_cryptodev_pmd_is_valid_dev (uint8_t dev_id)

struct rte_cryptodev *	rte_cryptodev_pmd_allocate (const char *name, int socket_id)

int	rte_cryptodev_pmd_release_device (struct rte_cryptodev *cryptodev)

void	rte_cryptodev_pmd_callback_process (struct rte_cryptodev *dev, enum rte_cryptodev_event_type event)

Variables
struct rte_cryptodev *	rte_cryptodevs

Detailed Description

RTE Crypto PMD APIs

Note: These API are from crypto PMD only and user applications should not call them directly.

Definition in file rte_cryptodev_pmd.h.

Typedef Documentation

typedef int(* cryptodev_configure_t) (struct rte_cryptodev *dev, struct rte_cryptodev_config *config)

Definitions of all functions exported by a driver through the the generic structure of type crypto_dev_ops supplied in the rte_cryptodev structure associated with a device. Function used to configure device.

Parameters

dev	Crypto device pointer config Crypto device configurations

Returns: Returns 0 on success

Definition at line 127 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_start_t) (struct rte_cryptodev *dev)

Function used to start a configured device.

Parameters

dev	Crypto device pointer

Returns: Returns 0 on success

Definition at line 137 of file rte_cryptodev_pmd.h.

typedef void(* cryptodev_stop_t) (struct rte_cryptodev *dev)

Function used to stop a configured device.

Parameters

dev	Crypto device pointer

Definition at line 144 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_close_t) (struct rte_cryptodev *dev)

Function used to close a configured device.

Parameters

dev	Crypto device pointer

Returns

0 on success.
EAGAIN if can't close as device is busy

Definition at line 154 of file rte_cryptodev_pmd.h.

typedef void(* cryptodev_stats_get_t) (struct rte_cryptodev *dev, struct rte_cryptodev_stats *stats)

Function used to get statistics of a device.

Parameters

dev	Crypto device pointer
stats	Pointer to crypto device stats structure to populate

Definition at line 163 of file rte_cryptodev_pmd.h.

typedef void(* cryptodev_stats_reset_t) (struct rte_cryptodev *dev)

Function used to reset statistics of a device.

Parameters

dev	Crypto device pointer

Definition at line 172 of file rte_cryptodev_pmd.h.

typedef void(* cryptodev_info_get_t) (struct rte_cryptodev *dev, struct rte_cryptodev_info *dev_info)

Function used to get specific information of a device.

Parameters

dev	Crypto device pointer

Definition at line 180 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_queue_pair_setup_t) (struct rte_cryptodev *dev, uint16_t qp_id, const struct rte_cryptodev_qp_conf *qp_conf, int socket_id)

Setup a queue pair for a device.

Parameters

dev	Crypto device pointer
qp_id	Queue Pair Index
qp_conf	Queue configuration structure
socket_id	Socket Index

Returns: Returns 0 on success.

Definition at line 193 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_queue_pair_release_t) (struct rte_cryptodev *dev, uint16_t qp_id)

Release memory resources allocated by given queue pair.

Parameters

dev	Crypto device pointer
qp_id	Queue Pair Index

Returns

0 on success.
EAGAIN if can't close as device is busy

Definition at line 207 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_sym_create_session_pool_t) (struct rte_cryptodev *dev, unsigned nb_objs, unsigned obj_cache_size, int socket_id)

Create a session mempool to allocate sessions from

Parameters

dev	Crypto device pointer
nb_objs	number of sessions objects in mempool
obj_cache	l-core object cache size, see rte_ring_create
socket_id	Socket Id to allocate mempool on.

Returns

On success returns a pointer to a rte_mempool
On failure returns a NULL pointer

Definition at line 222 of file rte_cryptodev_pmd.h.

typedef unsigned(* cryptodev_sym_get_session_private_size_t) (struct rte_cryptodev *dev)

Get the size of a cryptodev session

Parameters

dev	Crypto device pointer

Returns

On success returns the size of the session structure for device
On failure returns 0

Definition at line 236 of file rte_cryptodev_pmd.h.

typedef unsigned int(* cryptodev_asym_get_session_private_size_t) (struct rte_cryptodev *dev)

Get the size of a asymmetric cryptodev session

Parameters

dev	Crypto device pointer

Returns

On success returns the size of the session structure for device
On failure returns 0

Definition at line 247 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_sym_configure_session_t) (struct rte_cryptodev *dev, struct rte_crypto_sym_xform *xform, struct rte_cryptodev_sym_session *session, struct rte_mempool *mp)

Configure a Crypto session on a device.

Parameters

dev	Crypto device pointer
xform	Single or chain of crypto xforms
priv_sess	Pointer to cryptodev's private session structure
mp	Mempool where the private session is allocated

Returns

Returns 0 if private session structure have been created successfully.
Returns -EINVAL if input parameters are invalid.
Returns -ENOTSUP if crypto device does not support the crypto transform.
Returns -ENOMEM if the private session could not be allocated.

Definition at line 264 of file rte_cryptodev_pmd.h.

typedef int(* cryptodev_asym_configure_session_t) (struct rte_cryptodev *dev, struct rte_crypto_asym_xform *xform, struct rte_cryptodev_asym_session *session, struct rte_mempool *mp)

Configure a Crypto asymmetric session on a device.

Parameters

dev	Crypto device pointer
xform	Single or chain of crypto xforms
priv_sess	Pointer to cryptodev's private session structure
mp	Mempool where the private session is allocated

Returns

Returns 0 if private session structure have been created successfully.
Returns -EINVAL if input parameters are invalid.
Returns -ENOTSUP if crypto device does not support the crypto transform.
Returns -ENOMEM if the private session could not be allocated.

Definition at line 282 of file rte_cryptodev_pmd.h.

typedef void(* cryptodev_sym_free_session_t) (struct rte_cryptodev *dev, struct rte_cryptodev_sym_session *sess)

Free driver private session data.

Parameters

dev	Crypto device pointer
sess	Cryptodev session structure

Definition at line 292 of file rte_cryptodev_pmd.h.

typedef void(* cryptodev_asym_free_session_t) (struct rte_cryptodev *dev, struct rte_cryptodev_asym_session *sess)

Free asymmetric session private data.

Parameters

dev	Crypto device pointer
sess	Cryptodev session structure

Definition at line 300 of file rte_cryptodev_pmd.h.

typedef uint32_t(* cryptodev_sym_cpu_crypto_process_t) (struct rte_cryptodev *dev, struct rte_cryptodev_sym_session *sess, union rte_crypto_sym_ofs ofs, struct rte_crypto_sym_vec *vec)

Perform actual crypto processing (encrypt/digest or auth/decrypt) on user provided data.

Parameters

dev	Crypto device pointer
sess	Cryptodev session structure
ofs	Start and stop offsets for auth and cipher operations
vec	Vectorized operation descriptor

Returns

Returns number of successfully processed packets.

Definition at line 316 of file rte_cryptodev_pmd.h.

Function Documentation

struct rte_cryptodev* rte_cryptodev_pmd_get_dev ( uint8_t dev_id )

Get the rte_cryptodev structure device pointer for the device. Assumes a valid device index.

Parameters

dev_id Device ID value to select the device structure.

Returns

The rte_cryptodev structure pointer for the given device ID.

Examples:: examples/fips_validation/fips_dev_self_test.c, and examples/fips_validation/main.c.

struct rte_cryptodev* rte_cryptodev_pmd_get_named_dev ( const char * name )

Get the rte_cryptodev structure device pointer for the named device.

Parameters

name	device name to select the device structure.

Returns

The rte_cryptodev structure pointer for the given device ID.

unsigned int rte_cryptodev_pmd_is_valid_dev ( uint8_t dev_id )

Validate if the crypto device index is valid attached crypto device.

Parameters

dev_id Crypto device index.

Returns

If the device index is valid (1) or not (0).

Examples:: examples/fips_validation/main.c, and examples/ip_pipeline/cryptodev.c.

struct rte_cryptodev* rte_cryptodev_pmd_allocate	(	const char *	name,
		int	socket_id
	)

Function for internal use by dummy drivers primarily, e.g. ring-based driver. Allocates a new cryptodev slot for an crypto device and returns the pointer to that slot for the driver to use.

Parameters

name	Unique identifier name for each device
socket_id	Socket to allocate resources on.

Returns

Slot in the rte_dev_devices array for a new device;

int rte_cryptodev_pmd_release_device ( struct rte_cryptodev * cryptodev )

Function for internal use by dummy drivers primarily, e.g. ring-based driver. Release the specified cryptodev device.

Parameters

cryptodev The cryptodev pointer is the address of the rte_cryptodev structure.

Returns

0 on success, negative on error

void rte_cryptodev_pmd_callback_process	(	struct rte_cryptodev *	dev,
		enum rte_cryptodev_event_type	event
	)

Executes all the user application registered callbacks for the specific device.

Parameters

dev Pointer to cryptodev struct

event Crypto device interrupt event type.

Returns
void

Variable Documentation

struct rte_cryptodev* rte_cryptodevs

The pool of rte_cryptodev structures.

dev	Pointer to cryptodev struct
event	Crypto device interrupt event type.

Data Structures

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

Function Documentation

Variable Documentation