API Reference Manual  1.45.1
ipsec_api/odp_ipsec.c

IPsec example application using ODP IPsec API

/* SPDX-License-Identifier: BSD-3-Clause
* Copyright (c) 2013-2018 Linaro Limited
*/
/* enable strtok */
#ifndef _GNU_SOURCE
#define _GNU_SOURCE
#endif
#include <stdlib.h>
#include <getopt.h>
#include <signal.h>
#include <unistd.h>
#include <inttypes.h>
#include <odp_api.h>
#include <odp/helper/odph_api.h>
#include <stdbool.h>
#include <sys/socket.h>
#include <net/if.h>
#include <sys/ioctl.h>
#include <sys/socket.h>
#include <netpacket/packet.h>
#include <net/ethernet.h>
#include <arpa/inet.h>
#include <odp_ipsec_misc.h>
#include <odp_ipsec_sa_db.h>
#include <odp_ipsec_sp_db.h>
#include <odp_ipsec_fwd_db.h>
#include <odp_ipsec_cache.h>
#ifndef NO_OPENSSL
#include <odp_ipsec_stream.h>
#else
static void init_stream_db(void) {}
static void deinit_stream_db(void) {}
static void resolve_stream_db(void) {}
static int create_stream_db_inputs(void)
{
return 0;
}
static odp_bool_t verify_stream_db_outputs(void)
{
return true;
}
static int create_stream_db_entry(char *input ODP_UNUSED)
{
return -1;
}
#endif
/* maximum number of worker threads */
#define MAX_WORKERS (ODP_THREAD_COUNT_MAX - 1)
#define MAX_POLL_QUEUES 256
typedef struct {
unsigned int cpu_count;
int if_count;
char **if_names;
odp_pool_t pool;
char *if_str;
odp_bool_t lookup;
} appl_args_t;
typedef struct {
appl_args_t appl;
odp_shm_t shm;
odp_pool_t ctx_pool;
odp_pool_t pkt_pool;
odp_queue_t completionq;
odp_barrier_t sync_barrier;
odp_queue_t poll_queues[MAX_POLL_QUEUES];
int num_polled_queues;
/* Stop workers if set to 1 */
odp_atomic_u32_t exit_threads;
} global_data_t;
/* helper funcs */
static void parse_args(int argc, char *argv[], appl_args_t *appl_args);
static void print_info(char *progname, appl_args_t *appl_args);
static void usage(char *progname);
#define SHM_PKT_POOL_BUF_COUNT 1024
#define SHM_PKT_POOL_BUF_SIZE 4096
#define SHM_PKT_POOL_SIZE (SHM_PKT_POOL_BUF_COUNT * SHM_PKT_POOL_BUF_SIZE)
typedef enum {
PKT_STATE_INPUT_VERIFY,
PKT_STATE_IPSEC_IN_CLASSIFY,
PKT_STATE_ROUTE_LOOKUP,
PKT_STATE_IPSEC_OUT_CLASSIFY,
PKT_STATE_TRANSMIT,
} pkt_state_e;
typedef enum {
PKT_CONTINUE,
PKT_POSTED,
PKT_DROP,
PKT_DONE
} pkt_disposition_e;
typedef struct {
odp_buffer_t buffer;
pkt_state_e state;
odp_pktio_t pktio;
odph_ethhdr_t eth;
} pkt_ctx_t;
#define SHM_CTX_POOL_BUF_SIZE (sizeof(pkt_ctx_t))
#define SHM_CTX_POOL_BUF_COUNT (SHM_PKT_POOL_BUF_COUNT)
#define SHM_CTX_POOL_SIZE (SHM_CTX_POOL_BUF_COUNT * SHM_CTX_POOL_BUF_SIZE)
static global_data_t *global;
static void sig_handler(int signo ODP_UNUSED)
{
if (global == NULL)
return;
odp_atomic_store_u32(&global->exit_threads, 1);
}
static
pkt_ctx_t *alloc_pkt_ctx(odp_packet_t pkt)
{
odp_buffer_t ctx_buf = odp_buffer_alloc(global->ctx_pool);
pkt_ctx_t *ctx;
return NULL;
ctx = odp_buffer_addr(ctx_buf);
memset(ctx, 0, sizeof(*ctx));
ctx->buffer = ctx_buf;
return ctx;
}
static
void free_pkt_ctx(pkt_ctx_t *ctx)
{
odp_buffer_free(ctx->buffer);
}
typedef odp_queue_t (*queue_create_func_t)
(const char *, const odp_queue_param_t *);
typedef odp_event_t (*schedule_func_t) (odp_queue_t *);
static queue_create_func_t queue_create;
static schedule_func_t schedule_fn;
static
odp_queue_t polled_odp_queue_create(const char *name,
const odp_queue_param_t *param)
{
odp_queue_t my_queue;
if (param)
memcpy(&qp, param, sizeof(odp_queue_param_t));
type = qp.type;
if (ODP_QUEUE_TYPE_SCHED == type) {
printf("%s: change %s to PLAIN\n", __func__, name);
}
my_queue = odp_queue_create(name, &qp);
if (ODP_QUEUE_TYPE_SCHED == type) {
global->poll_queues[global->num_polled_queues++] = my_queue;
printf("%s: adding %" PRIu64 "\n", __func__,
odp_queue_to_u64(my_queue));
}
return my_queue;
}
static inline
odp_event_t odp_schedule_cb(odp_queue_t *from)
{
}
static
odp_event_t polled_odp_schedule_cb(odp_queue_t *from)
{
int idx = 0;
while (idx < global->num_polled_queues) {
odp_queue_t queue = global->poll_queues[idx++];
ev = odp_queue_deq(queue);
if (ODP_EVENT_INVALID != ev) {
if (from)
*from = queue;
return ev;
}
}
if (from)
}
static
void ipsec_init_pre(void)
{
/*
* Create queues
*
* - completion queue (should eventually be ORDERED)
* - sequence number queue (must be ATOMIC)
*/
global->completionq = queue_create("completion", &qparam);
if (ODP_QUEUE_INVALID == global->completionq) {
ODPH_ERR("Error: completion queue creation failed\n");
exit(EXIT_FAILURE);
}
/* Initialize our data bases */
init_sp_db();
init_sa_db();
init_tun_db();
init_ipsec_cache();
}
static
void ipsec_init_post(odp_ipsec_op_mode_t api_mode)
{
sp_db_entry_t *entry;
odp_ipsec_config_t ipsec_config;
if (odp_ipsec_capability(&ipsec_cap) != ODP_IPSEC_OK) {
ODPH_ERR("Error: failure getting IPSec caps\n");
exit(EXIT_FAILURE);
}
odp_ipsec_config_init(&ipsec_config);
ipsec_config.inbound_mode = api_mode;
ipsec_config.outbound_mode = api_mode;
ipsec_config.inbound.default_queue = global->completionq;
if (odp_ipsec_config(&ipsec_config) != ODP_IPSEC_OK) {
ODPH_ERR("Error: failure setting IPSec config\n");
exit(EXIT_FAILURE);
}
/* Attempt to find appropriate SA for each SP */
for (entry = sp_db->list; NULL != entry; entry = entry->next) {
sa_db_entry_t *cipher_sa = NULL;
sa_db_entry_t *auth_sa = NULL;
tun_db_entry_t *tun = NULL;
if (entry->esp) {
cipher_sa = find_sa_db_entry(&entry->src_subnet,
&entry->dst_subnet,
1);
tun = find_tun_db_entry(cipher_sa->src_ip,
cipher_sa->dst_ip);
}
if (entry->ah) {
auth_sa = find_sa_db_entry(&entry->src_subnet,
&entry->dst_subnet,
0);
tun = find_tun_db_entry(auth_sa->src_ip,
auth_sa->dst_ip);
}
if (cipher_sa || auth_sa) {
if (create_ipsec_cache_entry(cipher_sa,
auth_sa,
tun,
entry->input,
global->completionq)) {
ODPH_ERR("Error: IPSec cache entry failed.\n"
);
exit(EXIT_FAILURE);
}
} else {
printf(" WARNING: SA not found for SP\n");
dump_sp_db_entry(entry);
}
}
}
#ifndef NO_OPENSSL
static
int check_stream_db_in(const char *intf)
{
stream_db_entry_t *stream = NULL;
/* For each stream look for input and output IPsec entries */
for (stream = stream_db->list; NULL != stream; stream = stream->next) {
if (!strcmp(stream->input.intf, intf))
return 1;
}
return 0;
}
static
int check_stream_db_out(const char *intf)
{
stream_db_entry_t *stream = NULL;
/* For each stream look for input and output IPsec entries */
for (stream = stream_db->list; NULL != stream; stream = stream->next) {
if (!strcmp(stream->output.intf, intf))
return 1;
}
return 0;
}
#else
static
int check_stream_db_in(const char *intf ODP_UNUSED)
{
return 0;
}
static
int check_stream_db_out(const char *intf ODP_UNUSED)
{
return 0;
}
#endif
static
void initialize_intf(char *intf)
{
odp_pktio_t pktio;
int ret;
uint8_t src_mac[ODPH_ETHADDR_LEN];
char src_mac_str[MAX_STRING];
odp_pktio_param_t pktio_param;
odp_pktio_param_init(&pktio_param);
if (getenv("ODP_IPSEC_USE_POLL_QUEUES") ||
check_stream_db_out(intf))
else
/*
* Open a packet IO instance for thread and get default output queue
*/
pktio = odp_pktio_open(intf, global->pkt_pool, &pktio_param);
if (ODP_PKTIO_INVALID == pktio) {
ODPH_ERR("Error: pktio create failed for %s\n", intf);
exit(EXIT_FAILURE);
}
if (odp_pktin_queue_config(pktio, &pktin_param)) {
ODPH_ERR("Error: pktin config failed for %s\n", intf);
exit(EXIT_FAILURE);
}
if (odp_pktout_queue_config(pktio, NULL)) {
ODPH_ERR("Error: pktout config failed for %s\n", intf);
exit(EXIT_FAILURE);
}
if (odp_pktin_event_queue(pktio, &inq, 1) != 1) {
ODPH_ERR("Error: failed to get input queue for %s\n", intf);
exit(EXIT_FAILURE);
}
if (odp_pktout_queue(pktio, &pktout, 1) != 1) {
ODPH_ERR("Error: failed to get pktout queue for %s\n", intf);
exit(EXIT_FAILURE);
}
if (odp_pktio_capability(pktio, &capa) != 0) {
ODPH_ERR("Error: failed to get capabilities for %s\n", intf);
exit(EXIT_FAILURE);
}
if (check_stream_db_in(intf) &&
global->appl.mode == ODP_IPSEC_OP_MODE_INLINE)
if (check_stream_db_out(intf) &&
global->appl.mode == ODP_IPSEC_OP_MODE_INLINE)
if (odp_pktio_config(pktio, &config) != 0) {
ODPH_ERR("Error: failed to set config for %s\n", intf);
exit(EXIT_FAILURE);
}
ret = odp_pktio_start(pktio);
if (ret) {
ODPH_ERR("Error: unable to start %s\n", intf);
exit(EXIT_FAILURE);
}
/* Read the source MAC address for this interface */
ret = odp_pktio_mac_addr(pktio, src_mac, sizeof(src_mac));
if (ret <= 0) {
ODPH_ERR("Error: failed during MAC address get for %s\n", intf);
exit(EXIT_FAILURE);
}
printf("Created pktio:%02" PRIu64 ", queue mode (ATOMIC queues)\n"
" default pktio%02" PRIu64 "-INPUT queue:%" PRIu64 "\n"
" source mac address %s\n",
mac_addr_str(src_mac_str, src_mac));
/* Resolve any routes using this interface for output */
resolve_fwd_db(intf, pktio, pktout, src_mac);
}
static
pkt_disposition_e do_input_verify(odp_packet_t pkt,
pkt_ctx_t *ctx ODP_UNUSED)
{
return PKT_DROP;
if (!odp_packet_has_eth(pkt))
return PKT_DROP;
return PKT_DROP;
return PKT_CONTINUE;
}
static
pkt_disposition_e do_route_fwd_db(odp_packet_t pkt, pkt_ctx_t *ctx)
{
odph_ipv4hdr_t *ip = (odph_ipv4hdr_t *)odp_packet_l3_ptr(pkt, NULL);
fwd_db_entry_t *entry;
entry = find_fwd_db_entry(odp_be_to_cpu_32(ip->dst_addr));
if (entry) {
uint32_t l3_offset = odp_packet_l3_offset(pkt);
if (l3_offset > sizeof(odph_ethhdr_t))
l3_offset - sizeof(odph_ethhdr_t));
else
sizeof(odph_ethhdr_t) - l3_offset);
memcpy(&ctx->eth.dst, entry->dst_mac, ODPH_ETHADDR_LEN);
memcpy(&ctx->eth.src, entry->src_mac, ODPH_ETHADDR_LEN);
ctx->eth.type = odp_cpu_to_be_16(ODPH_ETHTYPE_IPV4);
if (global->appl.mode != ODP_IPSEC_OP_MODE_INLINE) {
odp_packet_copy_from_mem(pkt, 0, ODPH_ETHHDR_LEN,
&ctx->eth);
}
ctx->pktio = entry->pktio;
ctx->pktout = entry->pktout;
return PKT_CONTINUE;
}
return PKT_DROP;
}
static
pkt_disposition_e do_ipsec_in_classify(odp_packet_t *ppkt)
{
odph_ipv4hdr_t *ip = (odph_ipv4hdr_t *)odp_packet_l3_ptr(*ppkt, NULL);
odph_ahhdr_t *ah = NULL;
odph_esphdr_t *esp = NULL;
ipsec_cache_entry_t *entry;
int rc;
/* Check IP header for IPSec protocols and look it up */
locate_ipsec_headers(ip, &ah, &esp);
if (!ah && !esp)
return PKT_CONTINUE;
entry = find_ipsec_cache_entry_in(odp_be_to_cpu_32(ip->src_addr),
odp_be_to_cpu_32(ip->dst_addr),
ah,
esp);
if (!entry)
return PKT_CONTINUE;
memset(&in_param, 0, sizeof(in_param));
if (global->appl.lookup) {
in_param.num_sa = 0;
in_param.sa = NULL;
} else {
in_param.num_sa = 1;
in_param.sa = &entry->ipsec_sa;
}
/* Issue crypto request */
if (global->appl.mode != ODP_IPSEC_OP_MODE_SYNC) {
rc = odp_ipsec_in_enq(ppkt, 1, &in_param);
if (rc <= 0)
return PKT_DROP;
return PKT_POSTED;
} else {
int out = 1;
rc = odp_ipsec_in(ppkt, 1, ppkt, &out, &in_param);
if (rc <= 0)
return PKT_DROP;
if (odp_ipsec_result(&result, *ppkt) < 0) {
ODPH_DBG("odp_ipsec_result() failed\n");
return PKT_DROP;
}
if (result.status.error.all != 0) {
ODPH_DBG("Error in inbound IPsec processing\n");
return PKT_DROP;
}
return PKT_CONTINUE;
}
}
static
pkt_disposition_e do_ipsec_out_classify(odp_packet_t *ppkt, pkt_ctx_t *ctx)
{
odph_ipv4hdr_t *ip = (odph_ipv4hdr_t *)odp_packet_l3_ptr(*ppkt, NULL);
ipsec_cache_entry_t *entry;
int rc;
/* Find record */
entry = find_ipsec_cache_entry_out(odp_be_to_cpu_32(ip->src_addr),
odp_be_to_cpu_32(ip->dst_addr),
ip->proto);
if (!entry)
return PKT_CONTINUE;
memset(&out_param, 0, sizeof(out_param));
out_param.num_sa = 1;
out_param.num_opt = 0;
out_param.sa = &entry->ipsec_sa;
out_param.opt = NULL;
/* Issue crypto request */
if (global->appl.mode == ODP_IPSEC_OP_MODE_INLINE) {
inline_param.pktio = ctx->pktio;
inline_param.outer_hdr.ptr = (void *)&ctx->eth;
inline_param.outer_hdr.len = ODPH_ETHHDR_LEN;
rc = odp_ipsec_out_inline(ppkt, 1, &out_param, &inline_param);
if (rc <= 0)
return PKT_DROP;
return PKT_DONE;
} else if (global->appl.mode != ODP_IPSEC_OP_MODE_SYNC) {
rc = odp_ipsec_out_enq(ppkt, 1, &out_param);
if (rc <= 0)
return PKT_DROP;
return PKT_POSTED;
} else {
int out = 1;
rc = odp_ipsec_out(ppkt, 1, ppkt, &out, &out_param);
if (rc <= 0)
return PKT_DROP;
if (odp_ipsec_result(&result, *ppkt) < 0) {
ODPH_DBG("odp_ipsec_result() failed\n");
return PKT_DROP;
}
if (result.status.error.all != 0) {
ODPH_DBG("Error in outbound IPsec processing\n");
return PKT_DROP;
}
return PKT_CONTINUE;
}
}
static
int pktio_thread(void *arg ODP_UNUSED)
{
int thr;
unsigned long pkt_cnt = 0;
thr = odp_thread_id();
printf("Pktio thread [%02i] starts\n", thr);
odp_barrier_wait(&global->sync_barrier);
/* Loop packets */
while (!odp_atomic_load_u32(&global->exit_threads)) {
pkt_disposition_e rc = PKT_CONTINUE;
pkt_ctx_t *ctx;
odp_queue_t dispatchq;
/* Use schedule to get event from any input queue */
ev = schedule_fn(&dispatchq);
if (ev == ODP_EVENT_INVALID)
continue;
/* Determine new work versus completion or sequence number */
if (ODP_EVENT_PACKET == odp_event_types(ev, &subtype)) {
if (ODP_EVENT_PACKET_BASIC == subtype) {
ctx = alloc_pkt_ctx(pkt);
if (!ctx) {
continue;
}
ctx->state = PKT_STATE_INPUT_VERIFY;
} else if (ODP_EVENT_PACKET_IPSEC == subtype) {
pkt) < 0)) {
ODPH_DBG("Error Event\n");
continue;
}
if (result.status.error.all != 0) {
ODPH_DBG("Error in IPsec\n");
rc = PKT_DROP;
}
if (result.flag.inline_mode) {
ctx = alloc_pkt_ctx(pkt);
if (!ctx) {
continue;
}
rc = PKT_DROP;
ctx->state = PKT_STATE_ROUTE_LOOKUP;
} else {
ctx = odp_packet_user_ptr(pkt);
}
} else {
ODPH_DBG("Unsupported Packet\n");
continue;
}
} else if (ODP_EVENT_IPSEC_STATUS == odp_event_type(ev)) {
if (odp_unlikely(odp_ipsec_status(&status, ev) < 0)) {
ODPH_DBG("Error Event\n");
continue;
}
printf("IPsec status %d result %d for SA %" PRIx64 "\n",
status.id, status.result,
continue;
} else {
abort();
}
/*
* We now have a packet and its associated context. Loop here
* executing processing based on the current state value stored
* in the context as long as the processing return code
* indicates PKT_CONTINUE.
*
* For other return codes:
*
* o PKT_DONE - finished with the packet
* o PKT_DROP - something incorrect about the packet, drop it
* o PKT_POSTED - packet/event has been queued for later
*/
while (rc == PKT_CONTINUE) {
switch (ctx->state) {
case PKT_STATE_INPUT_VERIFY:
rc = do_input_verify(pkt, ctx);
ctx->state = PKT_STATE_IPSEC_IN_CLASSIFY;
break;
case PKT_STATE_IPSEC_IN_CLASSIFY:
ctx->state = PKT_STATE_ROUTE_LOOKUP;
rc = do_ipsec_in_classify(&pkt);
break;
case PKT_STATE_ROUTE_LOOKUP:
rc = do_route_fwd_db(pkt, ctx);
ctx->state = PKT_STATE_IPSEC_OUT_CLASSIFY;
break;
case PKT_STATE_IPSEC_OUT_CLASSIFY:
ctx->state = PKT_STATE_TRANSMIT;
rc = do_ipsec_out_classify(&pkt, ctx);
break;
case PKT_STATE_TRANSMIT:
if (odp_pktout_send(ctx->pktout, &pkt, 1) < 1)
rc = PKT_DROP;
else
rc = PKT_DONE;
break;
default:
rc = PKT_DROP;
break;
}
}
/* Free context on drop or transmit */
if ((PKT_DROP == rc) || (PKT_DONE == rc))
free_pkt_ctx(ctx);
/* Check for drop */
if (PKT_DROP == rc)
/* Print packet counts every once in a while */
if (PKT_DONE == rc) {
if (odp_unlikely(pkt_cnt++ % 1000 == 0)) {
printf(" [%02i] pkt_cnt:%lu\n", thr, pkt_cnt);
fflush(NULL);
}
}
}
return 0;
}
int
main(int argc, char *argv[])
{
odph_helper_options_t helper_options;
odph_thread_t thread_tbl[MAX_WORKERS];
odph_thread_common_param_t thr_common;
odph_thread_param_t thr_param;
int num_workers;
int i;
int stream_count;
odp_shm_t shm;
odp_cpumask_t cpumask;
char cpumaskstr[ODP_CPUMASK_STR_SIZE];
odp_instance_t instance;
odp_init_t init_param;
/* create by default scheduled queues */
queue_create = odp_queue_create;
schedule_fn = odp_schedule_cb;
/* check for using poll queues */
if (getenv("ODP_IPSEC_USE_POLL_QUEUES")) {
queue_create = polled_odp_queue_create;
schedule_fn = polled_odp_schedule_cb;
}
/* Let helper collect its own arguments (e.g. --odph_proc) */
argc = odph_parse_options(argc, argv);
if (odph_options(&helper_options)) {
ODPH_ERR("Error: reading ODP helper options failed.\n");
exit(EXIT_FAILURE);
}
/* Signal handler has to be registered before global init in case ODP
* implementation creates internal threads/processes. */
signal(SIGINT, sig_handler);
odp_init_param_init(&init_param);
init_param.mem_model = helper_options.mem_model;
/* Init ODP before calling anything else */
if (odp_init_global(&instance, &init_param, NULL)) {
ODPH_ERR("Error: ODP global init failed.\n");
exit(EXIT_FAILURE);
}
/* Init this thread */
ODPH_ERR("Error: ODP local init failed.\n");
exit(EXIT_FAILURE);
}
if (odp_ipsec_capability(&ipsec_capa)) {
ODPH_ERR("Error: IPsec capability request failed.\n");
exit(EXIT_FAILURE);
}
if (queue_create == polled_odp_queue_create) {
if (!ipsec_capa.queue_type_plain) {
ODPH_ERR("Error: Plain type dest queue not supported.\n");
exit(EXIT_FAILURE);
}
} else {
if (!ipsec_capa.queue_type_sched) {
ODPH_ERR("Error: scheduled type dest queue not supported.\n");
exit(EXIT_FAILURE);
}
}
/* Reserve memory for args from shared mem */
shm = odp_shm_reserve("shm_args", sizeof(global_data_t),
ODP_CACHE_LINE_SIZE, 0);
if (shm == ODP_SHM_INVALID) {
ODPH_ERR("Error: shared mem reserve failed.\n");
exit(EXIT_FAILURE);
}
global = odp_shm_addr(shm);
if (NULL == global) {
ODPH_ERR("Error: shared mem alloc failed.\n");
exit(EXIT_FAILURE);
}
memset(global, 0, sizeof(global_data_t));
global->shm = shm;
odp_atomic_init_u32(&global->exit_threads, 0);
/* Configure scheduler */
/* Must init our databases before parsing args */
ipsec_init_pre();
init_fwd_db();
init_stream_db();
/* Parse and store the application arguments */
parse_args(argc, argv, &global->appl);
/* Print both system and application information */
print_info(NO_PATH(argv[0]), &global->appl);
num_workers = MAX_WORKERS;
if (global->appl.cpu_count && global->appl.cpu_count < MAX_WORKERS)
num_workers = global->appl.cpu_count;
/* Get default worker cpumask */
num_workers = odp_cpumask_default_worker(&cpumask, num_workers);
(void)odp_cpumask_to_str(&cpumask, cpumaskstr, sizeof(cpumaskstr));
printf("num worker threads: %i\n", num_workers);
printf("first CPU: %i\n", odp_cpumask_first(&cpumask));
printf("cpu mask: %s\n", cpumaskstr);
/* Create a barrier to synchronize thread startup */
odp_barrier_init(&global->sync_barrier, num_workers);
/* Create packet buffer pool */
params.pkt.seg_len = SHM_PKT_POOL_BUF_SIZE;
params.pkt.len = SHM_PKT_POOL_BUF_SIZE;
params.pkt.num = SHM_PKT_POOL_BUF_COUNT;
global->pkt_pool = odp_pool_create("packet_pool", &params);
if (ODP_POOL_INVALID == global->pkt_pool) {
ODPH_ERR("Error: packet pool create failed.\n");
exit(EXIT_FAILURE);
}
/* Create context buffer pool */
params.buf.size = SHM_CTX_POOL_BUF_SIZE;
params.buf.align = 0;
params.buf.num = SHM_CTX_POOL_BUF_COUNT;
global->ctx_pool = odp_pool_create("ctx_pool", &params);
if (ODP_POOL_INVALID == global->ctx_pool) {
ODPH_ERR("Error: context pool create failed.\n");
exit(EXIT_FAILURE);
}
/* Populate our IPsec cache */
printf("Using %s mode for IPsec API\n\n",
(ODP_IPSEC_OP_MODE_SYNC == global->appl.mode) ? "SYNC" :
(ODP_IPSEC_OP_MODE_ASYNC == global->appl.mode) ? "ASYNC" :
"INLINE");
ipsec_init_post(global->appl.mode);
/* Initialize interfaces (which resolves FWD DB entries */
for (i = 0; i < global->appl.if_count; i++)
initialize_intf(global->appl.if_names[i]);
/* If we have test streams build them before starting workers */
resolve_stream_db();
stream_count = create_stream_db_inputs();
if (stream_count < 0) {
ODPH_ERR("Error: creating input packets failed\n");
exit(EXIT_FAILURE);
}
/*
* Create and init worker threads
*/
odph_thread_common_param_init(&thr_common);
thr_common.instance = instance;
thr_common.cpumask = &cpumask;
thr_common.share_param = 1;
odph_thread_param_init(&thr_param);
thr_param.start = pktio_thread;
thr_param.arg = NULL;
thr_param.thr_type = ODP_THREAD_WORKER;
memset(thread_tbl, 0, sizeof(thread_tbl));
odph_thread_create(thread_tbl, &thr_common, &thr_param, num_workers);
/* If there are streams attempt to verify them. Otherwise, run until
* SIGINT is received. */
if (stream_count) {
odp_bool_t done;
do {
done = verify_stream_db_outputs();
usleep(100000);
} while (!done);
printf("All received\n");
odp_atomic_store_u32(&global->exit_threads, 1);
}
odph_thread_join(thread_tbl, num_workers);
/* Stop and close used pktio devices */
for (i = 0; i < global->appl.if_count; i++) {
odp_pktio_t pktio = odp_pktio_lookup(global->appl.if_names[i]);
if (pktio == ODP_PKTIO_INVALID)
continue;
if (odp_pktio_stop(pktio) || odp_pktio_close(pktio)) {
ODPH_ERR("Error: failed to close pktio %s\n",
global->appl.if_names[i]);
exit(EXIT_FAILURE);
}
}
free(global->appl.if_names);
free(global->appl.if_str);
if (destroy_ipsec_cache())
ODPH_ERR("Error: crypto session destroy failed\n");
/* Drop any remaining events. ipsec_sa_disable sends status event in
* async mode */
while ((ev = schedule_fn(NULL)) != ODP_EVENT_INVALID)
if (odp_queue_destroy(global->completionq))
ODPH_ERR("Error: queue destroy failed\n");
if (odp_pool_destroy(global->pkt_pool))
ODPH_ERR("Error: pool destroy failed\n");
if (odp_pool_destroy(global->ctx_pool))
ODPH_ERR("Error: pool destroy failed\n");
shm = odp_shm_lookup("shm_ipsec_cache");
if (odp_shm_free(shm) != 0)
ODPH_ERR("Error: shm free shm_ipsec_cache failed\n");
shm = odp_shm_lookup("shm_fwd_db");
if (odp_shm_free(shm) != 0)
ODPH_ERR("Error: shm free shm_fwd_db failed\n");
shm = odp_shm_lookup("shm_sa_db");
if (odp_shm_free(shm) != 0)
ODPH_ERR("Error: shm free shm_sa_db failed\n");
shm = odp_shm_lookup("shm_tun_db");
if (odp_shm_free(shm) != 0)
ODPH_ERR("Error: shm free shm_tun_db failed\n");
shm = odp_shm_lookup("shm_sp_db");
if (odp_shm_free(shm) != 0)
ODPH_ERR("Error: shm free shm_sp_db failed\n");
deinit_stream_db();
if (odp_shm_free(global->shm)) {
ODPH_ERR("Error: shm free global data failed\n");
exit(EXIT_FAILURE);
}
if (odp_term_local()) {
ODPH_ERR("Error: term local failed\n");
exit(EXIT_FAILURE);
}
if (odp_term_global(instance)) {
ODPH_ERR("Error: term global failed\n");
exit(EXIT_FAILURE);
}
printf("Exit\n\n");
return 0;
}
static void parse_args(int argc, char *argv[], appl_args_t *appl_args)
{
int opt;
int long_index;
char *token;
size_t len;
int rc = 0;
int i;
static const struct option longopts[] = {
{"count", required_argument, NULL, 'c'},
{"interface", required_argument, NULL, 'i'}, /* return 'i' */
{"lookup", no_argument, NULL, 'l'},
{"mode", required_argument, NULL, 'm'}, /* return 'm' */
{"route", required_argument, NULL, 'r'}, /* return 'r' */
{"policy", required_argument, NULL, 'p'}, /* return 'p' */
{"ah", required_argument, NULL, 'a'}, /* return 'a' */
{"esp", required_argument, NULL, 'e'}, /* return 'e' */
{"tunnel", required_argument, NULL, 't'}, /* return 't' */
{"stream", required_argument, NULL, 's'}, /* return 's' */
{"help", no_argument, NULL, 'h'}, /* return 'h' */
{NULL, 0, NULL, 0}
};
static const char *shortopts = "+c:i:m:r:p:a:e:t:s:lh";
appl_args->cpu_count = 1; /* use one worker by default */
printf("\nParsing command line options\n");
while (!rc) {
opt = getopt_long(argc, argv, shortopts, longopts, &long_index);
if (-1 == opt)
break; /* No more options */
switch (opt) {
case 'c':
appl_args->cpu_count = atoi(optarg);
break;
/* parse packet-io interface names */
case 'i':
len = strlen(optarg);
if (0 == len) {
usage(argv[0]);
exit(EXIT_FAILURE);
}
len += 1; /* add room for '\0' */
appl_args->if_str = malloc(len);
if (appl_args->if_str == NULL) {
usage(argv[0]);
exit(EXIT_FAILURE);
}
/* count the number of tokens separated by ',' */
strcpy(appl_args->if_str, optarg);
for (token = strtok(appl_args->if_str, ","), i = 0;
token != NULL;
token = strtok(NULL, ","), i++)
;
appl_args->if_count = i;
if (0 == appl_args->if_count) {
usage(argv[0]);
exit(EXIT_FAILURE);
}
/* allocate storage for the if names */
appl_args->if_names =
calloc(appl_args->if_count, sizeof(char *));
/* store the if names (reset names string) */
strcpy(appl_args->if_str, optarg);
for (token = strtok(appl_args->if_str, ","), i = 0;
token != NULL; token = strtok(NULL, ","), i++) {
appl_args->if_names[i] = token;
}
break;
case 'l':
appl_args->lookup = true;
break;
case 'm':
appl_args->mode = atoi(optarg);
break;
case 'r':
rc = create_fwd_db_entry(optarg, appl_args->if_names,
appl_args->if_count);
break;
case 'p':
rc = create_sp_db_entry(optarg, FALSE);
break;
case 'a':
rc = create_sa_db_entry(optarg, FALSE);
break;
case 'e':
rc = create_sa_db_entry(optarg, TRUE);
break;
case 't':
rc = create_tun_db_entry(optarg);
break;
case 's':
rc = create_stream_db_entry(optarg);
break;
case 'h':
usage(argv[0]);
exit(EXIT_SUCCESS);
break;
default:
break;
}
}
if (rc) {
printf("ERROR: failed parsing -%c option\n", opt);
usage(argv[0]);
exit(EXIT_FAILURE);
}
if (0 == appl_args->if_count) {
usage(argv[0]);
exit(EXIT_FAILURE);
}
optind = 1; /* reset 'extern optind' from the getopt lib */
}
static void print_info(char *progname, appl_args_t *appl_args)
{
int i;
printf("Running ODP appl: \"%s\"\n"
"-----------------\n"
"IF-count: %i\n"
"Using IFs: ",
progname, appl_args->if_count);
for (i = 0; i < appl_args->if_count; ++i)
printf(" %s", appl_args->if_names[i]);
printf("\n");
dump_fwd_db();
dump_sp_db();
dump_sa_db();
dump_tun_db();
printf("\n\n");
fflush(NULL);
}
static void usage(char *progname)
{
printf("\n"
"Usage: %s OPTIONS\n"
" E.g. %s -i eth1,eth2,eth3 -m 0\n"
"\n"
"OpenDataPlane example application.\n"
"\n"
"Mandatory OPTIONS:\n"
" -i, --interface Eth interfaces (comma-separated, no spaces)\n"
" -m, --mode 0: SYNC\n"
" 1: ASYNC\n"
" Default: 1: ASYNC api mode\n"
"\n"
"Routing / IPSec OPTIONS:\n"
" -r, --route SubNet,Intf,NextHopMAC\n"
" -p, --policy SrcSubNet,DstSubNet,(in|out),(ah|esp)\n"
" -e, --esp SrcIP,DstIP,(3des|null),SPI,Key192\n"
" -a, --ah SrcIP,DstIP,(sha256|sha1|md5|null),SPI,Key(256|160|128)\n"
"\n"
" Where: NextHopMAC is raw hex/colon notation, i.e. 03:BA:44:9A:CE:02\n"
" IP is decimal/dot notation, i.e. 192.168.1.1\n"
" SubNet is decimal/dot/slash notation, i.e 192.168.0.0/16\n"
" SPI is raw hex, 32 bits\n"
" KeyXXX is raw hex, XXX bits long\n"
"\n"
" Examples:\n"
" -r 192.168.222.0/24,p8p1,08:00:27:F5:8B:DB\n"
" -p 192.168.111.0/24,192.168.222.0/24,out,esp\n"
" -e 192.168.111.2,192.168.222.2,3des,201,656c8523255ccc23a66c1917aa0cf30991fce83532a4b224\n"
" -a 192.168.111.2,192.168.222.2,md5,201,a731649644c5dee92cbd9c2e7e188ee6\n"
"\n"
"Optional OPTIONS\n"
" -c, --count <number> CPU count, 0=all available, default=1\n"
" -s, --stream SrcIP,DstIP,InIntf,OutIntf,Count,Length\n"
" -h, --help Display help and exit.\n"
" environment variables: ODP_IPSEC_USE_POLL_QUEUES\n"
" to enable use of poll queues instead of scheduled (default)\n"
" ODP_IPSEC_STREAM_VERIFY_MDEQ\n"
" to enable use of multiple dequeue for queue draining during\n"
" stream verification instead of single dequeue (default)\n"
"\n", NO_PATH(progname), NO_PATH(progname)
);
}
odp_bool_t sa_config_supported(const sa_db_entry_t *sa_entry, int *sa_flags);
odp_bool_t sa_config_supported(const sa_db_entry_t *sa_entry ODP_UNUSED, int *sa_flags ODP_UNUSED)
{
return true;
}
void odp_atomic_init_u32(odp_atomic_u32_t *atom, uint32_t val)
Initialize atomic uint32 variable.
uint32_t odp_atomic_load_u32(odp_atomic_u32_t *atom)
Load value of atomic uint32 variable.
void odp_atomic_store_u32(odp_atomic_u32_t *atom, uint32_t val)
Store value to atomic uint32 variable.
void odp_barrier_init(odp_barrier_t *barr, int count)
Initialize barrier with thread count.
void odp_barrier_wait(odp_barrier_t *barr)
Synchronize thread execution on barrier.
odp_buffer_t odp_buffer_alloc(odp_pool_t pool)
Buffer alloc.
void odp_buffer_free(odp_buffer_t buf)
Buffer free.
void * odp_buffer_addr(odp_buffer_t buf)
Buffer start address.
#define ODP_BUFFER_INVALID
Invalid buffer.
#define odp_unlikely(x)
Branch unlikely taken.
Definition: spec/hints.h:64
odp_u16be_t odp_cpu_to_be_16(uint16_t cpu16)
Convert cpu native uint16_t to 16bit big endian.
#define ODP_UNUSED
Intentionally unused variables of functions.
Definition: spec/hints.h:54
uint32_t odp_be_to_cpu_32(odp_u32be_t be32)
Convert 32bit big endian to cpu native uint32_t.
int odp_cpumask_default_worker(odp_cpumask_t *mask, int num)
Default CPU mask for worker threads.
int odp_cpumask_first(const odp_cpumask_t *mask)
Find first set CPU in mask.
int32_t odp_cpumask_to_str(const odp_cpumask_t *mask, char *str, int32_t size)
Format a string from CPU mask.
#define ODP_CPUMASK_STR_SIZE
The maximum number of characters needed to record any CPU mask as a string (output of odp_cpumask_to_...
void odp_event_free(odp_event_t event)
Free event.
odp_event_type_t odp_event_type(odp_event_t event)
Event type of an event.
_odp_abi_event_t * odp_event_t
ODP event.
odp_event_subtype_t
Event subtype.
odp_event_type_t odp_event_types(odp_event_t event, odp_event_subtype_t *subtype)
Event type and subtype of an event.
#define ODP_EVENT_INVALID
Invalid event.
void odp_init_param_init(odp_init_t *param)
Initialize the odp_init_t to default values for all fields.
int odp_init_local(odp_instance_t instance, odp_thread_type_t thr_type)
Thread local ODP initialization.
int odp_init_global(odp_instance_t *instance, const odp_init_t *params, const odp_platform_init_t *platform_params)
Global ODP initialization.
int odp_term_local(void)
Thread local ODP termination.
int odp_term_global(odp_instance_t instance)
Global ODP termination.
uint64_t odp_instance_t
ODP instance ID.
int odp_ipsec_in_enq(const odp_packet_t pkt[], int num, const odp_ipsec_in_param_t *param)
Inbound asynchronous IPSEC operation.
int odp_ipsec_in(const odp_packet_t pkt_in[], int num_in, odp_packet_t pkt_out[], int *num_out, const odp_ipsec_in_param_t *param)
Inbound synchronous IPSEC operation.
#define ODP_IPSEC_OK
IPSEC operation status has no errors.
int odp_ipsec_capability(odp_ipsec_capability_t *capa)
Query IPSEC capabilities.
int odp_ipsec_out(const odp_packet_t pkt_in[], int num_in, odp_packet_t pkt_out[], int *num_out, const odp_ipsec_out_param_t *param)
Outbound synchronous IPSEC operation.
uint64_t odp_ipsec_sa_to_u64(odp_ipsec_sa_t sa)
Printable format of odp_ipsec_sa_t.
odp_ipsec_op_mode_t
IPSEC operation mode.
void odp_ipsec_config_init(odp_ipsec_config_t *config)
Initialize IPSEC configuration options.
int odp_ipsec_config(const odp_ipsec_config_t *config)
Global IPSEC configuration.
int odp_ipsec_out_inline(const odp_packet_t pkt[], int num, const odp_ipsec_out_param_t *param, const odp_ipsec_out_inline_param_t *inline_param)
Outbound inline IPSEC operation.
int odp_ipsec_out_enq(const odp_packet_t pkt[], int num, const odp_ipsec_out_param_t *param)
Outbound asynchronous IPSEC operation.
int odp_ipsec_status(odp_ipsec_status_t *status, odp_event_t event)
Get IPSEC status information from an ODP_EVENT_IPSEC_STATUS event.
int odp_ipsec_result(odp_ipsec_packet_result_t *result, odp_packet_t packet)
Get IPSEC operation results from an IPSEC processed packet.
@ ODP_IPSEC_OP_MODE_INLINE
Inline IPSEC operation.
@ ODP_IPSEC_OP_MODE_SYNC
Synchronous IPSEC operation.
@ ODP_IPSEC_OP_MODE_ASYNC
Asynchronous IPSEC operation.
int odp_pktio_mac_addr(odp_pktio_t pktio, void *mac_addr, int size)
Get the default MAC address of a packet IO interface.
void odp_pktin_queue_param_init(odp_pktin_queue_param_t *param)
Initialize packet input queue parameters.
void odp_pktio_param_init(odp_pktio_param_t *param)
Initialize pktio params.
int odp_pktio_close(odp_pktio_t pktio)
Close a packet IO interface.
odp_pktio_t odp_pktio_lookup(const char *name)
Return a packet IO handle for an already open device.
int odp_pktout_queue(odp_pktio_t pktio, odp_pktout_queue_t queues[], int num)
Direct packet output queues.
void odp_pktio_config_init(odp_pktio_config_t *config)
Initialize packet IO configuration options.
int odp_pktin_event_queue(odp_pktio_t pktio, odp_queue_t queues[], int num)
Event queues for packet input.
odp_pktio_t odp_pktio_open(const char *name, odp_pool_t pool, const odp_pktio_param_t *param)
Open a packet IO interface.
int odp_pktio_config(odp_pktio_t pktio, const odp_pktio_config_t *config)
Configure packet IO interface options.
int odp_pktio_start(odp_pktio_t pktio)
Start packet receive and transmit.
#define ODP_PKTIO_INVALID
Invalid packet IO handle.
int odp_pktio_stop(odp_pktio_t pktio)
Stop packet receive and transmit.
int odp_pktio_capability(odp_pktio_t pktio, odp_pktio_capability_t *capa)
Query packet IO interface capabilities.
int odp_pktout_send(odp_pktout_queue_t queue, const odp_packet_t packets[], int num)
Send packets directly to an interface output queue.
uint64_t odp_pktio_to_u64(odp_pktio_t pktio)
Get printable value for an odp_pktio_t.
int odp_pktin_queue_config(odp_pktio_t pktio, const odp_pktin_queue_param_t *param)
Configure packet input queues.
int odp_pktout_queue_config(odp_pktio_t pktio, const odp_pktout_queue_param_t *param)
Configure packet output queues.
@ ODP_PKTIN_MODE_QUEUE
Packet input through plain event queues.
@ ODP_PKTIN_MODE_SCHED
Packet input through scheduler and scheduled event queues.
void * odp_packet_pull_head(odp_packet_t pkt, uint32_t len)
Pull in packet head.
void * odp_packet_user_ptr(odp_packet_t pkt)
User context pointer.
void * odp_packet_push_head(odp_packet_t pkt, uint32_t len)
Push out packet head.
int odp_packet_has_ipv4(odp_packet_t pkt)
Check for IPv4.
int odp_packet_has_eth(odp_packet_t pkt)
Check for Ethernet header.
int odp_packet_has_error(odp_packet_t pkt)
Check for all parse errors in packet.
int odp_packet_l2_offset_set(odp_packet_t pkt, uint32_t offset)
Set layer 2 start offset.
odp_packet_t odp_packet_from_event(odp_event_t ev)
Get packet handle from event.
void odp_packet_free(odp_packet_t pkt)
Free packet.
uint32_t odp_packet_l3_offset(odp_packet_t pkt)
Layer 3 start offset.
int odp_packet_copy_from_mem(odp_packet_t pkt, uint32_t offset, uint32_t len, const void *src)
Copy data from memory to packet.
void odp_packet_user_ptr_set(odp_packet_t pkt, const void *user_ptr)
Set user context pointer.
void * odp_packet_l3_ptr(odp_packet_t pkt, uint32_t *len)
Layer 3 start pointer.
@ ODP_PROTO_LAYER_ALL
All layers.
odp_pool_t odp_pool_create(const char *name, const odp_pool_param_t *param)
Create a pool.
void odp_pool_param_init(odp_pool_param_t *param)
Initialize pool params.
int odp_pool_destroy(odp_pool_t pool)
Destroy a pool previously created by odp_pool_create()
#define ODP_POOL_INVALID
Invalid pool.
@ ODP_POOL_BUFFER
Buffer pool.
@ ODP_POOL_PACKET
Packet pool.
_odp_abi_queue_t * odp_queue_t
ODP queue.
void odp_queue_param_init(odp_queue_param_t *param)
Initialize queue params.
#define ODP_QUEUE_INVALID
Invalid queue.
odp_event_t odp_queue_deq(odp_queue_t queue)
Dequeue an event from a queue.
odp_queue_type_t
Queue type.
odp_queue_t odp_queue_create(const char *name, const odp_queue_param_t *param)
Queue create.
int odp_queue_destroy(odp_queue_t queue)
Destroy ODP queue.
uint64_t odp_queue_to_u64(odp_queue_t hdl)
Get printable value for an odp_queue_t.
@ ODP_QUEUE_TYPE_SCHED
Scheduled queue.
@ ODP_QUEUE_TYPE_PLAIN
Plain queue.
#define ODP_SCHED_SYNC_ATOMIC
Atomic queue synchronization.
#define ODP_SCHED_NO_WAIT
Do not wait.
int odp_schedule_max_prio(void)
Maximum scheduling priority level.
int odp_schedule_config(const odp_schedule_config_t *config)
Global schedule configuration.
odp_event_t odp_schedule(odp_queue_t *from, uint64_t wait)
Schedule an event.
#define ODP_SCHED_GROUP_ALL
Group of all threads.
odp_shm_t odp_shm_lookup(const char *name)
Lookup for a block of shared memory.
int odp_shm_free(odp_shm_t shm)
Free a contiguous block of shared memory.
#define ODP_SHM_INVALID
Invalid shared memory block.
void * odp_shm_addr(odp_shm_t shm)
Shared memory block address.
odp_shm_t odp_shm_reserve(const char *name, uint64_t size, uint64_t align, uint32_t flags)
Reserve a contiguous block of shared memory.
bool odp_bool_t
Boolean type.
void odp_sys_info_print(void)
Print system info.
int odp_thread_id(void)
Get thread identifier.
@ ODP_THREAD_WORKER
Worker thread.
@ ODP_THREAD_CONTROL
Control thread.
The OpenDataPlane API.
Global initialization parameters.
odp_mem_model_t mem_model
Application memory model.
odp_bool_t queue_type_sched
Scheduled queue support.
odp_bool_t queue_type_plain
Plain queue support.
IPSEC configuration options.
odp_ipsec_op_mode_t outbound_mode
Outbound IPSEC operation mode.
odp_ipsec_inbound_config_t inbound
IPSEC inbound processing configuration.
odp_ipsec_op_mode_t inbound_mode
Inbound IPSEC operation mode.
uint32_t all
All error bits.
IPSEC inbound operation parameters.
const odp_ipsec_sa_t * sa
Pointer to an array of IPSEC SAs.
odp_queue_t default_queue
Default destination queue for IPSEC events.
odp_proto_layer_t parse_level
Parse packet headers after IPSEC transformation.
uint32_t inline_mode
Packet was processed in inline mode.
odp_ipsec_error_t error
IPSEC errors.
Outbound inline IPSEC operation parameters.
odp_pktio_t pktio
Packet output interface for inline outbound operation without TM.
uint32_t len
Outer header length in bytes.
const uint8_t * ptr
Points to first byte of outer headers to be copied in front of the outgoing IPSEC packet.
struct odp_ipsec_out_inline_param_t::@81 outer_hdr
Outer headers for inline output operation.
IPSEC outbound operation parameters.
int num_opt
Number of outbound operation options.
const odp_ipsec_sa_t * sa
Pointer to an array of IPSEC SAs.
const odp_ipsec_out_opt_t * opt
Pointer to an array of outbound operation options.
IPSEC operation result for a packet.
odp_ipsec_op_status_t status
IPSEC operation status.
odp_ipsec_op_flag_t flag
IPSEC operation flags.
IPSEC status content.
int result
Result of the operation.
odp_ipsec_sa_t sa
IPSEC SA that was target of the operation.
odp_ipsec_status_id_t id
IPSEC status ID.
Packet input queue parameters.
odp_queue_param_t queue_param
Queue parameters.
Packet IO capabilities.
odp_pktio_config_t config
Supported pktio configuration options.
Packet IO configuration options.
odp_bool_t outbound_ipsec
Outbound IPSEC inlined with packet output.
odp_bool_t inbound_ipsec
Inbound IPSEC inlined with packet input.
Packet IO parameters.
odp_pktin_mode_t in_mode
Packet input mode.
Pool parameters.
uint32_t num
Number of buffers in the pool.
struct odp_pool_param_t::@122 buf
Parameters for buffer pools.
uint32_t align
Minimum buffer alignment in bytes.
uint32_t size
Minimum buffer size in bytes.
odp_pool_type_t type
Pool type.
struct odp_pool_param_t::@123 pkt
Parameters for packet pools.
uint32_t len
Minimum length of 'num' packets.
uint32_t seg_len
Minimum number of packet data bytes that can be stored in the first segment of a newly allocated pack...
ODP Queue parameters.
odp_schedule_param_t sched
Scheduler parameters.
odp_queue_type_t type
Queue type.
odp_schedule_group_t group
Thread group.
odp_schedule_prio_t prio
Priority level.
odp_schedule_sync_t sync
Synchronization method.