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>

#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,
};

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 {
        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,
};

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 {
        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(uint8_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(uint8_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(uint8_t port_id,
                 struct rte_flow *flow,
                 struct rte_flow_error *error);

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

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

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

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_ */