Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/44837/?format=api
{ "id": 44837, "url": "http://patches.dpdk.org/api/patches/44837/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20180918124514.10615-11-mattias.ronnblom@ericsson.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": "<20180918124514.10615-11-mattias.ronnblom@ericsson.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20180918124514.10615-11-mattias.ronnblom@ericsson.com", "date": "2018-09-18T12:45:14", "name": "[v4,10/10] event/dsw: include DSW event device documentation", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "356a51506785b005a432ecc925cb94b3f2b48261", "submitter": { "id": 1077, "url": "http://patches.dpdk.org/api/people/1077/?format=api", "name": "Mattias Rönnblom", "email": "mattias.ronnblom@ericsson.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/20180918124514.10615-11-mattias.ronnblom@ericsson.com/mbox/", "series": [ { "id": 1368, "url": "http://patches.dpdk.org/api/series/1368/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=1368", "date": "2018-09-18T12:45:04", "name": "A Distributed Software Event Device", "version": 4, "mbox": "http://patches.dpdk.org/series/1368/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/44837/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/44837/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@dpdk.org", "Delivered-To": "patchwork@dpdk.org", "Received": [ "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id D2DD45B3E;\n\tTue, 18 Sep 2018 14:45:43 +0200 (CEST)", "from sessmg22.ericsson.net (sessmg22.ericsson.net [193.180.251.58])\n\tby dpdk.org (Postfix) with ESMTP id DFE824F9C\n\tfor <dev@dpdk.org>; Tue, 18 Sep 2018 14:45:30 +0200 (CEST)", "from ESESSMB501.ericsson.se (Unknown_Domain [153.88.183.119])\n\tby sessmg22.ericsson.net (Symantec Mail Security) with SMTP id\n\tF3.EF.12695.A63F0AB5; Tue, 18 Sep 2018 14:45:30 +0200 (CEST)", "from ESESBMR504.ericsson.se (153.88.183.139) by\n\tESESSMB501.ericsson.se (153.88.183.189) with Microsoft SMTP Server\n\t(version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id\n\t15.1.1466.3; Tue, 18 Sep 2018 14:45:27 +0200", "from ESESBMB504.ericsson.se (153.88.183.171) by\n\tESESBMR504.ericsson.se (153.88.183.139) with Microsoft SMTP Server\n\t(version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id\n\t15.1.1466.3; Tue, 18 Sep 2018 14:45:27 +0200", "from selio1a020.lmera.ericsson.se (153.88.183.153) by\n\tsmtp.internal.ericsson.com (153.88.183.187) with Microsoft SMTP\n\tServer id\n\t15.1.1466.3 via Frontend Transport; Tue, 18 Sep 2018 14:45:27 +0200", "from breslau.lmera.ericsson.se (breslau.lmera.ericsson.se\n\t[150.132.109.241])\n\tby selio1a020.lmera.ericsson.se (8.15.1+Sun/8.15.1) with ESMTP id\n\tw8ICjQ1d011575; Tue, 18 Sep 2018 14:45:28 +0200 (CEST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; d=ericsson.com; s=mailgw201801;\n\tc=relaxed/simple; q=dns/txt; i=@ericsson.com; t=1537274730;\n\th=From:Sender:Reply-To:Subject:Date:Message-ID:To:CC:MIME-Version:Content-Type:\n\tContent-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:Resent-From:\n\tResent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Id:\n\tList-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive;\n\tbh=4URAPjvWaqtzjs5wDUqSNlpuqAGyxG+ufcLw+NVDR1g=;\n\tb=TLv4a+PmkQON12q9gXUlr6fop8/QHm/wf92YfEGpuZq+/pzTKuOjDNP28QOL+4M/\n\tzQPEQPmh5t1JdHcbY6EktAei6QTaP1Fb5DAYMeN/UCoeH2Vw3EqZuX3149hG06RB\n\tZJwPcQ8YY0EbURRlOEXz6AU5b4/0ZI+BIYWJcIATVcY=;", "X-AuditID": "c1b4fb3a-75d969c000003197-9a-5ba0f36acb39", "From": "=?utf-8?q?Mattias_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "To": "Jerin Jacob <jerin.jacob@caviumnetworks.com>", "CC": "Bruce Richardson <bruce.richardson@intel.com>, <dev@dpdk.org>,\n\t=?utf-8?q?Mattias_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "Date": "Tue, 18 Sep 2018 14:45:14 +0200", "Message-ID": "<20180918124514.10615-11-mattias.ronnblom@ericsson.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": "<20180918124514.10615-1-mattias.ronnblom@ericsson.com>", "References": "<20180918124514.10615-1-mattias.ronnblom@ericsson.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"UTF-8\"", "Content-Transfer-Encoding": "8bit", "X-Brightmail-Tracker": "H4sIAAAAAAAAA+NgFnrMLMWRmVeSWpSXmKPExsUyM2J7uW7W5wXRBr+vyFvcWGVv8e7TdiaL\n\tiZNMHJg9NpzoZ/X4tWApq8fiPS+ZApijuGxSUnMyy1KL9O0SuDKefWtkLrioUfF+yRyWBsYj\n\til2MHBwSAiYS19syuxi5OIQEjjJKzD12mAXC+cYoMbX3Lzucs+T4e1YI5yKjxMkLc9ggnMuM\n\tEofunANyODnYBDwlJr/rZgGxRQQMJBaduc8MUsQs0MEo0Tz1D1hCWMBbYvHpN+wgNouAqkTj\n\t899MIDavgLPEhbWzweISAvISqzccYAaxOYHin6euYwI5VkjASeLiBmWIckGJkzOfgI1kFtCU\n\taN3+mx3Clpdo3jobrFVIQEvi/pIvzBMYhWchaZmFpGUWkpYFjMyrGEWLU4uLc9ONjPRSizKT\n\ti4vz8/TyUks2MQKD/uCW31Y7GA8+dzzEKMDBqMTDm/xqQbQQa2JZcWXuIUYJDmYlEV7OHKAQ\n\tb0piZVVqUX58UWlOavEhRmkOFiVxXqc0iyghgfTEktTs1NSC1CKYLBMHp1QDYy1DkIZzYZe1\n\tzjnz5EOnStqu+Pn4vJm55oFhvgjD+oD75wOWz31/RurrtYkX7l490BH+fdrcCuMutqpHD1K5\n\toi6qB2sHrM6qD2kSfuK3I8PuRL6wSHl1ZKOArdJDlXk2yeEPDu07ezJahSfYuotlt0rMNKsV\n\tpwXDzpzMmL6zfdmR68xiBTW/lViKMxINtZiLihMBGV6gynYCAAA=", "Subject": "[dpdk-dev] [PATCH v4 10/10] event/dsw: include DSW event device\n\tdocumentation", "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\t<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\t<mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "The DSW event device is documented in DPDK Programmer's Guide.\n\nThe MAINTAINERS file and the 18.11 release notes are updated.\n\nSigned-off-by: Mattias Rönnblom <mattias.ronnblom@ericsson.com>\n---\n MAINTAINERS | 5 ++\n doc/guides/eventdevs/dsw.rst | 96 ++++++++++++++++++++++++++\n doc/guides/eventdevs/index.rst | 1 +\n doc/guides/rel_notes/release_18_11.rst | 8 +++\n 4 files changed, 110 insertions(+)\n create mode 100644 doc/guides/eventdevs/dsw.rst", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 9fd258fad..cbfa7e106 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -919,6 +919,11 @@ F: doc/guides/eventdevs/sw.rst\n F: examples/eventdev_pipeline/\n F: doc/guides/sample_app_ug/eventdev_pipeline.rst\n \n+Distributed Software Eventdev PMD\n+M: Mattias Rönnblom <mattias.ronnblom@ericsson.com>\n+F: drivers/event/dsw/\n+F: doc/guides/eventdevs/dsw.rst\n+\n Software OPDL Eventdev PMD\n M: Liang Ma <liang.j.ma@intel.com>\n M: Peter Mccarthy <peter.mccarthy@intel.com>\ndiff --git a/doc/guides/eventdevs/dsw.rst b/doc/guides/eventdevs/dsw.rst\nnew file mode 100644\nindex 000000000..6653f501c\n--- /dev/null\n+++ b/doc/guides/eventdevs/dsw.rst\n@@ -0,0 +1,96 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2018 Ericsson AB\n+\n+Distributed Software Eventdev Poll Mode Driver\n+==============================================\n+\n+The distributed software event device is an eventdev driver which\n+distributes the task of scheduling events among all the eventdev ports\n+and the lcore threads using them.\n+\n+Features\n+--------\n+\n+Queues\n+ * Atomic\n+ * Parallel\n+ * Single-Link\n+\n+Ports\n+ * Load balanced (for Atomic, Ordered, Parallel queues)\n+ * Single Link (for single-link queues)\n+\n+Configuration and Options\n+-------------------------\n+\n+The distributed software eventdev is a vdev device, and as such can be\n+created from the application code, or from the EAL command line:\n+\n+* Call ``rte_vdev_init(\"event_dsw0\")`` from the application\n+\n+* Use ``--vdev=\"event_dsw0\"`` in the EAL options, which will call\n+ rte_vdev_init() internally\n+\n+Example:\n+\n+.. code-block:: console\n+\n+ ./your_eventdev_application --vdev=\"event_dsw0\"\n+\n+Limitations\n+-----------\n+\n+Unattended Ports\n+~~~~~~~~~~~~~~~~\n+\n+The distributed software eventdev uses an internal signaling schema\n+between the ports to achieve load balancing. In order for this to\n+work, the application must perform enqueue and/or dequeue operations\n+on all ports.\n+\n+Producer-only ports which currently have no events to enqueue should\n+periodically call rte_event_enqueue_burst() with a zero-sized burst.\n+\n+Ports left unattended for longer periods of time will prevent load\n+balancing, and also cause traffic interruptions on the flows which\n+are in the process of being migrated.\n+\n+Output Buffering\n+~~~~~~~~~~~~~~~~\n+\n+For efficiency reasons, the distributed software eventdev might not\n+send enqueued events immediately to the destination port, but instead\n+store them in an internal buffer in the source port.\n+\n+In case no more events are enqueued on a port with buffered events,\n+these events will be sent after the application has performed a number\n+of enqueue and/or dequeue operations.\n+\n+For explicit flushing, an application may call\n+rte_event_enqueue_burst() with a zero-sized burst.\n+\n+\n+Priorities\n+~~~~~~~~~~\n+\n+The distributed software eventdev does not support event priorities.\n+\n+Ordered Queues\n+~~~~~~~~~~~~~~\n+\n+The distributed software eventdev does not support the ordered queue type.\n+\n+\n+\"All Types\" Queues\n+~~~~~~~~~~~~~~~~~~\n+\n+The distributed software eventdev does not support queues of type\n+RTE_EVENT_QUEUE_CFG_ALL_TYPES, which allow both atomic, ordered, and\n+parallel events on the same queue.\n+\n+Dynamic Link/Unlink\n+~~~~~~~~~~~~~~~~~~~\n+\n+The distributed software eventdev does not support calls to\n+rte_event_port_link() or rte_event_port_unlink() after\n+rte_event_dev_start() has been called.\ndiff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst\nindex 18ec8e462..984eea5f4 100644\n--- a/doc/guides/eventdevs/index.rst\n+++ b/doc/guides/eventdevs/index.rst\n@@ -14,5 +14,6 @@ application trough the eventdev API.\n dpaa\n dpaa2\n sw\n+ dsw\n octeontx\n opdl\ndiff --git a/doc/guides/rel_notes/release_18_11.rst b/doc/guides/rel_notes/release_18_11.rst\nindex 3ae6b3f58..9c6b1fd0b 100644\n--- a/doc/guides/rel_notes/release_18_11.rst\n+++ b/doc/guides/rel_notes/release_18_11.rst\n@@ -54,6 +54,14 @@ New Features\n Also, make sure to start the actual text at the margin.\n =========================================================\n \n+* **Added Distributed Software Eventdev PMD.**\n+\n+ Added the new Distributed Software Event Device (DSW), which is a\n+ pure-software eventdev driver distributing the work of scheduling\n+ among all eventdev ports and the lcores using them. DSW, compared to\n+ the SW eventdev PMD, sacrifices load balancing performance to\n+ gain better event scheduling throughput and scalability.\n+\n \n API Changes\n -----------\n", "prefixes": [ "v4", "10/10" ] }