From cc85c0781f83934b153062914790eb4f2b08954a Mon Sep 17 00:00:00 2001 From: Fan Zhang Date: Mon, 1 Oct 2018 11:02:23 +0100 Subject: [PATCH] port: add symmetric crypto This patch adds the symmetric crypto support to port library. The crypto port acts as a shim layer to DPDK cryptodev library and supports in-place crypto workload processing. Signed-off-by: Fan Zhang Acked-by: Cristian Dumitrescu --- doc/guides/prog_guide/packet_framework.rst | 11 +- lib/librte_port/Makefile | 4 +- lib/librte_port/meson.build | 8 +- lib/librte_port/rte_port_sym_crypto.c | 552 +++++++++++++++++++++ lib/librte_port/rte_port_sym_crypto.h | 93 ++++ lib/librte_port/rte_port_version.map | 9 + 6 files changed, 672 insertions(+), 5 deletions(-) create mode 100644 lib/librte_port/rte_port_sym_crypto.c create mode 100644 lib/librte_port/rte_port_sym_crypto.h diff --git a/doc/guides/prog_guide/packet_framework.rst b/doc/guides/prog_guide/packet_framework.rst index f0b485669f..48d257501f 100644 --- a/doc/guides/prog_guide/packet_framework.rst +++ b/doc/guides/prog_guide/packet_framework.rst @@ -98,6 +98,10 @@ Port Types | | | character device. | | | | | +---+------------------+---------------------------------------------------------------------------------------+ + | 9 | Sym_crypto | Output port used to extract DPDK Cryptodev operations from a fixed offset of the | + | | | packet and then enqueue to the Cryptodev PMD. Input port used to dequeue the | + | | | Cryptodev operations from the Cryptodev PMD and then retrieve the packets from them. | + +---+------------------+---------------------------------------------------------------------------------------+ Port Interface ~~~~~~~~~~~~~~ @@ -1078,6 +1082,11 @@ with each table entry having its own set of enabled user actions and its own cop | | | checksum. | | | | | +---+-----------------------------------+---------------------------------------------------------------------+ + | 7 | Sym Crypto | Generate Cryptodev session based on the user-specified algorithm | + | | | and key(s), and assemble the cryptodev operation based on the | + | | | predefined offsets. | + | | | | + +---+-----------------------------------+---------------------------------------------------------------------+ Multicore Scaling ----------------- @@ -1133,7 +1142,7 @@ Typical devices with acceleration capabilities are: * Inline accelerators: NICs, switches, FPGAs, etc; -* Look-aside accelerators: chipsets, FPGAs, etc. +* Look-aside accelerators: chipsets, FPGAs, Intel QuickAssist, etc. Usually, to support a specific functional block, specific implementation of Packet Framework tables and/or ports and/or actions has to be provided for each accelerator, with all the implementations sharing the same API: pure SW implementation (no acceleration), implementation using accelerator A, implementation using accelerator B, etc. diff --git a/lib/librte_port/Makefile b/lib/librte_port/Makefile index 8df4864ed2..1b83f6f2b9 100644 --- a/lib/librte_port/Makefile +++ b/lib/librte_port/Makefile @@ -11,7 +11,7 @@ ifeq ($(CONFIG_RTE_PORT_PCAP),y) LDLIBS += -lpcap endif LDLIBS += -lrte_eal -lrte_mempool -lrte_mbuf -lrte_ethdev -LDLIBS += -lrte_ip_frag -lrte_sched +LDLIBS += -lrte_ip_frag -lrte_sched -lrte_cryptodev ifeq ($(CONFIG_RTE_LIBRTE_KNI),y) LDLIBS += -lrte_kni endif @@ -38,6 +38,7 @@ ifeq ($(CONFIG_RTE_LIBRTE_KNI),y) SRCS-$(CONFIG_RTE_LIBRTE_PORT) += rte_port_kni.c endif SRCS-$(CONFIG_RTE_LIBRTE_PORT) += rte_port_source_sink.c +SRCS-$(CONFIG_RTE_LIBRTE_PORT) += rte_port_sym_crypto.c # install includes SYMLINK-$(CONFIG_RTE_LIBRTE_PORT)-include += rte_port.h @@ -53,5 +54,6 @@ ifeq ($(CONFIG_RTE_LIBRTE_KNI),y) SYMLINK-$(CONFIG_RTE_LIBRTE_PORT)-include += rte_port_kni.h endif SYMLINK-$(CONFIG_RTE_LIBRTE_PORT)-include += rte_port_source_sink.h +SYMLINK-$(CONFIG_RTE_LIBRTE_PORT)-include += rte_port_sym_crypto.h include $(RTE_SDK)/mk/rte.lib.mk diff --git a/lib/librte_port/meson.build b/lib/librte_port/meson.build index f3d8b4434c..0d11456f0a 100644 --- a/lib/librte_port/meson.build +++ b/lib/librte_port/meson.build @@ -9,7 +9,8 @@ sources = files( 'rte_port_ras.c', 'rte_port_ring.c', 'rte_port_sched.c', - 'rte_port_source_sink.c') + 'rte_port_source_sink.c', + 'rte_port_sym_crypto.c') headers = files( 'rte_port_ethdev.h', 'rte_port_fd.h', @@ -18,8 +19,9 @@ headers = files( 'rte_port.h', 'rte_port_ring.h', 'rte_port_sched.h', - 'rte_port_source_sink.h') -deps += ['ethdev', 'sched', 'ip_frag'] + 'rte_port_source_sink.h', + 'rte_port_sym_crypto.h') +deps += ['ethdev', 'sched', 'ip_frag', 'cryptodev'] if dpdk_conf.has('RTE_LIBRTE_KNI') sources += files('rte_port_kni.c') diff --git a/lib/librte_port/rte_port_sym_crypto.c b/lib/librte_port/rte_port_sym_crypto.c new file mode 100644 index 0000000000..295984d025 --- /dev/null +++ b/lib/librte_port/rte_port_sym_crypto.c @@ -0,0 +1,552 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2018 Intel Corporation + */ +#include + +#include +#include + +#include "rte_port_sym_crypto.h" + +/* + * Port Crypto Reader + */ +#ifdef RTE_PORT_STATS_COLLECT + +#define RTE_PORT_SYM_CRYPTO_READER_STATS_PKTS_IN_ADD(port, val) \ + (port)->stats.n_pkts_in += (val) +#define RTE_PORT_SYM_CRYPTO_READER_STATS_PKTS_DROP_ADD(port, val) \ + (port)->stats.n_pkts_drop += (val) + +#else + +#define RTE_PORT_SYM_CRYPTO_READER_STATS_PKTS_IN_ADD(port, val) +#define RTE_PORT_SYM_CRYPTO_READER_STATS_PKTS_DROP_ADD(port, val) + +#endif + +struct rte_port_sym_crypto_reader { + struct rte_port_in_stats stats; + + uint8_t cryptodev_id; + uint16_t queue_id; + struct rte_crypto_op *ops[RTE_PORT_IN_BURST_SIZE_MAX]; + rte_port_sym_crypto_reader_callback_fn f_callback; + void *arg_callback; +}; + +static void * +rte_port_sym_crypto_reader_create(void *params, int socket_id) +{ + struct rte_port_sym_crypto_reader_params *conf = + params; + struct rte_port_sym_crypto_reader *port; + + /* Check input parameters */ + if (conf == NULL) { + RTE_LOG(ERR, PORT, "%s: params is NULL\n", __func__); + return NULL; + } + + /* Memory allocation */ + port = rte_zmalloc_socket("PORT", sizeof(*port), + RTE_CACHE_LINE_SIZE, socket_id); + if (port == NULL) { + RTE_LOG(ERR, PORT, "%s: Failed to allocate port\n", __func__); + return NULL; + } + + /* Initialization */ + port->cryptodev_id = conf->cryptodev_id; + port->queue_id = conf->queue_id; + port->f_callback = conf->f_callback; + port->arg_callback = conf->arg_callback; + + return port; +} + +static int +rte_port_sym_crypto_reader_rx(void *port, struct rte_mbuf **pkts, uint32_t n_pkts) +{ + struct rte_port_sym_crypto_reader *p = + port; + uint16_t rx_ops_cnt, i, n = 0; + + rx_ops_cnt = rte_cryptodev_dequeue_burst(p->cryptodev_id, p->queue_id, + p->ops, n_pkts); + + for (i = 0; i < rx_ops_cnt; i++) { + struct rte_crypto_op *op = p->ops[i]; + + /** Drop failed pkts */ + if (unlikely(op->status != RTE_CRYPTO_OP_STATUS_SUCCESS)) { + rte_pktmbuf_free(op->sym->m_src); + continue; + } + + pkts[n++] = op->sym->m_src; + } + + if (p->f_callback) + (*p->f_callback)(pkts, n, p->arg_callback); + + RTE_PORT_SYM_CRYPTO_READER_STATS_PKTS_IN_ADD(p, n); + RTE_PORT_SYM_CRYPTO_READER_STATS_PKTS_DROP_ADD(p, rx_ops_cnt - n); + + return n; +} + +static int +rte_port_sym_crypto_reader_free(void *port) +{ + if (port == NULL) { + RTE_LOG(ERR, PORT, "%s: port is NULL\n", __func__); + return -EINVAL; + } + + rte_free(port); + + return 0; +} + +static int rte_port_sym_crypto_reader_stats_read(void *port, + struct rte_port_in_stats *stats, int clear) +{ + struct rte_port_sym_crypto_reader *p = + port; + + if (stats != NULL) + memcpy(stats, &p->stats, sizeof(p->stats)); + + if (clear) + memset(&p->stats, 0, sizeof(p->stats)); + + return 0; +} + +/* + * Port crypto Writer + */ +#ifdef RTE_PORT_STATS_COLLECT + +#define RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_IN_ADD(port, val) \ + (port)->stats.n_pkts_in += (val) +#define RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_DROP_ADD(port, val) \ + (port)->stats.n_pkts_drop += (val) + +#else + +#define RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_IN_ADD(port, val) +#define RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_DROP_ADD(port, val) + +#endif + +struct rte_port_sym_crypto_writer { + struct rte_port_out_stats stats; + + struct rte_crypto_op *tx_buf[2 * RTE_PORT_IN_BURST_SIZE_MAX]; + + uint32_t tx_burst_sz; + uint32_t tx_buf_count; + uint64_t bsz_mask; + + uint8_t cryptodev_id; + uint16_t queue_id; + uint16_t crypto_op_offset; +}; + +static void * +rte_port_sym_crypto_writer_create(void *params, int socket_id) +{ + struct rte_port_sym_crypto_writer_params *conf = + params; + struct rte_port_sym_crypto_writer *port; + + /* Check input parameters */ + if ((conf == NULL) || + (conf->tx_burst_sz == 0) || + (conf->tx_burst_sz > RTE_PORT_IN_BURST_SIZE_MAX) || + (!rte_is_power_of_2(conf->tx_burst_sz))) { + RTE_LOG(ERR, PORT, "%s: Invalid input parameters\n", __func__); + return NULL; + } + + /* Memory allocation */ + port = rte_zmalloc_socket("PORT", sizeof(*port), + RTE_CACHE_LINE_SIZE, socket_id); + if (port == NULL) { + RTE_LOG(ERR, PORT, "%s: Failed to allocate port\n", __func__); + return NULL; + } + + /* Initialization */ + port->tx_burst_sz = conf->tx_burst_sz; + port->tx_buf_count = 0; + port->bsz_mask = 1LLU << (conf->tx_burst_sz - 1); + + port->cryptodev_id = conf->cryptodev_id; + port->queue_id = conf->queue_id; + port->crypto_op_offset = conf->crypto_op_offset; + + return port; +} + +static inline void +send_burst(struct rte_port_sym_crypto_writer *p) +{ + uint32_t nb_tx; + + nb_tx = rte_cryptodev_enqueue_burst(p->cryptodev_id, p->queue_id, + p->tx_buf, p->tx_buf_count); + + RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_DROP_ADD(p, p->tx_buf_count - + nb_tx); + for (; nb_tx < p->tx_buf_count; nb_tx++) + rte_pktmbuf_free(p->tx_buf[nb_tx]->sym->m_src); + + p->tx_buf_count = 0; +} + +static int +rte_port_sym_crypto_writer_tx(void *port, struct rte_mbuf *pkt) +{ + struct rte_port_sym_crypto_writer *p = + port; + + p->tx_buf[p->tx_buf_count++] = (struct rte_crypto_op *) + RTE_MBUF_METADATA_UINT8_PTR(pkt, p->crypto_op_offset); + RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_IN_ADD(p, 1); + if (p->tx_buf_count >= p->tx_burst_sz) + send_burst(p); + + return 0; +} + +static int +rte_port_sym_crypto_writer_tx_bulk(void *port, + struct rte_mbuf **pkts, + uint64_t pkts_mask) +{ + struct rte_port_sym_crypto_writer *p = + port; + uint64_t bsz_mask = p->bsz_mask; + uint32_t tx_buf_count = p->tx_buf_count; + uint64_t expr = (pkts_mask & (pkts_mask + 1)) | + ((pkts_mask & bsz_mask) ^ bsz_mask); + + if (expr == 0) { + uint64_t n_pkts = __builtin_popcountll(pkts_mask); + uint32_t i; + + RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_IN_ADD(p, n_pkts); + + for (i = 0; i < n_pkts; i++) + p->tx_buf[p->tx_buf_count++] = (struct rte_crypto_op *) + RTE_MBUF_METADATA_UINT8_PTR(pkts[i], + p->crypto_op_offset); + + if (p->tx_buf_count >= p->tx_burst_sz) + send_burst(p); + } else { + for (; pkts_mask;) { + uint32_t pkt_index = __builtin_ctzll(pkts_mask); + uint64_t pkt_mask = 1LLU << pkt_index; + struct rte_mbuf *pkt = pkts[pkt_index]; + + p->tx_buf[tx_buf_count++] = (struct rte_crypto_op *) + RTE_MBUF_METADATA_UINT8_PTR(pkt, + p->crypto_op_offset); + + RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_IN_ADD(p, 1); + pkts_mask &= ~pkt_mask; + } + + p->tx_buf_count = tx_buf_count; + if (tx_buf_count >= p->tx_burst_sz) + send_burst(p); + } + + return 0; +} + +static int +rte_port_sym_crypto_writer_flush(void *port) +{ + struct rte_port_sym_crypto_writer *p = + port; + + if (p->tx_buf_count > 0) + send_burst(p); + + return 0; +} + +static int +rte_port_sym_crypto_writer_free(void *port) +{ + if (port == NULL) { + RTE_LOG(ERR, PORT, "%s: Port is NULL\n", __func__); + return -EINVAL; + } + + rte_port_sym_crypto_writer_flush(port); + rte_free(port); + + return 0; +} + +static int rte_port_sym_crypto_writer_stats_read(void *port, + struct rte_port_out_stats *stats, int clear) +{ + struct rte_port_sym_crypto_writer *p = + port; + + if (stats != NULL) + memcpy(stats, &p->stats, sizeof(p->stats)); + + if (clear) + memset(&p->stats, 0, sizeof(p->stats)); + + return 0; +} + +/* + * Port crypto Writer Nodrop + */ +#ifdef RTE_PORT_STATS_COLLECT + +#define RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_IN_ADD(port, val) \ + (port)->stats.n_pkts_in += (val) +#define RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_DROP_ADD(port, val) \ + (port)->stats.n_pkts_drop += (val) + +#else + +#define RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_IN_ADD(port, val) +#define RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_DROP_ADD(port, val) + +#endif + +struct rte_port_sym_crypto_writer_nodrop { + struct rte_port_out_stats stats; + + struct rte_crypto_op *tx_buf[2 * RTE_PORT_IN_BURST_SIZE_MAX]; + uint32_t tx_burst_sz; + uint32_t tx_buf_count; + uint64_t bsz_mask; + uint64_t n_retries; + + uint8_t cryptodev_id; + uint16_t queue_id; + uint16_t crypto_op_offset; +}; + +static void * +rte_port_sym_crypto_writer_nodrop_create(void *params, int socket_id) +{ + struct rte_port_sym_crypto_writer_nodrop_params *conf = + params; + struct rte_port_sym_crypto_writer_nodrop *port; + + /* Check input parameters */ + if ((conf == NULL) || + (conf->tx_burst_sz == 0) || + (conf->tx_burst_sz > RTE_PORT_IN_BURST_SIZE_MAX) || + (!rte_is_power_of_2(conf->tx_burst_sz))) { + RTE_LOG(ERR, PORT, "%s: Invalid input parameters\n", __func__); + return NULL; + } + + /* Memory allocation */ + port = rte_zmalloc_socket("PORT", sizeof(*port), + RTE_CACHE_LINE_SIZE, socket_id); + if (port == NULL) { + RTE_LOG(ERR, PORT, "%s: Failed to allocate port\n", __func__); + return NULL; + } + + /* Initialization */ + port->cryptodev_id = conf->cryptodev_id; + port->queue_id = conf->queue_id; + port->crypto_op_offset = conf->crypto_op_offset; + port->tx_burst_sz = conf->tx_burst_sz; + port->tx_buf_count = 0; + port->bsz_mask = 1LLU << (conf->tx_burst_sz - 1); + + /* + * When n_retries is 0 it means that we should wait for every packet to + * send no matter how many retries should it take. To limit number of + * branches in fast path, we use UINT64_MAX instead of branching. + */ + port->n_retries = (conf->n_retries == 0) ? UINT64_MAX : conf->n_retries; + + return port; +} + +static inline void +send_burst_nodrop(struct rte_port_sym_crypto_writer_nodrop *p) +{ + uint32_t nb_tx = 0, i; + + nb_tx = rte_cryptodev_enqueue_burst(p->cryptodev_id, p->queue_id, + p->tx_buf, p->tx_buf_count); + + /* We sent all the packets in a first try */ + if (nb_tx >= p->tx_buf_count) { + p->tx_buf_count = 0; + return; + } + + for (i = 0; i < p->n_retries; i++) { + nb_tx += rte_cryptodev_enqueue_burst(p->cryptodev_id, + p->queue_id, p->tx_buf + nb_tx, + p->tx_buf_count - nb_tx); + + /* We sent all the packets in more than one try */ + if (nb_tx >= p->tx_buf_count) { + p->tx_buf_count = 0; + return; + } + } + + /* We didn't send the packets in maximum allowed attempts */ + RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_DROP_ADD(p, + p->tx_buf_count - nb_tx); + for ( ; nb_tx < p->tx_buf_count; nb_tx++) + rte_pktmbuf_free(p->tx_buf[nb_tx]->sym->m_src); + + p->tx_buf_count = 0; +} + +static int +rte_port_sym_crypto_writer_nodrop_tx(void *port, struct rte_mbuf *pkt) +{ + struct rte_port_sym_crypto_writer_nodrop *p = + port; + + p->tx_buf[p->tx_buf_count++] = (struct rte_crypto_op *) + RTE_MBUF_METADATA_UINT8_PTR(pkt, p->crypto_op_offset); + RTE_PORT_SYM_CRYPTO_WRITER_STATS_PKTS_IN_ADD(p, 1); + if (p->tx_buf_count >= p->tx_burst_sz) + send_burst_nodrop(p); + + return 0; +} + +static int +rte_port_sym_crypto_writer_nodrop_tx_bulk(void *port, + struct rte_mbuf **pkts, + uint64_t pkts_mask) +{ + struct rte_port_sym_crypto_writer_nodrop *p = + port; + + uint64_t bsz_mask = p->bsz_mask; + uint32_t tx_buf_count = p->tx_buf_count; + uint64_t expr = (pkts_mask & (pkts_mask + 1)) | + ((pkts_mask & bsz_mask) ^ bsz_mask); + + if (expr == 0) { + uint64_t n_pkts = __builtin_popcountll(pkts_mask); + uint32_t i; + + RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_IN_ADD(p, n_pkts); + + for (i = 0; i < n_pkts; i++) + p->tx_buf[p->tx_buf_count++] = (struct rte_crypto_op *) + RTE_MBUF_METADATA_UINT8_PTR(pkts[i], + p->crypto_op_offset); + + if (p->tx_buf_count >= p->tx_burst_sz) + send_burst_nodrop(p); + } else { + for ( ; pkts_mask; ) { + uint32_t pkt_index = __builtin_ctzll(pkts_mask); + uint64_t pkt_mask = 1LLU << pkt_index; + struct rte_mbuf *pkt = pkts[pkt_index]; + + p->tx_buf[tx_buf_count++] = (struct rte_crypto_op *) + RTE_MBUF_METADATA_UINT8_PTR(pkt, + p->crypto_op_offset); + RTE_PORT_SYM_CRYPTO_WRITER_NODROP_STATS_PKTS_IN_ADD(p, + 1); + pkts_mask &= ~pkt_mask; + } + + p->tx_buf_count = tx_buf_count; + if (tx_buf_count >= p->tx_burst_sz) + send_burst_nodrop(p); + } + + return 0; +} + +static int +rte_port_sym_crypto_writer_nodrop_flush(void *port) +{ + struct rte_port_sym_crypto_writer_nodrop *p = + port; + + if (p->tx_buf_count > 0) + send_burst_nodrop(p); + + return 0; +} + +static int +rte_port_sym_crypto_writer_nodrop_free(void *port) +{ + if (port == NULL) { + RTE_LOG(ERR, PORT, "%s: Port is NULL\n", __func__); + return -EINVAL; + } + + rte_port_sym_crypto_writer_nodrop_flush(port); + rte_free(port); + + return 0; +} + +static int rte_port_sym_crypto_writer_nodrop_stats_read(void *port, + struct rte_port_out_stats *stats, int clear) +{ + struct rte_port_sym_crypto_writer_nodrop *p = + port; + + if (stats != NULL) + memcpy(stats, &p->stats, sizeof(p->stats)); + + if (clear) + memset(&p->stats, 0, sizeof(p->stats)); + + return 0; +} + + +/* + * Summary of port operations + */ +struct rte_port_in_ops rte_port_sym_crypto_reader_ops = { + .f_create = rte_port_sym_crypto_reader_create, + .f_free = rte_port_sym_crypto_reader_free, + .f_rx = rte_port_sym_crypto_reader_rx, + .f_stats = rte_port_sym_crypto_reader_stats_read, +}; + +struct rte_port_out_ops rte_port_sym_crypto_writer_ops = { + .f_create = rte_port_sym_crypto_writer_create, + .f_free = rte_port_sym_crypto_writer_free, + .f_tx = rte_port_sym_crypto_writer_tx, + .f_tx_bulk = rte_port_sym_crypto_writer_tx_bulk, + .f_flush = rte_port_sym_crypto_writer_flush, + .f_stats = rte_port_sym_crypto_writer_stats_read, +}; + +struct rte_port_out_ops rte_port_sym_crypto_writer_nodrop_ops = { + .f_create = rte_port_sym_crypto_writer_nodrop_create, + .f_free = rte_port_sym_crypto_writer_nodrop_free, + .f_tx = rte_port_sym_crypto_writer_nodrop_tx, + .f_tx_bulk = rte_port_sym_crypto_writer_nodrop_tx_bulk, + .f_flush = rte_port_sym_crypto_writer_nodrop_flush, + .f_stats = rte_port_sym_crypto_writer_nodrop_stats_read, +}; diff --git a/lib/librte_port/rte_port_sym_crypto.h b/lib/librte_port/rte_port_sym_crypto.h new file mode 100644 index 0000000000..181f6ce01d --- /dev/null +++ b/lib/librte_port/rte_port_sym_crypto.h @@ -0,0 +1,93 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2018 Intel Corporation + */ + +#ifndef __INCLUDE_RTE_PORT_SYM_CRYPTO_H__ +#define __INCLUDE_RTE_PORT_SYM_CRYPTO_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @file + * RTE Port sym crypto Interface + * + * crypto_reader: input port built on top of pre-initialized crypto interface + * crypto_writer: output port built on top of pre-initialized crypto interface + * + **/ + +#include + +#include + +#include "rte_port.h" + +/** Function prototype for reader post action. */ +typedef void (*rte_port_sym_crypto_reader_callback_fn)(struct rte_mbuf **pkts, + uint16_t n_pkts, void *arg); + +/** Crypto_reader port parameters */ +struct rte_port_sym_crypto_reader_params { + /** Target cryptodev ID. */ + uint8_t cryptodev_id; + + /** Target cryptodev Queue Pair ID. */ + uint16_t queue_id; + + /** Crypto reader post callback function. */ + rte_port_sym_crypto_reader_callback_fn f_callback; + + /** Crypto reader post callback function arguments. */ + void *arg_callback; +}; + +/** Crypto_reader port operations. */ +extern struct rte_port_in_ops rte_port_sym_crypto_reader_ops; + + +/** Crypto_writer port parameters. */ +struct rte_port_sym_crypto_writer_params { + /** Target cryptodev ID. */ + uint8_t cryptodev_id; + + /** Target cryptodev Queue Pair ID. */ + uint16_t queue_id; + + /** offset to rte_crypto_op in the mbufs. */ + uint16_t crypto_op_offset; + + /** Burst size to crypto interface. */ + uint32_t tx_burst_sz; +}; + +/** Crypto_writer port operations. */ +extern struct rte_port_out_ops rte_port_sym_crypto_writer_ops; + +/** Crypto_writer_nodrop port parameters. */ +struct rte_port_sym_crypto_writer_nodrop_params { + /** Target cryptodev ID. */ + uint8_t cryptodev_id; + + /** Target cryptodev queue pair id. */ + uint16_t queue_id; + + /** Offset to rte_crypto_op in the mbufs. */ + uint16_t crypto_op_offset; + + /** Burst size to crypto interface. */ + uint32_t tx_burst_sz; + + /** Maximum number of retries, 0 for no limit. */ + uint32_t n_retries; +}; + +/** Crypto_writer_nodrop port operations. */ +extern struct rte_port_out_ops rte_port_sym_crypto_writer_nodrop_ops; + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/lib/librte_port/rte_port_version.map b/lib/librte_port/rte_port_version.map index 6470629b42..609bcec3ff 100644 --- a/lib/librte_port/rte_port_version.map +++ b/lib/librte_port/rte_port_version.map @@ -51,3 +51,12 @@ DPDK_16.11 { rte_port_fd_writer_nodrop_ops; } DPDK_16.07; + +DPDK_18.11 { + global: + + rte_port_sym_crypto_reader_ops; + rte_port_sym_crypto_writer_ops; + rte_port_sym_crypto_writer_nodrop_ops; + +} DPDK_16.11; -- 2.20.1