Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/83094/?format=api
{ "id": 83094, "url": "http://patches.dpdk.org/api/patches/83094/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/1604107175-25423-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": "<1604107175-25423-2-git-send-email-timothy.mcdaniel@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/1604107175-25423-2-git-send-email-timothy.mcdaniel@intel.com", "date": "2020-10-31T01:19:13", "name": "[v12,01/23] event/dlb: add documentation and meson infrastructure", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "33bbd4379302f0920069d54088992b369d301f94", "submitter": { "id": 826, "url": "http://patches.dpdk.org/api/people/826/?format=api", "name": "Timothy McDaniel", "email": "timothy.mcdaniel@intel.com" }, "delegate": null, "mbox": "http://patches.dpdk.org/project/dpdk/patch/1604107175-25423-2-git-send-email-timothy.mcdaniel@intel.com/mbox/", "series": [ { "id": 13515, "url": "http://patches.dpdk.org/api/series/13515/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=13515", "date": "2020-10-31T01:19:12", "name": "Add DLB PMD", "version": 12, "mbox": "http://patches.dpdk.org/series/13515/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/83094/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/83094/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 912F0A04E6;\n\tSat, 31 Oct 2020 02:18:36 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 1BD18C8CC;\n\tSat, 31 Oct 2020 02:17:59 +0100 (CET)", "from mga17.intel.com (mga17.intel.com [192.55.52.151])\n by dpdk.org (Postfix) with ESMTP id CA7DFC86C\n for <dev@dpdk.org>; Sat, 31 Oct 2020 02:17:52 +0100 (CET)", "from fmsmga005.fm.intel.com ([10.253.24.32])\n by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 30 Oct 2020 18:17:50 -0700", "from txasoft-yocto.an.intel.com ([10.123.72.192])\n by fmsmga005.fm.intel.com with ESMTP; 30 Oct 2020 18:17:50 -0700" ], "IronPort-SDR": [ "\n DN68tgxjTVPHPSgoJncmcUzSrstOziSUnducaGySaxOpJSup8P191p5BS38psJcl52oZxy25Yi\n GCwbOpwaADNg==", "\n aq91iiC3FIxrgfTo7CZ9s5b+xliFsi1q/XG0xEwaMs2ROqcysJsLyNL/5rB8zb7nwmNn34E6cW\n RksmJji2vIxQ==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9790\"; a=\"148542945\"", "E=Sophos;i=\"5.77,435,1596524400\"; d=\"scan'208\";a=\"148542945\"", "E=Sophos;i=\"5.77,435,1596524400\"; d=\"scan'208\";a=\"527300663\"" ], "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": "Fri, 30 Oct 2020 20:19:13 -0500", "Message-Id": "<1604107175-25423-2-git-send-email-timothy.mcdaniel@intel.com>", "X-Mailer": "git-send-email 1.7.10", "In-Reply-To": "<1604107175-25423-1-git-send-email-timothy.mcdaniel@intel.com>", "References": "<20200612212434.6852-2-timothy.mcdaniel@intel.com>\n <1604107175-25423-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_v12_01/23=5D_event/dlb=3A_add_documen?=\n\t=?utf-8?q?tation_and_meson_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": "Note that config/rte_config.h contains several configuration\nswitches, providing for fine control of the PMD's\nruntime behaviour.\n\nThe meson infrastructure is expanded as additional files are\nadded to this patchset.\n\nAdds announcement of availabililty of the new driver\nfor Intel Dynamic Load Balancer 1.0 hardware.\n\nSigned-off-by: Timothy McDaniel <timothy.mcdaniel@intel.com>\n---\n MAINTAINERS | 6 +++++-\n config/rte_config.h | 6 ++++++\n doc/guides/eventdevs/dlb.rst | 36 ++++++++++++++++++++++++++++++++++\n doc/guides/eventdevs/index.rst | 1 +\n doc/guides/rel_notes/release_20_11.rst | 5 +++++\n drivers/event/dlb/meson.build | 13 ++++++++++++\n drivers/event/dlb/version.map | 3 +++\n drivers/event/meson.build | 2 +-\n 8 files changed, 70 insertions(+), 2 deletions(-)\n create mode 100644 doc/guides/eventdevs/dlb.rst\n create mode 100644 drivers/event/dlb/meson.build\n create mode 100644 drivers/event/dlb/version.map", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex a3d1927..b904132 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 DLB\n+M: Timothy McDaniel <timothy.mcdaniel@intel.com>\n+F: drivers/event/dlb/\n+F: doc/guides/eventdevs/dlb.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..9ebe4cc 100644\n--- a/config/rte_config.h\n+++ b/config/rte_config.h\n@@ -135,4 +135,10 @@\n /* QEDE PMD defines */\n #define RTE_LIBRTE_QEDE_FW \"\"\n \n+/* DLB PMD defines */\n+#define RTE_LIBRTE_PMD_DLB_POLL_INTERVAL 1000\n+#define RTE_LIBRTE_PMD_DLB_UMWAIT_CTL_STATE 0\n+#undef RTE_LIBRTE_PMD_DLB_QUELL_STATS\n+#define RTE_LIBRTE_PMD_DLB_SW_CREDIT_QUANTA 32\n+\n #endif /* _RTE_CONFIG_H_ */\ndiff --git a/doc/guides/eventdevs/dlb.rst b/doc/guides/eventdevs/dlb.rst\nnew file mode 100644\nindex 0000000..92341c0\n--- /dev/null\n+++ b/doc/guides/eventdevs/dlb.rst\n@@ -0,0 +1,36 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2020 Intel Corporation.\n+\n+Driver for the Intel® Dynamic Load Balancer (DLB)\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 DLB 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 DLB 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 DLB hardware is not a perfect match to the eventdev API. Some DLB\n+features are abstracted by the PMD (e.g. directed ports), some are only\n+accessible as vdev command-line parameters, and certain eventdev features are\n+not supported (e.g. the event flow ID is not maintained during scheduling).\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 DLB misalign.\n+\ndiff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst\nindex bb66a5e..4b915bf 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+ dlb\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 d8ac359..0a95bf0 100644\n--- a/doc/guides/rel_notes/release_20_11.rst\n+++ b/doc/guides/rel_notes/release_20_11.rst\n@@ -55,6 +55,11 @@ New Features\n Also, make sure to start the actual text at the margin.\n =======================================================\n \n+* **Added a new driver for the Intel Dynamic Load Balancer v1.0 device.**\n+\n+ Added the new ``dlb`` eventdev driver for the Intel DLB V1.0 device. See the\n+ :doc:`../eventdevs/dlb` eventdev guide for more details on this new driver.\n+\n * **Added write combining store APIs.**\n \n Added ``rte_write32_wc`` and ``rte_write32_wc_relaxed`` APIs\ndiff --git a/drivers/event/dlb/meson.build b/drivers/event/dlb/meson.build\nnew file mode 100644\nindex 0000000..5324043\n--- /dev/null\n+++ b/drivers/event/dlb/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/dlb/version.map b/drivers/event/dlb/version.map\nnew file mode 100644\nindex 0000000..4a76d1d\n--- /dev/null\n+++ b/drivers/event/dlb/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..6601e62 100644\n--- a/drivers/event/meson.build\n+++ b/drivers/event/meson.build\n@@ -5,7 +5,7 @@ if is_windows\n \tsubdir_done()\n endif\n \n-drivers = ['dpaa', 'dpaa2', 'octeontx2', 'opdl', 'skeleton', 'sw', 'dsw']\n+drivers = ['dlb', 'dpaa', 'dpaa2', 'octeontx2', 'opdl', 'skeleton', 'sw', '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": [ "v12", "01/23" ] }