ethdev: add HIGIG2 key field to flow API
authorKiran Kumar K <kirankumark@marvell.com>
Tue, 22 Oct 2019 04:16:48 +0000 (09:46 +0530)
committerFerruh Yigit <ferruh.yigit@intel.com>
Wed, 23 Oct 2019 14:43:10 +0000 (16:43 +0200)
Add new rte_flow_item_higig2_hdr in order to match higig2 header.
It is a layer 2.5 protocol and used in Broadcom switches.
Header format is based on the following document.
http://read.pudn.com/downloads558/doc/comm/2301468/HiGig_protocol.pdf

Signed-off-by: Kiran Kumar K <kirankumark@marvell.com>
Acked-by: Andrew Rybchenko <arybchenko@solarflare.com>
Acked-by: Olivier Matz <olivier.matz@6wind.com>
app/test-pmd/cmdline_flow.c
doc/api/doxy-api-index.md
doc/guides/prog_guide/rte_flow.rst
lib/librte_ethdev/rte_flow.c
lib/librte_ethdev/rte_flow.h
lib/librte_net/Makefile
lib/librte_net/meson.build
lib/librte_net/rte_higig.h [new file with mode: 0644]

index b26b8bf..970bdef 100644 (file)
@@ -203,6 +203,9 @@ enum index {
        ITEM_PPPOED,
        ITEM_PPPOE_SEID,
        ITEM_PPPOE_PROTO_ID,
+       ITEM_HIGIG2,
+       ITEM_HIGIG2_CLASSIFICATION,
+       ITEM_HIGIG2_VID,
 
        /* Validate/create actions. */
        ACTIONS,
@@ -675,6 +678,7 @@ static const enum index next_item[] = {
        ITEM_PPPOES,
        ITEM_PPPOED,
        ITEM_PPPOE_PROTO_ID,
+       ITEM_HIGIG2,
        END_SET,
        ZERO,
 };
@@ -939,6 +943,13 @@ static const enum index item_pppoe_proto_id[] = {
        ZERO,
 };
 
+static const enum index item_higig2[] = {
+       ITEM_HIGIG2_CLASSIFICATION,
+       ITEM_HIGIG2_VID,
+       ITEM_NEXT,
+       ZERO,
+};
+
 static const enum index next_action[] = {
        ACTION_END,
        ACTION_VOID,
@@ -2419,6 +2430,28 @@ static const struct token token_list[] = {
                .next = NEXT(item_pppoe_proto_id),
                .call = parse_vc,
        },
+       [ITEM_HIGIG2] = {
+               .name = "higig2",
+               .help = "matches higig2 header",
+               .priv = PRIV_ITEM(HIGIG2,
+                               sizeof(struct rte_flow_item_higig2_hdr)),
+               .next = NEXT(item_higig2),
+               .call = parse_vc,
+       },
+       [ITEM_HIGIG2_CLASSIFICATION] = {
+               .name = "classification",
+               .help = "matches classification of higig2 header",
+               .next = NEXT(item_higig2, NEXT_ENTRY(UNSIGNED), item_param),
+               .args = ARGS(ARGS_ENTRY_HTON(struct rte_flow_item_higig2_hdr,
+                                       hdr.ppt1.classification)),
+       },
+       [ITEM_HIGIG2_VID] = {
+               .name = "vid",
+               .help = "matches vid of higig2 header",
+               .next = NEXT(item_higig2, NEXT_ENTRY(UNSIGNED), item_param),
+               .args = ARGS(ARGS_ENTRY_HTON(struct rte_flow_item_higig2_hdr,
+                                       hdr.ppt1.vid)),
+       },
        /* Validate/create actions. */
        [ACTIONS] = {
                .name = "actions",
index 06f51ee..d65b5ed 100644 (file)
@@ -91,6 +91,7 @@ The public API headers are grouped by topics:
 - **layers**:
   [ethernet]           (@ref rte_ether.h),
   [ARP]                (@ref rte_arp.h),
+  [HIGIG]              (@ref rte_higig.h),
   [ICMP]               (@ref rte_icmp.h),
   [ESP]                (@ref rte_esp.h),
   [IPsec]              (@ref rte_ipsec.h),
index b032f2d..159ce19 100644 (file)
@@ -1289,6 +1289,14 @@ Matches a IP Authentication Header (RFC 4302).
 - ``seq_num``: counter value increased by 1 on each packet sent.
 - Default ``mask`` matches spi.
 
+Item: ``HIGIG2``
+^^^^^^^^^^^^^^^^^
+
+Matches a HIGIG2 header field. It is layer 2.5 protocol and used in
+Broadcom switches.
+
+- Default ``mask`` matches classification and vlan.
+
 
 Actions
 ~~~~~~~
index 81a85b9..ca0f680 100644 (file)
@@ -83,6 +83,7 @@ static const struct rte_flow_desc_data rte_flow_desc_item[] = {
        MK_FLOW_ITEM(NSH, sizeof(struct rte_flow_item_nsh)),
        MK_FLOW_ITEM(IGMP, sizeof(struct rte_flow_item_igmp)),
        MK_FLOW_ITEM(AH, sizeof(struct rte_flow_item_ah)),
+       MK_FLOW_ITEM(HIGIG2, sizeof(struct rte_flow_item_higig2_hdr)),
 };
 
 /** Generate flow_action[] entry. */
index bcfc06c..4fee105 100644 (file)
@@ -27,6 +27,7 @@
 #include <rte_udp.h>
 #include <rte_byteorder.h>
 #include <rte_esp.h>
+#include <rte_higig.h>
 
 #ifdef __cplusplus
 extern "C" {
@@ -491,8 +492,36 @@ enum rte_flow_item_type {
         *
         */
        RTE_FLOW_ITEM_TYPE_AH,
+
+       /**
+        * Matches a HIGIG header.
+        * see struct rte_flow_item_higig2_hdr.
+        */
+       RTE_FLOW_ITEM_TYPE_HIGIG2,
 };
 
+/**
+ *
+ * RTE_FLOW_ITEM_TYPE_HIGIG2
+ * Matches higig2 header
+ */
+RTE_STD_C11
+struct rte_flow_item_higig2_hdr {
+       struct rte_higig2_hdr hdr;
+};
+
+/** Default mask for RTE_FLOW_ITEM_TYPE_HIGIG2. */
+#ifndef __cplusplus
+static const struct rte_flow_item_higig2_hdr rte_flow_item_higig2_hdr_mask = {
+       .hdr = {
+               .ppt1 = {
+                       .classification = 0xffff,
+                       .vid = 0xfff,
+               },
+       },
+};
+#endif
+
 /**
  * RTE_FLOW_ITEM_TYPE_ANY
  *
index 1244c9f..62735a5 100644 (file)
@@ -21,6 +21,6 @@ SRCS-$(CONFIG_RTE_LIBRTE_NET) += rte_arp.c
 SYMLINK-$(CONFIG_RTE_LIBRTE_NET)-include := rte_ip.h rte_tcp.h rte_udp.h rte_esp.h
 SYMLINK-$(CONFIG_RTE_LIBRTE_NET)-include += rte_sctp.h rte_icmp.h rte_arp.h
 SYMLINK-$(CONFIG_RTE_LIBRTE_NET)-include += rte_ether.h rte_gre.h rte_net.h
-SYMLINK-$(CONFIG_RTE_LIBRTE_NET)-include += rte_net_crc.h rte_mpls.h
+SYMLINK-$(CONFIG_RTE_LIBRTE_NET)-include += rte_net_crc.h rte_mpls.h rte_higig.h
 
 include $(RTE_SDK)/mk/rte.lib.mk
index 868a93f..c52c345 100644 (file)
@@ -14,7 +14,8 @@ headers = files('rte_ip.h',
        'rte_gre.h',
        'rte_net.h',
        'rte_net_crc.h',
-       'rte_mpls.h')
+       'rte_mpls.h',
+       'rte_higig.h')
 
 sources = files('rte_arp.c', 'rte_ether.c', 'rte_net.c', 'rte_net_crc.c')
 deps += ['mbuf']
diff --git a/lib/librte_net/rte_higig.h b/lib/librte_net/rte_higig.h
new file mode 100644 (file)
index 0000000..b9cdfef
--- /dev/null
@@ -0,0 +1,145 @@
+
+/* SPDX-License-Identifier: BSD-3-Clause
+ * Copyright(C) 2019 Marvell International Ltd.
+ */
+
+#ifndef _RTE_HIGIG_H_
+#define _RTE_HIGIG_H_
+
+#include <stdint.h>
+#include <rte_byteorder.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ *
+ * higig2 frc header.
+ */
+struct rte_higig2_frc {
+#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN
+       uint32_t ksop:8;
+       uint32_t tc:4;
+       uint32_t mcst:1;
+       uint32_t resv:3;
+       uint32_t dst_modid:8;
+       uint32_t dst_pid:8;
+       uint32_t src_modid:8;
+       uint32_t src_pid:8;
+       uint32_t lbid:8;
+       uint32_t ppd_type:3;
+       uint32_t resv1:3;
+       uint32_t dp:2;
+#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN
+       uint32_t ksop:8;
+       uint32_t resv:3;
+       uint32_t mcst:1;
+       uint32_t tc:4;
+       uint32_t dst_modid:8;
+       uint32_t dst_pid:8;
+       uint32_t src_modid:8;
+       uint32_t src_pid:8;
+       uint32_t lbid:8;
+       uint32_t dp:2;
+       uint32_t resv1:3;
+       uint32_t ppd_type:3;
+#endif
+};
+
+
+/**
+ *
+ * higig2 ppt type0 header
+ */
+struct rte_higig2_ppt_type0 {
+#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN
+       uint32_t mirror:1;
+       uint32_t mirror_done:1;
+       uint32_t mirror_only:1;
+       uint32_t ingress_tagged:1;
+       uint32_t dst_tgid:3;
+       uint32_t dst_t:1;
+       uint32_t vc_label2:4;
+       uint32_t label_present:1;
+       uint32_t l3:1;
+       uint32_t res:2;
+       uint32_t vc_label1:8;
+       uint32_t vc_label0:8;
+       uint32_t vid_high:8;
+       uint32_t vid_low:8;
+       uint32_t opc:3;
+       uint32_t res1:2;
+       uint32_t srce_t:1;
+       uint32_t pf:2;
+       uint32_t res2:5;
+       uint32_t hdr_ext_length:3;
+#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN
+       uint32_t dst_t:1;
+       uint32_t dst_tgid:3;
+       uint32_t ingress_tagged:1;
+       uint32_t mirror_only:1;
+       uint32_t mirror_done:1;
+       uint32_t mirror:1;
+       uint32_t res:2;
+       uint32_t l3:1;
+       uint32_t label_present:1;
+       uint32_t vc_label2:4;
+       uint32_t vc_label1:8;
+       uint32_t vc_label0:8;
+       uint32_t vid_high:8;
+       uint32_t vid_low:8;
+       uint32_t pf:2;
+       uint32_t srce_t:1;
+       uint32_t res1:2;
+       uint32_t opc:3;
+       uint32_t hdr_ext_length:3;
+       uint32_t res2:5;
+#endif
+};
+
+
+/**
+ *
+ * higig2 ppt type1 header.
+ */
+__extension__
+struct rte_higig2_ppt_type1 {
+       uint16_t classification;
+       uint16_t resv;
+       uint16_t vid;
+#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN
+       uint16_t opcode:3;
+       uint16_t resv1:2;
+       uint16_t src_t:1;
+       uint16_t pfm:2;
+       uint16_t resv2:5;
+       uint16_t hdr_ext_len:3;
+#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN
+       uint16_t pfm:2;
+       uint16_t src_t:1;
+       uint16_t resv1:2;
+       uint16_t opcode:3;
+       uint16_t hdr_ext_len:3;
+       uint16_t resv2:5;
+#endif
+};
+
+/**
+ *
+ * higig2 header
+ */
+RTE_STD_C11
+struct rte_higig2_hdr {
+       struct rte_higig2_frc fcr;
+       union {
+               struct rte_higig2_ppt_type0 ppt0;
+               struct rte_higig2_ppt_type1 ppt1;
+       };
+};
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RTE_HIGIG_H_ */