Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/82805/?format=api
{ "id": 82805, "url": "http://patches.dpdk.org/api/patches/82805/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/1603985122-19888-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": "<1603985122-19888-2-git-send-email-timothy.mcdaniel@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/1603985122-19888-2-git-send-email-timothy.mcdaniel@intel.com", "date": "2020-10-29T15:24:55", "name": "[v4,01/23] event/dlb2: add documentation and meson build infrastructure", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "bc8e19bbda0defe11f74f034e44bfa87350ef0d2", "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/1603985122-19888-2-git-send-email-timothy.mcdaniel@intel.com/mbox/", "series": [ { "id": 13469, "url": "http://patches.dpdk.org/api/series/13469/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=13469", "date": "2020-10-29T15:24:54", "name": "Add DLB2 PMD", "version": 4, "mbox": "http://patches.dpdk.org/series/13469/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/82805/comments/", "check": "fail", "checks": "http://patches.dpdk.org/api/patches/82805/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 DF24FA04B5;\n\tThu, 29 Oct 2020 16:24:02 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id DF794CFBF;\n\tThu, 29 Oct 2020 16:23:46 +0100 (CET)", "from mga06.intel.com (mga06.intel.com [134.134.136.31])\n by dpdk.org (Postfix) with ESMTP id 6BA6FCFA1\n for <dev@dpdk.org>; Thu, 29 Oct 2020 16:23:42 +0100 (CET)", "from fmsmga005.fm.intel.com ([10.253.24.32])\n by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 29 Oct 2020 08:23:40 -0700", "from txasoft-yocto.an.intel.com ([10.123.72.192])\n by fmsmga005.fm.intel.com with ESMTP; 29 Oct 2020 08:23:39 -0700" ], "IronPort-SDR": [ "\n gX2joUHlCHR0jVjUWRCPWJF/54WRrkQQS+jtuWiw1Fn8kjYLGgldJWxjg8op4m8qgv5eHie+j5\n QcS6HQ0Bl5DQ==", "\n rk+wiQeiE2KJUwzIamnYHlDA/jhKo+hd/NfGt2JEc6SxEof1pdwh302G15/3eP8PJA+eM/1Bpq\n qYpl96IDDeNQ==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9788\"; a=\"230089042\"", "E=Sophos;i=\"5.77,430,1596524400\"; d=\"scan'208\";a=\"230089042\"", "E=Sophos;i=\"5.77,430,1596524400\"; d=\"scan'208\";a=\"526769349\"" ], "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": "Thu, 29 Oct 2020 10:24:55 -0500", "Message-Id": "<1603985122-19888-2-git-send-email-timothy.mcdaniel@intel.com>", "X-Mailer": "git-send-email 1.7.10", "In-Reply-To": "<1603985122-19888-1-git-send-email-timothy.mcdaniel@intel.com>", "References": "<1599855987-25976-2-git-send-email-timothy.mcdaniel@intel.com>\n <1603985122-19888-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_v4_01/23=5D_event/dlb2=3A_add_documen?=\n\t=?utf-8?q?tation_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 X86 platforms at this time.\n\nSigned-off-by: Timothy McDaniel <timothy.mcdaniel@intel.com>\nReviewed-by: Gage Eads <gage.eads@intel.com>\n---\n MAINTAINERS | 6 +++++-\n config/rte_config.h | 7 +++++++\n doc/guides/eventdevs/dlb2.rst | 40 ++++++++++++++++++++++++++++++++++++++++\n doc/guides/eventdevs/index.rst | 1 +\n drivers/event/dlb2/meson.build | 13 +++++++++++++\n drivers/event/dlb2/version.map | 3 +++\n drivers/event/meson.build | 3 ++-\n 7 files changed, 71 insertions(+), 2 deletions(-)\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 a3d1927..727451b 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -1162,6 +1162,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>\n@@ -1198,7 +1203,6 @@ M: Peter Mccarthy <peter.mccarthy@intel.com>\n F: drivers/event/opdl/\n F: doc/guides/eventdevs/opdl.rst\n \n-\n Rawdev Drivers\n --------------\n \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/drivers/event/dlb2/meson.build b/drivers/event/dlb2/meson.build\nnew file mode 100644\nindex 0000000..5324043\n--- /dev/null\n+++ b/drivers/event/dlb2/meson.build\n@@ -0,0 +1,13 @@\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+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": [ "v4", "01/23" ] }