Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/83329/?format=api
{ "id": 83329, "url": "http://patches.dpdk.org/api/patches/83329/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/1604273883-15908-2-git-send-email-timothy.mcdaniel@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": "<1604273883-15908-2-git-send-email-timothy.mcdaniel@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/1604273883-15908-2-git-send-email-timothy.mcdaniel@intel.com", "date": "2020-11-01T23:37:41", "name": "[v11,01/23] event/dlb2: add documentation and meson build infrastructure", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "0e5232bd4e9ff9ebdb4d5cd7ad5015e8c929e01a", "submitter": { "id": 826, "url": "http://patches.dpdk.org/api/people/826/?format=api", "name": "Timothy McDaniel", "email": "timothy.mcdaniel@intel.com" }, "delegate": { "id": 310, "url": "http://patches.dpdk.org/api/users/310/?format=api", "username": "jerin", "first_name": "Jerin", "last_name": "Jacob", "email": "jerinj@marvell.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/1604273883-15908-2-git-send-email-timothy.mcdaniel@intel.com/mbox/", "series": [ { "id": 13541, "url": "http://patches.dpdk.org/api/series/13541/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=13541", "date": "2020-11-01T23:37:40", "name": "Add DLB2 PMD", "version": 11, "mbox": "http://patches.dpdk.org/series/13541/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/83329/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/83329/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 dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 3878CA04E7;\n\tMon, 2 Nov 2020 00:37:43 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 5F3A5378B;\n\tMon, 2 Nov 2020 00:36:26 +0100 (CET)", "from mga04.intel.com (mga04.intel.com [192.55.52.120])\n by dpdk.org (Postfix) with ESMTP id BEBA52BF7\n for <dev@dpdk.org>; Mon, 2 Nov 2020 00:36:21 +0100 (CET)", "from fmsmga004.fm.intel.com ([10.253.24.48])\n by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 01 Nov 2020 15:36:19 -0800", "from txasoft-yocto.an.intel.com ([10.123.72.192])\n by fmsmga004.fm.intel.com with ESMTP; 01 Nov 2020 15:36:18 -0800" ], "IronPort-SDR": [ "\n knBFpNQh3kClm1lN2fZ24Q4OpXFej0gEw6VPxcgs02BOYxMxkXHa3pR0/RhdBT6MMNQwccQgzr\n hKn4R8Xf/1DQ==", "\n AVk2bT0dq3osndyDmWT9qu8RwnO9O9lRjMt7gEB9/2afkh4bTcJKk/EBazNd0KwTBAumpEDetM\n QjT/rUpiWSfw==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9792\"; a=\"166225663\"", "E=Sophos;i=\"5.77,443,1596524400\"; d=\"scan'208\";a=\"166225663\"", "E=Sophos;i=\"5.77,443,1596524400\"; d=\"scan'208\";a=\"352550027\"" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "From": "Timothy McDaniel <timothy.mcdaniel@intel.com>", "To": "Thomas Monjalon <thomas@monjalon.net>,\n Bruce Richardson <bruce.richardson@intel.com>,\n Ray Kinsella <mdr@ashroe.eu>, Neil Horman <nhorman@tuxdriver.com>", "Cc": "dev@dpdk.org, erik.g.carrillo@intel.com, gage.eads@intel.com,\n harry.van.haaren@intel.com, jerinj@marvell.com", "Date": "Sun, 1 Nov 2020 17:37:41 -0600", "Message-Id": "<1604273883-15908-2-git-send-email-timothy.mcdaniel@intel.com>", "X-Mailer": "git-send-email 1.7.10", "In-Reply-To": "<1604273883-15908-1-git-send-email-timothy.mcdaniel@intel.com>", "References": "<1602958879-8558-2-git-send-email-timothy.mcdaniel@intel.com>\n <1604273883-15908-1-git-send-email-timothy.mcdaniel@intel.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=UTF-8", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] =?utf-8?q?=5BPATCH_v11_01/23=5D_event/dlb2=3A_add_docume?=\n\t=?utf-8?q?ntation_and_meson_build_infrastructure?=", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.15", "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", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Adds the meson build infrastructure, which includes\ncompile-time constants in rte_config.h. DLB2 is\nonly supported on Linux 64 bit X86 platforms at this time.\n\nAdds announcement of availability for the new driver\nfor Intel Dynamic Load Balancer 2.0 hardware.\n\nSigned-off-by: Timothy McDaniel <timothy.mcdaniel@intel.com>\nReviewed-by: Gage Eads <gage.eads@intel.com>\n---\n MAINTAINERS | 5 +++++\n config/rte_config.h | 7 ++++++\n doc/guides/eventdevs/dlb2.rst | 40 ++++++++++++++++++++++++++++++++++\n doc/guides/eventdevs/index.rst | 1 +\n doc/guides/rel_notes/release_20_11.rst | 5 +++++\n drivers/event/dlb2/meson.build | 15 +++++++++++++\n drivers/event/dlb2/version.map | 3 +++\n drivers/event/meson.build | 3 ++-\n 8 files changed, 78 insertions(+), 1 deletion(-)\n create mode 100644 doc/guides/eventdevs/dlb2.rst\n create mode 100644 drivers/event/dlb2/meson.build\n create mode 100644 drivers/event/dlb2/version.map", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 5b390d1..c67fa74 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -1176,6 +1176,11 @@ Cavium OCTEON TX timvf\n M: Pavan Nikhilesh <pbhagavatula@marvell.com>\n F: drivers/event/octeontx/timvf_*\n \n+Intel DLB2\n+M: Timothy McDaniel <timothy.mcdaniel@intel.com>\n+F: drivers/event/dlb2/\n+F: doc/guides/eventdevs/dlb2.rst\n+\n Marvell OCTEON TX2\n M: Pavan Nikhilesh <pbhagavatula@marvell.com>\n M: Jerin Jacob <jerinj@marvell.com>\ndiff --git a/config/rte_config.h b/config/rte_config.h\nindex b78c6aa..64aa333 100644\n--- a/config/rte_config.h\n+++ b/config/rte_config.h\n@@ -135,4 +135,11 @@\n /* QEDE PMD defines */\n #define RTE_LIBRTE_QEDE_FW \"\"\n \n+/* DLB2 defines */\n+#define RTE_LIBRTE_PMD_DLB2_POLL_INTERVAL 1000\n+#define RTE_LIBRTE_PMD_DLB2_UMWAIT_CTL_STATE 0\n+#undef RTE_LIBRTE_PMD_DLB2_QUELL_STATS\n+#define RTE_LIBRTE_PMD_DLB2_SW_CREDIT_QUANTA 32\n+#define RTE_PMD_DLB2_DEFAULT_DEPTH_THRESH 256\n+\n #endif /* _RTE_CONFIG_H_ */\ndiff --git a/doc/guides/eventdevs/dlb2.rst b/doc/guides/eventdevs/dlb2.rst\nnew file mode 100644\nindex 0000000..e3091c9\n--- /dev/null\n+++ b/doc/guides/eventdevs/dlb2.rst\n@@ -0,0 +1,40 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2020 Intel Corporation.\n+\n+Driver for the Intel® Dynamic Load Balancer (DLB2)\n+==================================================\n+\n+The DPDK dlb poll mode driver supports the Intel® Dynamic Load Balancer.\n+\n+Prerequisites\n+-------------\n+\n+Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup\n+the basic DPDK environment.\n+\n+Configuration\n+-------------\n+\n+The DLB2 PF PMD is a user-space PMD that uses VFIO to gain direct\n+device access. To use this operation mode, the PCIe PF device must be bound\n+to a DPDK-compatible VFIO driver, such as vfio-pci.\n+\n+Eventdev API Notes\n+------------------\n+\n+The DLB2 provides the functions of a DPDK event device; specifically, it\n+supports atomic, ordered, and parallel scheduling events from queues to ports.\n+However, the DLB2 hardware is not a perfect match to the eventdev API. Some DLB2\n+features are abstracted by the PMD such as directed ports.\n+\n+In general the dlb PMD is designed for ease-of-use and does not require a\n+detailed understanding of the hardware, but these details are important when\n+writing high-performance code. This section describes the places where the\n+eventdev API and DLB2 misalign.\n+\n+Flow ID\n+~~~~~~~\n+\n+The flow ID field is preserved in the event when it is scheduled in the\n+DLB2.\n+\ndiff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst\nindex bb66a5e..738788d 100644\n--- a/doc/guides/eventdevs/index.rst\n+++ b/doc/guides/eventdevs/index.rst\n@@ -11,6 +11,7 @@ application through the eventdev API.\n :maxdepth: 2\n :numbered:\n \n+ dlb2\n dpaa\n dpaa2\n dsw\ndiff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst\nindex 88b9086..e1b9cc1 100644\n--- a/doc/guides/rel_notes/release_20_11.rst\n+++ b/doc/guides/rel_notes/release_20_11.rst\n@@ -295,6 +295,11 @@ New Features\n Added performance tuning arguments to allow tuning the scheduler for\n better throughtput in high core count use cases.\n \n+* **Added a new driver for the Intel Dynamic Load Balancer v2.0 device.**\n+\n+ Added the new ``dlb2`` eventdev driver for the Intel DLB V2.0 device. See the\n+ :doc:`../eventdevs/dlb2` eventdev guide for more details on this new driver.\n+\n * **Updated ioat rawdev driver**\n \n The ioat rawdev driver has been updated and enhanced. Changes include:\ndiff --git a/drivers/event/dlb2/meson.build b/drivers/event/dlb2/meson.build\nnew file mode 100644\nindex 0000000..68cb0ae\n--- /dev/null\n+++ b/drivers/event/dlb2/meson.build\n@@ -0,0 +1,15 @@\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright(c) 2019-2020 Intel Corporation\n+\n+if not is_linux or not dpdk_conf.has('RTE_ARCH_X86_64')\n+ build = false\n+ reason = 'only supported on ARCH_X86_64 Linux'\n+ subdir_done()\n+endif\n+\n+sources = files(\n+)\n+\n+headers = files()\n+\n+deps += ['mbuf', 'mempool', 'ring', 'pci', 'bus_pci']\ndiff --git a/drivers/event/dlb2/version.map b/drivers/event/dlb2/version.map\nnew file mode 100644\nindex 0000000..4a76d1d\n--- /dev/null\n+++ b/drivers/event/dlb2/version.map\n@@ -0,0 +1,3 @@\n+DPDK_21 {\n+\tlocal: *;\n+};\ndiff --git a/drivers/event/meson.build b/drivers/event/meson.build\nindex a7dac99..c433c10 100644\n--- a/drivers/event/meson.build\n+++ b/drivers/event/meson.build\n@@ -5,7 +5,8 @@ if is_windows\n \tsubdir_done()\n endif\n \n-drivers = ['dpaa', 'dpaa2', 'octeontx2', 'opdl', 'skeleton', 'sw', 'dsw']\n+drivers = ['dlb2', 'dpaa', 'dpaa2', 'octeontx2', 'opdl', 'skeleton', 'sw',\n+\t 'dsw']\n if not (toolchain == 'gcc' and cc.version().version_compare('<4.8.6') and\n \tdpdk_conf.has('RTE_ARCH_ARM64'))\n \tdrivers += 'octeontx'\n", "prefixes": [ "v11", "01/23" ] }