Adding PROX(Packet pROcessing eXecution engine) VNF to sampleVNF

JIRA: SAMPLEVNF-55

PROX is a DPDK-based application implementing Telco use-cases such as
a simplified BRAS/BNG, light-weight AFTR... It also allows configuring
finer grained network functions like QoS, Routing, load-balancing...

(We are moving PROX version v039 to sampleVNF
https://01.org/intel-data-plane-performance-demonstrators/prox-overview)

Change-Id: Ia3cb02cf0e49ac5596e922c197ff7e010293d033
Signed-off-by: Deepak S <deepak.s@linux.intel.com>

3 files changed, 151 insertions, 0 deletions

diff --git a/VNFs/DPPD-PROX/dpi/Makefile b/VNFs/DPPD-PROX/dpi/Makefile
new file mode 100644
index 00000000..fc943580
--- /dev/null
+++ b/VNFs/DPPD-PROX/dpi/Makefile
@@ -0,0 +1,18 @@
+##
+## Copyright (c) 2010-2017 Intel Corporation
+##
+## Licensed under the Apache License, Version 2.0 (the "License");
+## you may not use this file except in compliance with the License.
+## You may obtain a copy of the License at
+##
+##     http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing, software
+## distributed under the License is distributed on an "AS IS" BASIS,
+## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+## See the License for the specific language governing permissions and
+## limitations under the License.
+##
+
+all:
+	gcc -fpic -shared dpi_stub.c -o dpi_stub.so
diff --git a/VNFs/DPPD-PROX/dpi/dpi.h b/VNFs/DPPD-PROX/dpi/dpi.h
new file mode 100644
index 00000000..5ce1015d
--- /dev/null
+++ b/VNFs/DPPD-PROX/dpi/dpi.h
@@ -0,0 +1,76 @@
+/*
+// Copyright (c) 2010-2017 Intel Corporation
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+*/
+
+#ifndef _DPI_H_
+#define _DPI_H_
+
+#include <sys/time.h>
+#include <inttypes.h>
+#include <stddef.h>
+
+struct flow_info {
+	uint32_t ip_src;
+	uint32_t ip_dst;
+	uint8_t ip_proto;
+	uint16_t port_src;
+	uint16_t port_dst;
+	uint8_t reservered[3];
+} __attribute__((packed));
+
+struct dpi_payload {
+	uint8_t  *payload;
+	uint16_t len;
+	uint16_t client_to_server;
+	struct timeval tv;
+};
+
+struct dpi_engine {
+	/* Returns 0 on success, This function is called from an
+	   arbitrary thread before any other function in this struct
+	   is called. */
+	int (*dpi_init)(uint32_t thread_count, int argc, const char *argv[]);
+	/* Return the size that should be allocated in the flow
+	   table. It is the sizeof(*flow_data) passed to
+	   dpi_process(). */
+	size_t (*dpi_get_flow_entry_size)(void);
+	/* Called before the flow entry is expired. */
+	void (*dpi_flow_expire)(void *flow_data);
+	/* start function called from a DPI thread itself. The opaque
+	   pointer returned here will be passed to dpi_thread_stop and
+	   dpi_process. */
+	void *(*dpi_thread_start)(void);
+	/* Stop function called from a DPI thread itself. */
+	void (*dpi_thread_stop)(void *opaque);
+	/* Processing function to perform actual DPI work. struct
+	   flow_info contains the 5 tuple, flow_data is the entry in
+	   the flow table which has a size specified by
+	   dpi_get_flow_entry_size(). The payload (together with the
+	   time and the direction) is passed through the payload
+	   parameter. DPI results are returned by the results
+	   array. The function returns 0 on success. */
+	int (*dpi_process)(void *opaque, struct flow_info *fi, void *flow_data,
+			   struct dpi_payload *payload, uint32_t results[],
+			   size_t *result_len);
+	/* Called once at cleanup. */
+	void (*dpi_finish)(void);
+	/* Function used for printing. */
+	int (*dpi_print)(const char *fmt, ...);
+};
+
+/* Returns the implementation of a dpi_engine. */
+struct dpi_engine *get_dpi_engine(void);
+
+#endif /* _DPI_H_ */
diff --git a/VNFs/DPPD-PROX/dpi/dpi_stub.c b/VNFs/DPPD-PROX/dpi/dpi_stub.c
new file mode 100644
index 00000000..8febbcb9
--- /dev/null
+++ b/VNFs/DPPD-PROX/dpi/dpi_stub.c
@@ -0,0 +1,57 @@
+/*
+// Copyright (c) 2010-2017 Intel Corporation
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+*/
+
+#include <stdio.h>
+
+#include "dpi.h"
+
+/* The following functions are not a real implementation of a
+   DPI. They serve only to create dpi_stub.so which can be loaded into
+   prox. */
+
+static int dpi_init(uint32_t thread_count, int argc, const char *argv[])
+{
+	return 0;
+}
+
+size_t dpi_get_flow_entry_size(void) {return 0;}
+void flow_data_dpi_flow_expire(void *flow_data) {}
+void *dpi_thread_start() {return NULL;}
+void dpi_thread_stop(void *opaque) {}
+void dpi_finish(void) {}
+
+int dpi_process(void *opaque, struct flow_info *fi, void *flow_data,
+		struct dpi_payload *payload, uint32_t results[],
+		size_t *result_len)
+{
+	return 0;
+}
+
+static struct dpi_engine dpi_engine = {
+	.dpi_init = dpi_init,
+	.dpi_get_flow_entry_size = dpi_get_flow_entry_size,
+	.dpi_flow_expire = flow_data_dpi_flow_expire,
+	.dpi_thread_start = dpi_thread_start,
+	.dpi_thread_stop = dpi_thread_stop,
+	.dpi_process = dpi_process,
+	.dpi_finish = dpi_finish,
+	.dpi_print = printf,
+};
+
+struct dpi_engine *get_dpi_engine(void)
+{
+	return &dpi_engine;
+}