rte_flow.h

Go to the documentation of this file.

/*-
 *   BSD LICENSE
 *
 *   Copyright 2016 6WIND S.A.
 *   Copyright 2016 Mellanox.
 *
 *   Redistribution and use in source and binary forms, with or without
 *   modification, are permitted provided that the following conditions
 *   are met:
 *
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in
 *       the documentation and/or other materials provided with the
 *       distribution.
 *     * Neither the name of 6WIND S.A. nor the names of its
 *       contributors may be used to endorse or promote products derived
 *       from this software without specific prior written permission.
 *
 *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef RTE_FLOW_H_
#define RTE_FLOW_H_

#include <rte_arp.h>
#include <rte_ether.h>
#include <rte_icmp.h>
#include <rte_ip.h>
#include <rte_sctp.h>
#include <rte_tcp.h>
#include <rte_udp.h>
#include <rte_byteorder.h>
#include <rte_esp.h>

#ifdef __cplusplus
extern "C" {
#endif

struct rte_flow_attr {
    uint32_t group; 
    uint32_t priority; 
    uint32_t ingress:1; 
    uint32_t egress:1; 
    uint32_t reserved:30; 
};

enum rte_flow_item_type {
    RTE_FLOW_ITEM_TYPE_END,

    RTE_FLOW_ITEM_TYPE_VOID,

    RTE_FLOW_ITEM_TYPE_INVERT,

    RTE_FLOW_ITEM_TYPE_ANY,

    RTE_FLOW_ITEM_TYPE_PF,

    RTE_FLOW_ITEM_TYPE_VF,

    RTE_FLOW_ITEM_TYPE_PORT,

    RTE_FLOW_ITEM_TYPE_RAW,

    RTE_FLOW_ITEM_TYPE_ETH,

    RTE_FLOW_ITEM_TYPE_VLAN,

    RTE_FLOW_ITEM_TYPE_IPV4,

    RTE_FLOW_ITEM_TYPE_IPV6,

    RTE_FLOW_ITEM_TYPE_ICMP,

    RTE_FLOW_ITEM_TYPE_UDP,

    RTE_FLOW_ITEM_TYPE_TCP,

    RTE_FLOW_ITEM_TYPE_SCTP,

    RTE_FLOW_ITEM_TYPE_VXLAN,

    RTE_FLOW_ITEM_TYPE_E_TAG,

    RTE_FLOW_ITEM_TYPE_NVGRE,

    RTE_FLOW_ITEM_TYPE_MPLS,

    RTE_FLOW_ITEM_TYPE_GRE,

    RTE_FLOW_ITEM_TYPE_FUZZY,

    RTE_FLOW_ITEM_TYPE_GTP,

    RTE_FLOW_ITEM_TYPE_GTPC,

    RTE_FLOW_ITEM_TYPE_GTPU,

    RTE_FLOW_ITEM_TYPE_ESP,
};

struct rte_flow_item_any {
    uint32_t num; 
};

#ifndef __cplusplus
static const struct rte_flow_item_any rte_flow_item_any_mask = {
    .num = 0x00000000,
};
#endif

struct rte_flow_item_vf {
    uint32_t id; 
};

#ifndef __cplusplus
static const struct rte_flow_item_vf rte_flow_item_vf_mask = {
    .id = 0x00000000,
};
#endif

struct rte_flow_item_port {
    uint32_t index; 
};

#ifndef __cplusplus
static const struct rte_flow_item_port rte_flow_item_port_mask = {
    .index = 0x00000000,
};
#endif

struct rte_flow_item_raw {
    uint32_t relative:1; 
    uint32_t search:1; 
    uint32_t reserved:30; 
    int32_t offset; 
    uint16_t limit; 
    uint16_t length; 
    uint8_t pattern[]; 
};

#ifndef __cplusplus
static const struct rte_flow_item_raw rte_flow_item_raw_mask = {
    .relative = 1,
    .search = 1,
    .reserved = 0x3fffffff,
    .offset = 0xffffffff,
    .limit = 0xffff,
    .length = 0xffff,
};
#endif

struct rte_flow_item_eth {
    struct ether_addr dst; 
    struct ether_addr src; 
    rte_be16_t type; 
};

#ifndef __cplusplus
static const struct rte_flow_item_eth rte_flow_item_eth_mask = {
    .dst.addr_bytes = "\xff\xff\xff\xff\xff\xff",
    .src.addr_bytes = "\xff\xff\xff\xff\xff\xff",
    .type = RTE_BE16(0x0000),
};
#endif

struct rte_flow_item_vlan {
    rte_be16_t tpid; 
    rte_be16_t tci; 
};

#ifndef __cplusplus
static const struct rte_flow_item_vlan rte_flow_item_vlan_mask = {
    .tpid = RTE_BE16(0x0000),
    .tci = RTE_BE16(0xffff),
};
#endif

struct rte_flow_item_ipv4 {
    struct ipv4_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_ipv4 rte_flow_item_ipv4_mask = {
    .hdr = {
        .src_addr = RTE_BE32(0xffffffff),
        .dst_addr = RTE_BE32(0xffffffff),
    },
};
#endif

struct rte_flow_item_ipv6 {
    struct ipv6_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_ipv6 rte_flow_item_ipv6_mask = {
    .hdr = {
        .src_addr =
            "\xff\xff\xff\xff\xff\xff\xff\xff"
            "\xff\xff\xff\xff\xff\xff\xff\xff",
        .dst_addr =
            "\xff\xff\xff\xff\xff\xff\xff\xff"
            "\xff\xff\xff\xff\xff\xff\xff\xff",
    },
};
#endif

struct rte_flow_item_icmp {
    struct icmp_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_icmp rte_flow_item_icmp_mask = {
    .hdr = {
        .icmp_type = 0xff,
        .icmp_code = 0xff,
    },
};
#endif

struct rte_flow_item_udp {
    struct udp_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_udp rte_flow_item_udp_mask = {
    .hdr = {
        .src_port = RTE_BE16(0xffff),
        .dst_port = RTE_BE16(0xffff),
    },
};
#endif

struct rte_flow_item_tcp {
    struct tcp_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_tcp rte_flow_item_tcp_mask = {
    .hdr = {
        .src_port = RTE_BE16(0xffff),
        .dst_port = RTE_BE16(0xffff),
    },
};
#endif

struct rte_flow_item_sctp {
    struct sctp_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_sctp rte_flow_item_sctp_mask = {
    .hdr = {
        .src_port = RTE_BE16(0xffff),
        .dst_port = RTE_BE16(0xffff),
    },
};
#endif

struct rte_flow_item_vxlan {
    uint8_t flags; 
    uint8_t rsvd0[3]; 
    uint8_t vni[3]; 
    uint8_t rsvd1; 
};

#ifndef __cplusplus
static const struct rte_flow_item_vxlan rte_flow_item_vxlan_mask = {
    .vni = "\xff\xff\xff",
};
#endif

struct rte_flow_item_e_tag {
    rte_be16_t tpid; 
    rte_be16_t epcp_edei_in_ecid_b;
    rte_be16_t rsvd_grp_ecid_b;
    uint8_t in_ecid_e; 
    uint8_t ecid_e; 
};

#ifndef __cplusplus
static const struct rte_flow_item_e_tag rte_flow_item_e_tag_mask = {
    .rsvd_grp_ecid_b = RTE_BE16(0x3fff),
};
#endif

struct rte_flow_item_nvgre {
    rte_be16_t c_k_s_rsvd0_ver;
    rte_be16_t protocol; 
    uint8_t tni[3]; 
    uint8_t flow_id; 
};

#ifndef __cplusplus
static const struct rte_flow_item_nvgre rte_flow_item_nvgre_mask = {
    .tni = "\xff\xff\xff",
};
#endif

struct rte_flow_item_mpls {
    uint8_t label_tc_s[3];
    uint8_t ttl; 
};

#ifndef __cplusplus
static const struct rte_flow_item_mpls rte_flow_item_mpls_mask = {
    .label_tc_s = "\xff\xff\xf0",
};
#endif

struct rte_flow_item_gre {
    rte_be16_t c_rsvd0_ver;
    rte_be16_t protocol; 
};

#ifndef __cplusplus
static const struct rte_flow_item_gre rte_flow_item_gre_mask = {
    .protocol = RTE_BE16(0xffff),
};
#endif

struct rte_flow_item_fuzzy {
    uint32_t thresh; 
};

#ifndef __cplusplus
static const struct rte_flow_item_fuzzy rte_flow_item_fuzzy_mask = {
    .thresh = 0xffffffff,
};
#endif

struct rte_flow_item_gtp {
    uint8_t v_pt_rsv_flags;
    uint8_t msg_type; 
    rte_be16_t msg_len; 
    rte_be32_t teid; 
};

#ifndef __cplusplus
static const struct rte_flow_item_gtp rte_flow_item_gtp_mask = {
    .teid = RTE_BE32(0xffffffff),
};
#endif

struct rte_flow_item_esp {
    struct esp_hdr hdr; 
};

#ifndef __cplusplus
static const struct rte_flow_item_esp rte_flow_item_esp_mask = {
    .hdr = {
        .spi = RTE_BE32(0xffffffff),
    },
};
#endif

struct rte_flow_item {
    enum rte_flow_item_type type; 
    const void *spec; 
    const void *last; 
    const void *mask; 
};

enum rte_flow_action_type {
    RTE_FLOW_ACTION_TYPE_END,

    RTE_FLOW_ACTION_TYPE_VOID,

    RTE_FLOW_ACTION_TYPE_PASSTHRU,

    RTE_FLOW_ACTION_TYPE_MARK,

    RTE_FLOW_ACTION_TYPE_FLAG,

    RTE_FLOW_ACTION_TYPE_QUEUE,

    RTE_FLOW_ACTION_TYPE_DROP,

    RTE_FLOW_ACTION_TYPE_COUNT,

    RTE_FLOW_ACTION_TYPE_DUP,

    RTE_FLOW_ACTION_TYPE_RSS,

    RTE_FLOW_ACTION_TYPE_PF,

    RTE_FLOW_ACTION_TYPE_VF,

    RTE_FLOW_ACTION_TYPE_METER,

    RTE_FLOW_ACTION_TYPE_SECURITY
};

struct rte_flow_action_mark {
    uint32_t id; 
};

struct rte_flow_action_queue {
    uint16_t index; 
};

struct rte_flow_query_count {
    uint32_t reset:1; 
    uint32_t hits_set:1; 
    uint32_t bytes_set:1; 
    uint32_t reserved:29; 
    uint64_t hits; 
    uint64_t bytes; 
};

struct rte_flow_action_dup {
    uint16_t index; 
};

struct rte_flow_action_rss {
    const struct rte_eth_rss_conf *rss_conf; 
    uint16_t num; 
    uint16_t queue[]; 
};

struct rte_flow_action_vf {
    uint32_t original:1; 
    uint32_t reserved:31; 
    uint32_t id; 
};

struct rte_flow_action_meter {
    uint32_t mtr_id; 
};

struct rte_flow_action_security {
    void *security_session; 
};

struct rte_flow_action {
    enum rte_flow_action_type type; 
    const void *conf; 
};

struct rte_flow;

enum rte_flow_error_type {
    RTE_FLOW_ERROR_TYPE_NONE, 
    RTE_FLOW_ERROR_TYPE_UNSPECIFIED, 
    RTE_FLOW_ERROR_TYPE_HANDLE, 
    RTE_FLOW_ERROR_TYPE_ATTR_GROUP, 
    RTE_FLOW_ERROR_TYPE_ATTR_PRIORITY, 
    RTE_FLOW_ERROR_TYPE_ATTR_INGRESS, 
    RTE_FLOW_ERROR_TYPE_ATTR_EGRESS, 
    RTE_FLOW_ERROR_TYPE_ATTR, 
    RTE_FLOW_ERROR_TYPE_ITEM_NUM, 
    RTE_FLOW_ERROR_TYPE_ITEM, 
    RTE_FLOW_ERROR_TYPE_ACTION_NUM, 
    RTE_FLOW_ERROR_TYPE_ACTION, 
};

struct rte_flow_error {
    enum rte_flow_error_type type; 
    const void *cause; 
    const char *message; 
};

int
rte_flow_validate(uint16_t port_id,
          const struct rte_flow_attr *attr,
          const struct rte_flow_item pattern[],
          const struct rte_flow_action actions[],
          struct rte_flow_error *error);

struct rte_flow *
rte_flow_create(uint16_t port_id,
        const struct rte_flow_attr *attr,
        const struct rte_flow_item pattern[],
        const struct rte_flow_action actions[],
        struct rte_flow_error *error);

int
rte_flow_destroy(uint16_t port_id,
         struct rte_flow *flow,
         struct rte_flow_error *error);

int
rte_flow_flush(uint16_t port_id,
           struct rte_flow_error *error);

int
rte_flow_query(uint16_t port_id,
           struct rte_flow *flow,
           enum rte_flow_action_type action,
           void *data,
           struct rte_flow_error *error);

int
rte_flow_isolate(uint16_t port_id, int set, struct rte_flow_error *error);

int
rte_flow_error_set(struct rte_flow_error *error,
           int code,
           enum rte_flow_error_type type,
           const void *cause,
           const char *message);

struct rte_flow_desc {
    size_t size; 
    struct rte_flow_attr attr; 
    struct rte_flow_item *items; 
    struct rte_flow_action *actions; 
    uint8_t data[]; 
};

size_t
rte_flow_copy(struct rte_flow_desc *fd, size_t len,
          const struct rte_flow_attr *attr,
          const struct rte_flow_item *items,
          const struct rte_flow_action *actions);

#ifdef __cplusplus
}
#endif

#endif /* RTE_FLOW_H_ */