rte_table_action.h

Go to the documentation of this file.

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

#ifndef __INCLUDE_RTE_TABLE_ACTION_H__
#define __INCLUDE_RTE_TABLE_ACTION_H__

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>

#include <rte_compat.h>
#include <rte_ether.h>
#include <rte_meter.h>
#include <rte_table_hash.h>

#include "rte_pipeline.h"

enum rte_table_action_type {
    RTE_TABLE_ACTION_FWD = 0,

    RTE_TABLE_ACTION_LB,

    RTE_TABLE_ACTION_MTR,

    RTE_TABLE_ACTION_TM,

    RTE_TABLE_ACTION_ENCAP,

    RTE_TABLE_ACTION_NAT,

    RTE_TABLE_ACTION_TTL,

    RTE_TABLE_ACTION_STATS,

    RTE_TABLE_ACTION_TIME,

    RTE_TABLE_ACTION_SYM_CRYPTO,

    RTE_TABLE_ACTION_TAG,

    RTE_TABLE_ACTION_DECAP,
};

struct rte_table_action_common_config {
    int ip_version;

    uint32_t ip_offset;
};

struct rte_table_action_fwd_params {
    enum rte_pipeline_action action;

    uint32_t id;
};

#define RTE_TABLE_ACTION_LB_KEY_SIZE_MIN                    8

#define RTE_TABLE_ACTION_LB_KEY_SIZE_MAX                    64

#define RTE_TABLE_ACTION_LB_TABLE_SIZE                      8

struct rte_table_action_lb_config {
    uint32_t key_size;

    uint32_t key_offset;

    uint8_t key_mask[RTE_TABLE_ACTION_LB_KEY_SIZE_MAX];

    rte_table_hash_op_hash f_hash;

    uint64_t seed;

    uint32_t out_offset;
};

struct rte_table_action_lb_params {
    uint32_t out[RTE_TABLE_ACTION_LB_TABLE_SIZE];
};

#define RTE_TABLE_ACTION_TC_MAX                                  16

#define RTE_TABLE_ACTION_TC_QUEUE_MAX                            16

struct rte_table_action_dscp_table_entry {
    uint32_t tc_id;

    uint32_t tc_queue_id;

    enum rte_color color;
};

struct rte_table_action_dscp_table {
    struct rte_table_action_dscp_table_entry entry[64];
};

enum rte_table_action_meter_algorithm {
    RTE_TABLE_ACTION_METER_SRTCM,

    RTE_TABLE_ACTION_METER_TRTCM,
};

struct rte_table_action_meter_profile {
    enum rte_table_action_meter_algorithm alg;

    union {
        struct rte_meter_srtcm_params srtcm;

        struct rte_meter_trtcm_params trtcm;
    };
};

enum rte_table_action_policer {
    RTE_TABLE_ACTION_POLICER_COLOR_GREEN = 0,

    RTE_TABLE_ACTION_POLICER_COLOR_YELLOW,

    RTE_TABLE_ACTION_POLICER_COLOR_RED,

    RTE_TABLE_ACTION_POLICER_DROP,

    RTE_TABLE_ACTION_POLICER_MAX
};

struct rte_table_action_mtr_tc_params {
    uint32_t meter_profile_id;

    enum rte_table_action_policer policer[RTE_COLORS];
};

struct rte_table_action_mtr_counters_tc {
    uint64_t n_packets[RTE_COLORS];

    uint64_t n_bytes[RTE_COLORS];

    int n_packets_valid;

    int n_bytes_valid;
};

struct rte_table_action_mtr_config {
    enum rte_table_action_meter_algorithm alg;

    uint32_t n_tc;

    int n_packets_enabled;

    int n_bytes_enabled;
};

struct rte_table_action_mtr_params {
    struct rte_table_action_mtr_tc_params mtr[RTE_TABLE_ACTION_TC_MAX];

    uint32_t tc_mask;
};

struct rte_table_action_mtr_counters {
    struct rte_table_action_mtr_counters_tc stats[RTE_TABLE_ACTION_TC_MAX];

    uint32_t tc_mask;
};

struct rte_table_action_tm_config {
    uint32_t n_subports_per_port;

    uint32_t n_pipes_per_subport;
};

struct rte_table_action_tm_params {
    uint32_t subport_id;

    uint32_t pipe_id;
};

enum rte_table_action_encap_type {
    RTE_TABLE_ACTION_ENCAP_ETHER = 0,

    RTE_TABLE_ACTION_ENCAP_VLAN,

    RTE_TABLE_ACTION_ENCAP_QINQ,

    RTE_TABLE_ACTION_ENCAP_MPLS,

    RTE_TABLE_ACTION_ENCAP_PPPOE,

    RTE_TABLE_ACTION_ENCAP_VXLAN,

    RTE_TABLE_ACTION_ENCAP_QINQ_PPPOE,
};

struct rte_table_action_ether_hdr {
    struct rte_ether_addr da; 
    struct rte_ether_addr sa; 
};

struct rte_table_action_vlan_hdr {
    uint8_t pcp; 
    uint8_t dei; 
    uint16_t vid; 
};

struct rte_table_action_mpls_hdr {
    uint32_t label; 
    uint8_t tc; 
    uint8_t ttl; 
};

struct rte_table_action_pppoe_hdr {
    uint16_t session_id; 
};

struct rte_table_action_ipv4_header {
    uint32_t sa; 
    uint32_t da; 
    uint8_t dscp; 
    uint8_t ttl; 
};

struct rte_table_action_ipv6_header {
    uint8_t sa[16]; 
    uint8_t da[16]; 
    uint32_t flow_label; 
    uint8_t dscp; 
    uint8_t hop_limit; 
};

struct rte_table_action_udp_header {
    uint16_t sp; 
    uint16_t dp; 
};

struct rte_table_action_vxlan_hdr {
    uint32_t vni; 
};

struct rte_table_action_encap_ether_params {
    struct rte_table_action_ether_hdr ether; 
};

struct rte_table_action_encap_vlan_params {
    struct rte_table_action_ether_hdr ether; 
    struct rte_table_action_vlan_hdr vlan; 
};

struct rte_table_action_encap_qinq_params {
    struct rte_table_action_ether_hdr ether; 
    struct rte_table_action_vlan_hdr svlan; 
    struct rte_table_action_vlan_hdr cvlan; 
};

#ifndef RTE_TABLE_ACTION_MPLS_LABELS_MAX
#define RTE_TABLE_ACTION_MPLS_LABELS_MAX                   4
#endif

struct rte_table_action_encap_mpls_params {
    struct rte_table_action_ether_hdr ether;

    struct rte_table_action_mpls_hdr mpls[RTE_TABLE_ACTION_MPLS_LABELS_MAX];

    uint32_t mpls_count;

    int unicast;
};

struct rte_table_action_encap_pppoe_params {
    struct rte_table_action_ether_hdr ether; 
    struct rte_table_action_pppoe_hdr pppoe; 
};

struct rte_table_action_encap_vxlan_params {
    struct rte_table_action_ether_hdr ether; 
    struct rte_table_action_vlan_hdr vlan; 
    union {
        struct rte_table_action_ipv4_header ipv4; 
        struct rte_table_action_ipv6_header ipv6; 
    };

    struct rte_table_action_udp_header udp; 
    struct rte_table_action_vxlan_hdr vxlan; 
};

struct rte_table_action_encap_config {
    uint64_t encap_mask;

    union {
        struct {
            uint32_t data_offset;

            int vlan;

            int ip_version;
        } vxlan; 
    };
};

struct rte_table_encap_ether_qinq_pppoe {

    struct rte_table_action_ether_hdr ether;
    struct rte_table_action_vlan_hdr svlan; 
    struct rte_table_action_vlan_hdr cvlan; 
    struct rte_table_action_pppoe_hdr pppoe; 
};

struct rte_table_action_encap_params {
    enum rte_table_action_encap_type type;

    union {
        struct rte_table_action_encap_ether_params ether;

        struct rte_table_action_encap_vlan_params vlan;

        struct rte_table_action_encap_qinq_params qinq;

        struct rte_table_action_encap_mpls_params mpls;

        struct rte_table_action_encap_pppoe_params pppoe;

        struct rte_table_action_encap_vxlan_params vxlan;

        struct rte_table_encap_ether_qinq_pppoe qinq_pppoe;
    };
};

struct rte_table_action_nat_config {
    int source_nat;

    uint8_t proto;
};

struct rte_table_action_nat_params {
    int ip_version;

    union {
        uint32_t ipv4;

        uint8_t ipv6[16];
    } addr;

    uint16_t port;
};

struct rte_table_action_ttl_config {
    int drop;

    int n_packets_enabled;
};

struct rte_table_action_ttl_params {
    int decrement;
};

struct rte_table_action_ttl_counters {
    uint64_t n_packets;
};

struct rte_table_action_stats_config {
    int n_packets_enabled;

    int n_bytes_enabled;
};

struct rte_table_action_stats_params {
    uint64_t n_packets;

    uint64_t n_bytes;
};

struct rte_table_action_stats_counters {
    uint64_t n_packets;

    uint64_t n_bytes;

    int n_packets_valid;

    int n_bytes_valid;
};

struct rte_table_action_time_params {
    uint64_t time;
};

#ifndef RTE_TABLE_ACTION_SYM_CRYPTO_IV_SIZE_MAX
#define RTE_TABLE_ACTION_SYM_CRYPTO_IV_SIZE_MAX     (16)
#endif

#ifndef RTE_TABLE_ACTION_SYM_CRYPTO_AAD_SIZE_MAX
#define RTE_TABLE_ACTION_SYM_CRYPTO_AAD_SIZE_MAX    (16)
#endif

#ifndef RTE_TABLE_ACTION_SYM_CRYPTO_IV_OFFSET
#define RTE_TABLE_ACTION_SYM_CRYPTO_IV_OFFSET               \
    (sizeof(struct rte_crypto_op) + sizeof(struct rte_crypto_sym_op))
#endif

struct rte_table_action_vlo {
    uint8_t *val;
    uint32_t length;
    uint32_t offset;
};

struct rte_table_action_sym_crypto_config {
    uint8_t cryptodev_id;

    uint32_t op_offset;

    struct rte_mempool *mp_create;

    struct rte_mempool *mp_init;
};

struct rte_table_action_sym_crypto_params {

    struct rte_crypto_sym_xform *xform;

    uint32_t data_offset;

    union {
        struct {
            struct rte_table_action_vlo cipher_iv;

            struct rte_table_action_vlo cipher_iv_update;

            struct rte_table_action_vlo auth_iv;

            struct rte_table_action_vlo auth_iv_update;

        } cipher_auth;

        struct {
            struct rte_table_action_vlo aad;

            struct rte_table_action_vlo iv;

            struct rte_table_action_vlo aad_update;

            struct rte_table_action_vlo iv_update;

        } aead;
    };
};

struct rte_table_action_tag_params {
    uint32_t tag;
};

struct rte_table_action_decap_params {
    uint16_t n;
};

struct rte_table_action_profile;

__rte_experimental
struct rte_table_action_profile *
rte_table_action_profile_create(struct rte_table_action_common_config *common);

__rte_experimental
int
rte_table_action_profile_free(struct rte_table_action_profile *profile);

__rte_experimental
int
rte_table_action_profile_action_register(struct rte_table_action_profile *profile,
    enum rte_table_action_type type,
    void *action_config);

__rte_experimental
int
rte_table_action_profile_freeze(struct rte_table_action_profile *profile);

struct rte_table_action;

__rte_experimental
struct rte_table_action *
rte_table_action_create(struct rte_table_action_profile *profile,
    uint32_t socket_id);

__rte_experimental
int
rte_table_action_free(struct rte_table_action *action);

__rte_experimental
int
rte_table_action_table_params_get(struct rte_table_action *action,
    struct rte_pipeline_table_params *params);

__rte_experimental
int
rte_table_action_apply(struct rte_table_action *action,
    void *data,
    enum rte_table_action_type type,
    void *action_params);

__rte_experimental
int
rte_table_action_dscp_table_update(struct rte_table_action *action,
    uint64_t dscp_mask,
    struct rte_table_action_dscp_table *table);

__rte_experimental
int
rte_table_action_meter_profile_add(struct rte_table_action *action,
    uint32_t meter_profile_id,
    struct rte_table_action_meter_profile *profile);

__rte_experimental
int
rte_table_action_meter_profile_delete(struct rte_table_action *action,
    uint32_t meter_profile_id);

__rte_experimental
int
rte_table_action_meter_read(struct rte_table_action *action,
    void *data,
    uint32_t tc_mask,
    struct rte_table_action_mtr_counters *stats,
    int clear);

__rte_experimental
int
rte_table_action_ttl_read(struct rte_table_action *action,
    void *data,
    struct rte_table_action_ttl_counters *stats,
    int clear);

__rte_experimental
int
rte_table_action_stats_read(struct rte_table_action *action,
    void *data,
    struct rte_table_action_stats_counters *stats,
    int clear);

__rte_experimental
int
rte_table_action_time_read(struct rte_table_action *action,
    void *data,
    uint64_t *timestamp);

__rte_experimental
struct rte_cryptodev_sym_session *
rte_table_action_crypto_sym_session_get(struct rte_table_action *action,
    void *data);

#ifdef __cplusplus
}
#endif

#endif /* __INCLUDE_RTE_TABLE_ACTION_H__ */