Show a patch.

GET /api/patches/44565/
Content-Type: application/json
Vary: Accept

    "id": 44565,
    "url": "",
    "web_url": "",
    "project": {
        "id": 1,
        "url": "",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "",
        "list_email": "",
        "web_url": "",
        "scm_url": "git://",
        "webscm_url": ""
    "msgid": "<>",
    "date": "2018-09-11T08:02:16",
    "name": "[v3,10/10] event/dsw: include DSW event device documentation",
    "commit_ref": null,
    "pull_url": null,
    "state": "changes-requested",
    "archived": true,
    "hash": "9fc949e41e6ace7000c8053351999efc29c7df61",
    "submitter": {
        "id": 1077,
        "url": "",
        "name": "Mattias Rönnblom",
        "email": ""
    "delegate": {
        "id": 310,
        "url": "",
        "username": "jerin",
        "first_name": "Jerin",
        "last_name": "Jacob",
        "email": ""
    "mbox": "",
    "series": [
            "id": 1264,
            "url": "",
            "web_url": "",
            "date": "2018-09-11T08:02:07",
            "name": "A Distributed Software Event Device",
            "version": 3,
            "mbox": ""
    "comments": "",
    "check": "success",
    "checks": "",
    "tags": {},
    "headers": {
        "X-Mailman-Version": "2.1.15",
        "Precedence": "list",
        "In-Reply-To": "<>",
        "Errors-To": "",
        "X-Mailer": "git-send-email 2.17.1",
        "Received": [
            "from [] (localhost [])\n\tby (Postfix) with ESMTP id 9FA195B3A;\n\tTue, 11 Sep 2018 10:03:30 +0200 (CEST)",
            "from ( [])\n\tby (Postfix) with ESMTP id DB1414C94\n\tfor <>; Tue, 11 Sep 2018 10:03:19 +0200 (CEST)",
            "from (localhost [])\n\tby (Postfix) with ESMTP id 9A0284007C\n\tfor <>; Tue, 11 Sep 2018 10:03:19 +0200 (CEST)",
            "by (Postfix, from userid 1004)\n\tid 85F1C40012; Tue, 11 Sep 2018 10:03:19 +0200 (CEST)",
            "from\n\t( [])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256\n\tbits)) (No client certificate requested)\n\tby (Postfix) with ESMTPSA id 0C99C40086;\n\tTue, 11 Sep 2018 10:03:14 +0200 (CEST)"
        "References": "<>",
        "List-Id": "DPDK patches and discussions <>",
        "MIME-Version": "1.0",
        "Message-Id": "<>",
        "X-Virus-Scanned": "ClamAV using ClamSMTP",
        "Delivered-To": "",
        "Content-Transfer-Encoding": "8bit",
        "From": "=?utf-8?q?Mattias_R=C3=B6nnblom?= <>",
        "X-Original-To": "",
        "Content-Type": "text/plain; charset=UTF-8",
        "List-Post": "<>",
        "Return-Path": "<>",
        "Sender": "\"dev\" <>",
        "List-Help": "<>",
        "List-Subscribe": "<>,\n\t<>",
        "To": "",
        "List-Archive": "<>",
        "X-Spam-Status": "No, score=-0.9 required=5.0 tests=ALL_TRUSTED,AWL\n\tautolearn=disabled version=3.4.1",
        "X-Spam-Level": "",
        "List-Unsubscribe": "<>,\n\t<>",
        "X-Spam-Checker-Version": "SpamAssassin 3.4.1 (2015-04-28) on\n\",
        "X-BeenThere": "",
        "Date": "Tue, 11 Sep 2018 10:02:16 +0200",
        "Cc": ",, =?utf-8?q?Mattias_R=C3=B6nnb?=\n\t=?utf-8?q?lom?= <>",
        "X-Spam-Score": "-0.9",
        "Subject": "[dpdk-dev] [PATCH v3 10/10] event/dsw: include DSW event device\n\tdocumentation"
    "content": "The DSW event device is documented in DPDK Programmer's Guide.\n\nSigned-off-by: Mattias Rönnblom <>\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": [