Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/44046/?format=api
http://patchwork.dpdk.org/api/patches/44046/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20180830142719.28569-11-mattias.ronnblom@ericsson.com/", "project": { "id": 1, "url": "http://patchwork.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": "<20180830142719.28569-11-mattias.ronnblom@ericsson.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20180830142719.28569-11-mattias.ronnblom@ericsson.com", "date": "2018-08-30T14:27:19", "name": "[10/10] eventdev: include DSW event device documentation", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "9fc949e41e6ace7000c8053351999efc29c7df61", "submitter": { "id": 1077, "url": "http://patchwork.dpdk.org/api/people/1077/?format=api", "name": "Mattias Rönnblom", "email": "mattias.ronnblom@ericsson.com" }, "delegate": { "id": 310, "url": "http://patchwork.dpdk.org/api/users/310/?format=api", "username": "jerin", "first_name": "Jerin", "last_name": "Jacob", "email": "jerinj@marvell.com" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20180830142719.28569-11-mattias.ronnblom@ericsson.com/mbox/", "series": [ { "id": 1116, "url": "http://patchwork.dpdk.org/api/series/1116/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=1116", "date": "2018-08-30T14:27:11", "name": "Add the Distributed Software Event Device", "version": 1, "mbox": "http://patchwork.dpdk.org/series/1116/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/44046/comments/", "check": "success", "checks": "http://patchwork.dpdk.org/api/patches/44046/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 C4BA85B16;\n\tThu, 30 Aug 2018 16:27:45 +0200 (CEST)", "from mail.lysator.liu.se (mail.lysator.liu.se [130.236.254.3])\n\tby dpdk.org (Postfix) with ESMTP id BE95C4CAD\n\tfor <dev@dpdk.org>; Thu, 30 Aug 2018 16:27:33 +0200 (CEST)", "from mail.lysator.liu.se (localhost [127.0.0.1])\n\tby mail.lysator.liu.se (Postfix) with ESMTP id 779F14002C\n\tfor <dev@dpdk.org>; Thu, 30 Aug 2018 16:27:33 +0200 (CEST)", "by mail.lysator.liu.se (Postfix, from userid 1004)\n\tid 6B50140022; Thu, 30 Aug 2018 16:27:33 +0200 (CEST)", "from isengard.friendlyfire.se\n\t(host-90-232-156-190.mobileonline.telia.com [90.232.156.190])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256\n\tbits)) (No client certificate requested)\n\tby mail.lysator.liu.se (Postfix) with ESMTPSA id 9C2824001B;\n\tThu, 30 Aug 2018 16:27:28 +0200 (CEST)" ], "X-Spam-Checker-Version": "SpamAssassin 3.4.1 (2015-04-28) on\n\tbernadotte.lysator.liu.se", "X-Spam-Level": "", "X-Spam-Status": "No, score=-0.9 required=5.0 tests=ALL_TRUSTED,AWL\n\tautolearn=disabled version=3.4.1", "X-Spam-Score": "-0.9", "From": "=?utf-8?q?Mattias_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "To": "jerin.jacob@caviumnetworks.com", "Cc": "bruce.richardson@intel.com, dev@dpdk.org, =?utf-8?q?Mattias_R=C3=B6nnb?=\n\t=?utf-8?q?lom?= <mattias.ronnblom@ericsson.com>", "Date": "Thu, 30 Aug 2018 16:27:19 +0200", "Message-Id": "<20180830142719.28569-11-mattias.ronnblom@ericsson.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": "<20180830142719.28569-1-mattias.ronnblom@ericsson.com>", "References": "<20180830142719.28569-1-mattias.ronnblom@ericsson.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=UTF-8", "Content-Transfer-Encoding": "8bit", "X-Virus-Scanned": "ClamAV using ClamSMTP", "Subject": "[dpdk-dev] [PATCH 10/10] eventdev: 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\nSigned-off-by: Mattias Rönnblom <mattias.ronnblom@ericsson.com>\n---\n doc/guides/eventdevs/dsw.rst | 97 ++++++++++++++++++++++++++++++++++\n doc/guides/eventdevs/index.rst | 1 +\n 2 files changed, 98 insertions(+)\n create mode 100644 doc/guides/eventdevs/dsw.rst", "diff": "diff --git a/doc/guides/eventdevs/dsw.rst b/doc/guides/eventdevs/dsw.rst\nnew file mode 100644\nindex 000000000..de41ae9d3\n--- /dev/null\n+++ b/doc/guides/eventdevs/dsw.rst\n@@ -0,0 +1,97 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2017 Intel Corporation.\n+ Copyright(c) 2018 Ericsson AB\n+\n+Distributed Software Eventdev Poll Mode Driver\n+==============================================\n+\n+The distributed software eventdev is a parallel implementation of the\n+eventdev API, which distributes the task of scheduling events among\n+all the eventdev ports 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\n", "prefixes": [ "10/10" ] }{ "id": 44046, "url": "