rte_pipeline.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2010-2016 Intel Corporation
 */

#ifndef __INCLUDE_RTE_PIPELINE_H__
#define __INCLUDE_RTE_PIPELINE_H__

#include <stdint.h>

#include <rte_port.h>
#include <rte_table.h>
#include <rte_common.h>

#ifdef __cplusplus
extern "C" {
#endif

struct rte_mbuf;

/*
 * Pipeline
 */
struct rte_pipeline;

struct rte_pipeline_params {
    const char *name;

    int socket_id;

    uint32_t offset_port_id;
};

struct rte_pipeline_port_in_stats {
    struct rte_port_in_stats stats;

    uint64_t n_pkts_dropped_by_ah;

};

struct rte_pipeline_port_out_stats {
    struct rte_port_out_stats stats;

    uint64_t n_pkts_dropped_by_ah;
};

struct rte_pipeline_table_stats {
    struct rte_table_stats stats;

    uint64_t n_pkts_dropped_by_lkp_hit_ah;

    uint64_t n_pkts_dropped_by_lkp_miss_ah;

    uint64_t n_pkts_dropped_lkp_hit;

    uint64_t n_pkts_dropped_lkp_miss;
};

struct rte_pipeline *rte_pipeline_create(struct rte_pipeline_params *params);

int rte_pipeline_free(struct rte_pipeline *p);

int rte_pipeline_check(struct rte_pipeline *p);

int rte_pipeline_run(struct rte_pipeline *p);

int rte_pipeline_flush(struct rte_pipeline *p);

/*
 * Actions
 */
enum rte_pipeline_action {
    RTE_PIPELINE_ACTION_DROP = 0,

    RTE_PIPELINE_ACTION_PORT,

    RTE_PIPELINE_ACTION_PORT_META,

    RTE_PIPELINE_ACTION_TABLE,

    RTE_PIPELINE_ACTIONS
};

/*
 * Table
 */
#define RTE_PIPELINE_TABLE_MAX                                     64

struct rte_pipeline_table_entry {
    enum rte_pipeline_action action;

    union {
        uint32_t port_id;
        uint32_t table_id;
    };
    uint8_t action_data[];
};

typedef int (*rte_pipeline_table_action_handler_hit)(
    struct rte_pipeline *p,
    struct rte_mbuf **pkts,
    uint64_t pkts_mask,
    struct rte_pipeline_table_entry **entries,
    void *arg);

typedef int (*rte_pipeline_table_action_handler_miss)(
    struct rte_pipeline *p,
    struct rte_mbuf **pkts,
    uint64_t pkts_mask,
    struct rte_pipeline_table_entry *entry,
    void *arg);

struct rte_pipeline_table_params {
    struct rte_table_ops *ops;
    void *arg_create;
    rte_pipeline_table_action_handler_hit f_action_hit;
    rte_pipeline_table_action_handler_miss f_action_miss;

    void *arg_ah;
    uint32_t action_data_size;
};

int rte_pipeline_table_create(struct rte_pipeline *p,
    struct rte_pipeline_table_params *params,
    uint32_t *table_id);

int rte_pipeline_table_default_entry_add(struct rte_pipeline *p,
    uint32_t table_id,
    struct rte_pipeline_table_entry *default_entry,
    struct rte_pipeline_table_entry **default_entry_ptr);

int rte_pipeline_table_default_entry_delete(struct rte_pipeline *p,
    uint32_t table_id,
    struct rte_pipeline_table_entry *entry);

int rte_pipeline_table_entry_add(struct rte_pipeline *p,
    uint32_t table_id,
    void *key,
    struct rte_pipeline_table_entry *entry,
    int *key_found,
    struct rte_pipeline_table_entry **entry_ptr);

int rte_pipeline_table_entry_delete(struct rte_pipeline *p,
    uint32_t table_id,
    void *key,
    int *key_found,
    struct rte_pipeline_table_entry *entry);

int rte_pipeline_table_entry_add_bulk(struct rte_pipeline *p,
    uint32_t table_id,
    void **keys,
    struct rte_pipeline_table_entry **entries,
    uint32_t n_keys,
    int *key_found,
    struct rte_pipeline_table_entry **entries_ptr);

int rte_pipeline_table_entry_delete_bulk(struct rte_pipeline *p,
    uint32_t table_id,
    void **keys,
    uint32_t n_keys,
    int *key_found,
    struct rte_pipeline_table_entry **entries);

int rte_pipeline_table_stats_read(struct rte_pipeline *p, uint32_t table_id,
    struct rte_pipeline_table_stats *stats, int clear);

/*
 * Port IN
 */
#define RTE_PIPELINE_PORT_IN_MAX                                    64

typedef int (*rte_pipeline_port_in_action_handler)(
    struct rte_pipeline *p,
    struct rte_mbuf **pkts,
    uint32_t n,
    void *arg);

struct rte_pipeline_port_in_params {
    struct rte_port_in_ops *ops;
    void *arg_create;

    rte_pipeline_port_in_action_handler f_action;
    void *arg_ah;

    uint32_t burst_size;
};

int rte_pipeline_port_in_create(struct rte_pipeline *p,
    struct rte_pipeline_port_in_params *params,
    uint32_t *port_id);

int rte_pipeline_port_in_connect_to_table(struct rte_pipeline *p,
    uint32_t port_id,
    uint32_t table_id);

int rte_pipeline_port_in_enable(struct rte_pipeline *p,
    uint32_t port_id);

int rte_pipeline_port_in_disable(struct rte_pipeline *p,
    uint32_t port_id);

int rte_pipeline_port_in_stats_read(struct rte_pipeline *p, uint32_t port_id,
    struct rte_pipeline_port_in_stats *stats, int clear);

/*
 * Port OUT
 */
#define RTE_PIPELINE_PORT_OUT_MAX                                   64

typedef int (*rte_pipeline_port_out_action_handler)(
    struct rte_pipeline *p,
    struct rte_mbuf **pkts,
    uint64_t pkts_mask,
    void *arg);

struct rte_pipeline_port_out_params {
    struct rte_port_out_ops *ops;
    void *arg_create;

    rte_pipeline_port_out_action_handler f_action;
    void *arg_ah;
};

int rte_pipeline_port_out_create(struct rte_pipeline *p,
    struct rte_pipeline_port_out_params *params,
    uint32_t *port_id);

int rte_pipeline_port_out_stats_read(struct rte_pipeline *p, uint32_t port_id,
    struct rte_pipeline_port_out_stats *stats, int clear);

/*
 * Functions to be called as part of the port IN/OUT or table action handlers
 */
int rte_pipeline_port_out_packet_insert(struct rte_pipeline *p,
    uint32_t port_id,
    struct rte_mbuf *pkt);

#define rte_pipeline_ah_port_out_packet_insert \
    rte_pipeline_port_out_packet_insert

int rte_pipeline_ah_packet_hijack(struct rte_pipeline *p,
    uint64_t pkts_mask);

int rte_pipeline_ah_packet_drop(struct rte_pipeline *p,
    uint64_t pkts_mask);

#ifdef __cplusplus
}
#endif

#endif