get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/105133/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 105133,
    "url": "http://patches.dpdk.org/api/patches/105133/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20211214141242.3383831-4-ronan.randles@intel.com/",
    "project": {
        "id": 1,
        "url": "http://patches.dpdk.org/api/projects/1/?format=api",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk",
        "list_archive_url": "https://inbox.dpdk.org/dev",
        "list_archive_url_format": "https://inbox.dpdk.org/dev/{}",
        "commit_url_format": ""
    },
    "msgid": "<20211214141242.3383831-4-ronan.randles@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20211214141242.3383831-4-ronan.randles@intel.com",
    "date": "2021-12-14T14:12:33",
    "name": "[03/12] gen: add files for initial traffic generation library",
    "commit_ref": null,
    "pull_url": null,
    "state": "not-applicable",
    "archived": true,
    "hash": "4b9086c5604c21207a06c12b6b7f03889cbd32da",
    "submitter": {
        "id": 2439,
        "url": "http://patches.dpdk.org/api/people/2439/?format=api",
        "name": "Ronan Randles",
        "email": "ronan.randles@intel.com"
    },
    "delegate": {
        "id": 1,
        "url": "http://patches.dpdk.org/api/users/1/?format=api",
        "username": "tmonjalo",
        "first_name": "Thomas",
        "last_name": "Monjalon",
        "email": "thomas@monjalon.net"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/patch/20211214141242.3383831-4-ronan.randles@intel.com/mbox/",
    "series": [
        {
            "id": 20944,
            "url": "http://patches.dpdk.org/api/series/20944/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=20944",
            "date": "2021-12-14T14:12:30",
            "name": "add packet generator library and example app",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/20944/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/105133/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/105133/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 0E161A00C3;\n\tTue, 14 Dec 2021 15:13:11 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 8B4E841154;\n\tTue, 14 Dec 2021 15:12:53 +0100 (CET)",
            "from mga07.intel.com (mga07.intel.com [134.134.136.100])\n by mails.dpdk.org (Postfix) with ESMTP id F177341144\n for <dev@dpdk.org>; Tue, 14 Dec 2021 15:12:50 +0100 (CET)",
            "from orsmga006.jf.intel.com ([10.7.209.51])\n by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 14 Dec 2021 06:12:50 -0800",
            "from silpixa00401120.ir.intel.com ([10.55.129.95])\n by orsmga006.jf.intel.com with ESMTP; 14 Dec 2021 06:12:49 -0800"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=simple/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1639491171; x=1671027171;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=cRqIAjEh/bn9SIrN0q/HDxXwevFEETN9iAflOuH2jxM=;\n b=K4ue8ESfO2p+6reHJZ5+fnGGYSOM1pT0Qt5g9+RyWfOD7QOt0mwelyWu\n vJ0KaGwDqOeVuRiAZZXo5eS2mTPHvX+QoCHKMFHPEnQ5VD0s0F0//eZlN\n UtvcUsqBylX3LmcobTENW3nV3P8VHKHKc/uENnt4z4XlqA3FF9mhDKxXx\n b85NIIw1j/aNjKrCs8v7RiMfHCyN0hRmPd74tzOR4p2d851ZSfeqr+TIn\n pio5n7xcytPNGE2TW25zLc8uzvRVqe225LoO2iAjtG/lvcPakVPTzbq4i\n SCOP1S0Ga1ZOlEsSFVvRJz/eDYxn02tiSdk/Ny4hOowXoqtzAARXhVBCh g==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6200,9189,10197\"; a=\"302362306\"",
            "E=Sophos;i=\"5.88,205,1635231600\"; d=\"scan'208\";a=\"302362306\"",
            "E=Sophos;i=\"5.88,205,1635231600\"; d=\"scan'208\";a=\"465104103\""
        ],
        "X-ExtLoop1": "1",
        "From": "Ronan Randles <ronan.randles@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "harry.van.haaren@intel.com",
        "Subject": "[PATCH 03/12] gen: add files for initial traffic generation library",
        "Date": "Tue, 14 Dec 2021 14:12:33 +0000",
        "Message-Id": "<20211214141242.3383831-4-ronan.randles@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20211214141242.3383831-1-ronan.randles@intel.com>",
        "References": "<20211214141242.3383831-1-ronan.randles@intel.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org"
    },
    "content": "From: Harry van Haaren <harry.van.haaren@intel.com>\n\nThis commit adds empty files to the DPDK build for a traffic\ngeneration library, including the bare create and destroy functions.\nUnit testing infrastructure is added for the create function.\n\nSigned-off-by: Harry van Haaren <harry.van.haaren@intel.com>\n---\n app/test/meson.build      |  2 ++\n app/test/test_gen.c       | 55 +++++++++++++++++++++++++++++++++++++++\n doc/api/doxy-api-index.md |  3 ++-\n doc/api/doxy-api.conf.in  |  1 +\n lib/gen/meson.build       |  5 ++++\n lib/gen/rte_gen.c         | 33 +++++++++++++++++++++++\n lib/gen/rte_gen.h         | 44 +++++++++++++++++++++++++++++++\n lib/gen/version.map       |  6 +++++\n lib/meson.build           |  1 +\n 9 files changed, 149 insertions(+), 1 deletion(-)\n create mode 100644 app/test/test_gen.c\n create mode 100644 lib/gen/meson.build\n create mode 100644 lib/gen/rte_gen.c\n create mode 100644 lib/gen/rte_gen.h\n create mode 100644 lib/gen/version.map",
    "diff": "diff --git a/app/test/meson.build b/app/test/meson.build\nindex 4cf540fc74..0e4f3b810d 100644\n--- a/app/test/meson.build\n+++ b/app/test/meson.build\n@@ -66,6 +66,7 @@ test_sources = files(\n         'test_fib6_perf.c',\n         'test_func_reentrancy.c',\n         'test_flow_classify.c',\n+        'test_gen.c',\n         'test_graph.c',\n         'test_graph_perf.c',\n         'test_hash.c',\n@@ -173,6 +174,7 @@ test_deps = [\n         'eventdev',\n         'fib',\n         'flow_classify',\n+        'gen',\n         'graph',\n         'hash',\n         'ipsec',\ndiff --git a/app/test/test_gen.c b/app/test/test_gen.c\nnew file mode 100644\nindex 0000000000..f53f4a6608\n--- /dev/null\n+++ b/app/test/test_gen.c\n@@ -0,0 +1,55 @@\n+/* SPDX-License-Identifier: BSD-3-Clause\n+ * Copyright(c) 2021 Intel Corporation\n+ */\n+\n+#include <rte_common.h>\n+#include <rte_gen.h>\n+#include <rte_mbuf.h>\n+\n+#include \"test.h\"\n+\n+static struct rte_mempool *mp;\n+\n+static int\n+testsuite_setup(void)\n+{\n+\tif (!mp) {\n+\t\tmp = rte_pktmbuf_pool_create(\"test_gen_mp\", 8192, 256, 0, 2048,\n+\t\t\t\t\t\tSOCKET_ID_ANY);\n+\t}\n+\treturn mp ? TEST_SUCCESS : TEST_FAILED;\n+}\n+\n+static void\n+testsuite_teardown(void)\n+{\n+\trte_mempool_free(mp);\n+}\n+\n+static int\n+test_gen_create(void)\n+{\n+\tstruct rte_gen *gen = rte_gen_create(mp);\n+\tTEST_ASSERT_FAIL(gen, \"Expected valid pointer after create()\");\n+\n+\trte_gen_destroy(gen);\n+\treturn 0;\n+}\n+\n+static struct unit_test_suite gen_suite  = {\n+\t.suite_name = \"gen: packet generator unit test suite\",\n+\t.setup = testsuite_setup,\n+\t.teardown = testsuite_teardown,\n+\t.unit_test_cases = {\n+\t\tTEST_CASE_ST(NULL, NULL, test_gen_create),\n+\t\tTEST_CASES_END() /**< NULL terminate unit test array */\n+\t}\n+};\n+\n+static int\n+test_gen_suite(void)\n+{\n+\treturn unit_test_suite_runner(&gen_suite);\n+}\n+\n+REGISTER_TEST_COMMAND(gen_autotest, test_gen_suite);\ndiff --git a/doc/api/doxy-api-index.md b/doc/api/doxy-api-index.md\nindex 4245b9635c..f7ddadd21a 100644\n--- a/doc/api/doxy-api-index.md\n+++ b/doc/api/doxy-api-index.md\n@@ -220,7 +220,8 @@ The public API headers are grouped by topics:\n   [log]                (@ref rte_log.h),\n   [errno]              (@ref rte_errno.h),\n   [trace]              (@ref rte_trace.h),\n-  [trace_point]        (@ref rte_trace_point.h)\n+  [trace_point]        (@ref rte_trace_point.h),\n+  [gen]                (@ref rte_gen.h)\n \n - **misc**:\n   [EAL config]         (@ref rte_eal.h),\ndiff --git a/doc/api/doxy-api.conf.in b/doc/api/doxy-api.conf.in\nindex db2ca9b6ed..6344e949d9 100644\n--- a/doc/api/doxy-api.conf.in\n+++ b/doc/api/doxy-api.conf.in\n@@ -41,6 +41,7 @@ INPUT                   = @TOPDIR@/doc/api/doxy-api-index.md \\\n                           @TOPDIR@/lib/eventdev \\\n                           @TOPDIR@/lib/fib \\\n                           @TOPDIR@/lib/flow_classify \\\n+                          @TOPDIR@/lib/gen \\\n                           @TOPDIR@/lib/gpudev \\\n                           @TOPDIR@/lib/graph \\\n                           @TOPDIR@/lib/gro \\\ndiff --git a/lib/gen/meson.build b/lib/gen/meson.build\nnew file mode 100644\nindex 0000000000..3c5d854645\n--- /dev/null\n+++ b/lib/gen/meson.build\n@@ -0,0 +1,5 @@\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright(c) 2021 Intel Corporation\n+\n+sources = files('rte_gen.c')\n+headers = files('rte_gen.h')\ndiff --git a/lib/gen/rte_gen.c b/lib/gen/rte_gen.c\nnew file mode 100644\nindex 0000000000..d993772422\n--- /dev/null\n+++ b/lib/gen/rte_gen.c\n@@ -0,0 +1,33 @@\n+/* SPDX-License-Identifier: BSD-3-Clause\n+ * Copyright(c) 2021 Intel Corporation\n+ */\n+\n+#include \"rte_gen.h\"\n+\n+#include <rte_malloc.h>\n+\n+/** Structure that represents a traffic generator. */\n+struct rte_gen {\n+\t/* Mempool that buffers are retrieved from. */\n+\tstruct rte_mempool *mp;\n+};\n+\n+/* Allocate and initialize a traffic generator instance. */\n+struct rte_gen *\n+rte_gen_create(struct rte_mempool *mempool)\n+{\n+\tstruct rte_gen *gen = rte_zmalloc(NULL, sizeof(*gen), 0);\n+\tif (gen == NULL)\n+\t\treturn NULL;\n+\n+\tgen->mp = mempool;\n+\n+\treturn gen;\n+}\n+\n+/* Free a traffic generator instance. */\n+void\n+rte_gen_destroy(struct rte_gen *gen)\n+{\n+\trte_free(gen);\n+}\ndiff --git a/lib/gen/rte_gen.h b/lib/gen/rte_gen.h\nnew file mode 100644\nindex 0000000000..5b30430f9e\n--- /dev/null\n+++ b/lib/gen/rte_gen.h\n@@ -0,0 +1,44 @@\n+/* SPDX-License-Identifier: BSD-3-Clause\n+ * Copyright(c) 2021 Intel Corporation\n+ */\n+\n+#ifndef _RTE_GEN_H_\n+#define _RTE_GEN_H_\n+\n+/**\n+ * @file\n+ * RTE gen\n+ *\n+ * A library for the generation of packets, to allow easy generation\n+ * of various flows of packets.\n+ */\n+\n+#include <stdint.h>\n+#include <rte_compat.h>\n+\n+#ifdef __cplusplus\n+extern \"C\" {\n+#endif\n+\n+\n+/** Structure that represents a logical traffic generator. */\n+struct rte_gen;\n+\n+/* Forward declarations for DPDK componeents. */\n+struct rte_mempool;\n+\n+/* Allocate and initialize a traffic generator instance. */\n+__rte_experimental\n+struct rte_gen *\n+rte_gen_create(struct rte_mempool *mempool);\n+\n+/* Free a traffic generator instance. */\n+__rte_experimental\n+void\n+rte_gen_destroy(struct rte_gen *gen);\n+\n+#ifdef __cplusplus\n+}\n+#endif\n+\n+#endif /* _RTE_GEN_H_ */\ndiff --git a/lib/gen/version.map b/lib/gen/version.map\nnew file mode 100644\nindex 0000000000..d8a26eb53a\n--- /dev/null\n+++ b/lib/gen/version.map\n@@ -0,0 +1,6 @@\n+EXPERIMENTAL {\n+\tglobal:\n+\n+\trte_gen_create;\n+\trte_gen_destroy;\n+};\ndiff --git a/lib/meson.build b/lib/meson.build\nindex 018976df17..5b28cd3a89 100644\n--- a/lib/meson.build\n+++ b/lib/meson.build\n@@ -35,6 +35,7 @@ libraries = [\n         'efd',\n         'eventdev',\n         'gpudev',\n+        'gen',\n         'gro',\n         'gso',\n         'ip_frag',\n",
    "prefixes": [
        "03/12"
    ]
}