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