packetforge: add packetforge for generic flow to extras

Add a new tool packetforge to extras. This tool is to support generic flow.
Packetforge is a library to translate naming or json profile format flow
pattern to the required input of generic flow, i.e. spec and mask. Using
python script flow_create.py, it can add and enable a new flow rule for
an interface via flow VAPI, and can delete an existed flow rule as well.
Command examples are shown below. Json profile examples can be found in
./parsegraph/samples.

Naming format input:
python flow_create.py --add -p "mac()/ipv4(src=1.1.1.1,dst=2.2.2.2)/udp()"
-a "redirect-to-queue 3" -i 1
python flow_create.py --del -i 1 -I 0

Json profile format input:
python flow_create.py -f "./flow_rule_examples/mac_ipv4.json" -i 1

With this command, flow rule can be added or deleted, and the flow
entry can be listed with "show flow entry" command in VPP CLI.

Packetforge is based on a parsegraph. The parsegraph can be built by
users. A Spec can be found in ./parsegraph as guidance. More details
about packetforge are in README file.

Type: feature

Signed-off-by: Ting Xu <ting.xu@intel.com>
Change-Id: Ia9f539741c5dca27ff236f2bcc493c5dd48c0df1

6 files changed, 215 insertions, 0 deletions

diff --git a/extras/packetforge/parsegraph/samples/mac_ipv4.json b/extras/packetforge/parsegraph/samples/mac_ipv4.json
new file mode 100644
index 00000000000..c0a8d18177d
--- /dev/null
+++ b/extras/packetforge/parsegraph/samples/mac_ipv4.json
@@ -0,0 +1,24 @@
+{
+    "type" : "path",
+    "stack" : [
+        {
+            "header" : "mac"
+        },
+        {
+            "header" : "ipv4",
+            "fields" : [
+                {
+                    "name" : "src",
+                    "value" : "1.1.1.1",
+                    "mask" : "255.255.255.255"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "2.2.2.2",
+                    "mask" : "255.255.255.255"
+                }
+            ]
+        }
+    ],
+    "actions" : "redirect-to-queue 3"
+}
diff --git a/extras/packetforge/parsegraph/samples/mac_ipv4_udp.json b/extras/packetforge/parsegraph/samples/mac_ipv4_udp.json
new file mode 100644
index 00000000000..7df27cfdf12
--- /dev/null
+++ b/extras/packetforge/parsegraph/samples/mac_ipv4_udp.json
@@ -0,0 +1,27 @@
+{
+    "type" : "path",
+    "stack" : [
+        {
+            "header" : "mac"
+        },
+        {
+            "header" : "ipv4",
+            "fields" : [
+                {
+                    "name" : "src",
+                    "value" : "1.1.1.1",
+                    "mask" : "255.255.255.255"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "2.2.2.2",
+                    "mask" : "255.255.255.255"
+                }
+            ]
+        },
+        {
+            "header" : "udp"
+        }
+    ],
+    "actions" : "rss"
+}
\ No newline at end of file
diff --git a/extras/packetforge/parsegraph/samples/mac_ipv4_udp_gtpu_gtppsc_ipv4.json b/extras/packetforge/parsegraph/samples/mac_ipv4_udp_gtpu_gtppsc_ipv4.json
new file mode 100644
index 00000000000..39a8d6159b4
--- /dev/null
+++ b/extras/packetforge/parsegraph/samples/mac_ipv4_udp_gtpu_gtppsc_ipv4.json
@@ -0,0 +1,43 @@
+{
+    "type" : "path",
+    "stack" : [
+        {
+            "header" : "mac"
+        },
+        {
+            "header" : "ipv4"
+        },
+        {
+            "header" : "udp"
+        },
+        {
+            "header" : "gtpu",
+            "fields" : [
+                {
+                    "name" : "teid",
+                    "value" : "32",
+                    "mask" : "0xffffffff"
+                }
+            ]
+        },
+        {
+            "header" : "gtppsc"
+        },
+        {
+            "header" : "ipv4",
+            "fields" : [
+                {
+                    "name" : "src",
+                    "value" : "1.1.1.1",
+                    "mask" : "255.255.255.255"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "2.2.2.2",
+                    "mask" : "255.255.255.255"
+                }
+            ]
+        }
+    ],
+    "actions" : "rss"
+}
diff --git a/extras/packetforge/parsegraph/samples/mac_ipv4_udp_vxlan_mac_ipv4.json b/extras/packetforge/parsegraph/samples/mac_ipv4_udp_vxlan_mac_ipv4.json
new file mode 100644
index 00000000000..346dcd27fcb
--- /dev/null
+++ b/extras/packetforge/parsegraph/samples/mac_ipv4_udp_vxlan_mac_ipv4.json
@@ -0,0 +1,43 @@
+{
+    "type" : "path",
+    "stack" : [
+        {
+            "header" : "mac"
+        },
+        {
+            "header" : "ipv4"
+        },
+        {
+            "header" : "udp"
+        },
+        {
+            "header" : "vxlan",
+            "fields" : [
+                {
+                    "name" : "vni",
+                    "value" : "100",
+                    "mask" : "0xffffff"
+                }
+            ]
+        },
+        {
+            "header" : "mac"
+        },
+        {
+            "header" : "ipv4",
+            "fields" : [
+                {
+                    "name" : "src",
+                    "value" : "1.1.1.1",
+                    "mask" : "255.255.255.255"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "2.2.2.2",
+                    "mask" : "255.255.255.255"
+                }
+            ]
+        }
+    ],
+    "actions" : "rss"
+}
diff --git a/extras/packetforge/parsegraph/samples/mac_ipv6.json b/extras/packetforge/parsegraph/samples/mac_ipv6.json
new file mode 100644
index 00000000000..17b6490c099
--- /dev/null
+++ b/extras/packetforge/parsegraph/samples/mac_ipv6.json
@@ -0,0 +1,44 @@
+{
+    "type" : "path",
+    "stack" : [
+        {
+            "header" : "mac",
+            "fields" : [
+                {
+                    "name" : "src",
+                    "value" : "00:00:00:00:00:01",
+                    "mask" : "ff:ff:ff:ff:ff:ff"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "00:00:00:00:00:02",
+                    "mask" : "ff:ff:ff:ff:ff:ff"
+                },
+                {
+                    "name" : "ethertype",
+                    "value" : "0x2345"
+                }
+            ]
+        },
+        {
+            "header" : "ipv6",
+            "fields" : [
+                {
+                    "name" : "flowlabel",
+                    "value" : "1"
+                },
+                {
+                    "name" : "src",
+                    "value" : "0001:0002:0003:0004:0005:0006:0007:0008",
+                    "mask" : "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "0001:0002:0003:0004:0005:0006:0007:0008",
+                    "mask" : "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff"
+                }
+            ]
+        }
+    ],
+    "actions" : "rss"
+}
diff --git a/extras/packetforge/parsegraph/samples/mac_vlan_ipv4.json b/extras/packetforge/parsegraph/samples/mac_vlan_ipv4.json
new file mode 100644
index 00000000000..7905133a8e0
--- /dev/null
+++ b/extras/packetforge/parsegraph/samples/mac_vlan_ipv4.json
@@ -0,0 +1,34 @@
+{
+    "type" : "path",
+    "stack" : [
+        {
+            "header" : "mac"
+        },
+        {
+            "header" : "vlan",
+            "fields" : [
+                {
+                    "name" : "vid",
+                    "value" : "100",
+                    "mask" : "0xfff"
+                }
+            ]
+        },
+        {
+            "header" : "ipv4",
+            "fields" : [
+                {
+                    "name" : "src",
+                    "value" : "1.1.1.1",
+                    "mask" : "255.255.255.255"
+                },
+                {
+                    "name" : "dst",
+                    "value" : "2.2.2.2",
+                    "mask" : "255.255.255.255"
+                }
+            ]
+        }
+    ],
+    "actions" : "rss"
+}