get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/114513/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 114513,
    "url": "http://patches.dpdk.org/api/patches/114513/?format=api",
    "web_url": "http://patches.dpdk.org/project/dts/patch/20220802055744.1098629-1-weix.ling@intel.com/",
    "project": {
        "id": 3,
        "url": "http://patches.dpdk.org/api/projects/3/?format=api",
        "name": "DTS",
        "link_name": "dts",
        "list_id": "dts.dpdk.org",
        "list_email": "dts@dpdk.org",
        "web_url": "",
        "scm_url": "git://dpdk.org/tools/dts",
        "webscm_url": "http://git.dpdk.org/tools/dts/",
        "list_archive_url": "https://inbox.dpdk.org/dts",
        "list_archive_url_format": "https://inbox.dpdk.org/dts/{}",
        "commit_url_format": ""
    },
    "msgid": "<20220802055744.1098629-1-weix.ling@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dts/20220802055744.1098629-1-weix.ling@intel.com",
    "date": "2022-08-02T05:57:44",
    "name": "[V2,1/2] test_plans/vhost_virtio_user_interrupt_cbdma_test_plan: modify testplan to test virtio dequeue",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "eca71a1c072a10b3771b40e2c96cd16f8ed9a4aa",
    "submitter": {
        "id": 1828,
        "url": "http://patches.dpdk.org/api/people/1828/?format=api",
        "name": "Ling, WeiX",
        "email": "weix.ling@intel.com"
    },
    "delegate": null,
    "mbox": "http://patches.dpdk.org/project/dts/patch/20220802055744.1098629-1-weix.ling@intel.com/mbox/",
    "series": [
        {
            "id": 24163,
            "url": "http://patches.dpdk.org/api/series/24163/?format=api",
            "web_url": "http://patches.dpdk.org/project/dts/list/?series=24163",
            "date": "2022-08-02T05:57:36",
            "name": "modify vhost_virtio_user_interrupt_cbdma to test virito dequeue",
            "version": 2,
            "mbox": "http://patches.dpdk.org/series/24163/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/114513/comments/",
    "check": "pending",
    "checks": "http://patches.dpdk.org/api/patches/114513/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dts-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id E0B4BA0543;\n\tTue,  2 Aug 2022 08:03:22 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id D9F3740156;\n\tTue,  2 Aug 2022 08:03:22 +0200 (CEST)",
            "from mga11.intel.com (mga11.intel.com [192.55.52.93])\n by mails.dpdk.org (Postfix) with ESMTP id 1ACF7400D7\n for <dts@dpdk.org>; Tue,  2 Aug 2022 08:03:20 +0200 (CEST)",
            "from orsmga003.jf.intel.com ([10.7.209.27])\n by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 01 Aug 2022 23:03:19 -0700",
            "from unknown (HELO localhost.localdomain) ([10.239.252.222])\n by orsmga003-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 01 Aug 2022 23:03:13 -0700"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1659420201; x=1690956201;\n h=from:to:cc:subject:date:message-id:mime-version:\n content-transfer-encoding;\n bh=PNDIyT2pvbWbgQiWG2wc2YRDSJ8R+mP4E8MadmearB0=;\n b=BYnm70HGf/mIogCEpIOrhdOqxrQWh6unKop3oYDhNldBqwhAVifWNgD2\n Z5bSdX/742aITjs0Jvctcl0NQFoBsl8w1N85xAFdVPkGCU94uVQro6clO\n rbNeV2q4ald5gqwa5ClvoLC/z+OG+y10sbAgFLYgZuPjO4K08zmPLlDY1\n eHq2f6KK93lIISp5eyKNqL2yK4QfMY66MVs+iKXGjbR+oP9KWRUsv0cgS\n FC7FC581KeAcQwuYeU4H2f6sO7I1EVXfyDMhg4o9dYrYjjdPY3J1KLDjY\n EvvSN0p8p7sOIOUgfCeY0n+esc0TU4aq5ceDEMlYc2bAVUr4iqvethC8R A==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6400,9594,10426\"; a=\"286888721\"",
            "E=Sophos;i=\"5.93,210,1654585200\";\n d=\"scan'208,223\";a=\"286888721\"",
            "E=Sophos;i=\"5.93,210,1654585200\";\n d=\"scan'208,223\";a=\"552797341\""
        ],
        "From": "Wei Ling <weix.ling@intel.com>",
        "To": "dts@dpdk.org",
        "Cc": "Wei Ling <weix.ling@intel.com>",
        "Subject": "[dts][PATCH V2 1/2]\n test_plans/vhost_virtio_user_interrupt_cbdma_test_plan: modify testplan to\n test virtio dequeue",
        "Date": "Tue,  2 Aug 2022 01:57:44 -0400",
        "Message-Id": "<20220802055744.1098629-1-weix.ling@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "X-BeenThere": "dts@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "test suite reviews and discussions <dts.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dts>,\n <mailto:dts-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dts/>",
        "List-Post": "<mailto:dts@dpdk.org>",
        "List-Help": "<mailto:dts-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dts>,\n <mailto:dts-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dts-bounces@dpdk.org"
    },
    "content": "From DPDK-22.07, virtio support async dequeue for split and packed ring\npath, so modify virtio_user_interrupt_cbdma testplan to test the split \nand packed ring async dequeue feature.\n\nSigned-off-by: Wei Ling <weix.ling@intel.com>\n---\n ..._virtio_user_interrupt_cbdma_test_plan.rst | 119 ++++++++++++++----\n 1 file changed, 98 insertions(+), 21 deletions(-)",
    "diff": "diff --git a/test_plans/vhost_virtio_user_interrupt_cbdma_test_plan.rst b/test_plans/vhost_virtio_user_interrupt_cbdma_test_plan.rst\nindex c823f98e..32c3fda5 100644\n--- a/test_plans/vhost_virtio_user_interrupt_cbdma_test_plan.rst\n+++ b/test_plans/vhost_virtio_user_interrupt_cbdma_test_plan.rst\n@@ -1,23 +1,94 @@\n .. SPDX-License-Identifier: BSD-3-Clause\n    Copyright(c) 2022 Intel Corporation\n \n+   Redistribution and use in source and binary forms, with or without\n+   modification, are permitted provided that the following conditions\n+   are met:\n+\n+   - Redistributions of source code must retain the above copyright\n+     notice, this list of conditions and the following disclaimer.\n+\n+   - Redistributions in binary form must reproduce the above copyright\n+     notice, this list of conditions and the following disclaimer in\n+     the documentation and/or other materials provided with the\n+     distribution.\n+\n+   - Neither the name of Intel Corporation nor the names of its\n+     contributors may be used to endorse or promote products derived\n+     from this software without specific prior written permission.\n+\n+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n+   \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\n+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS\n+   FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE\n+   COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,\n+   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n+   (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\n+   SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n+   HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,\n+   STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\n+   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED\n+   OF THE POSSIBILITY OF SUCH DAMAGE.\n+\n =====================================================\n vhost/virtio-user interrupt mode with cbdma test plan\n =====================================================\n \n+Description\n+===========\n+\n Virtio-user interrupt need test with l3fwd-power sample, small packets send from traffic generator\n to virtio side, check virtio-user cores can be wakeup status, and virtio-user cores should be sleep\n-status after stop sending packets from traffic generator when CBDMA enabled.This test plan cover \n-vhost-user as the backend.\n+status after stop sending packets from traffic generator. \n+This test plan tests virtio-user Rx interrupt and LSC interrupt with vhost-user as the backend when cbdma enable.\n+\n+..Note:\n+\n+DPDK local patch that about vhost pmd is needed when testing Vhost asynchronous data path with testpmd.\n+\n+Prerequisites\n+=============\n+\n+Software\n+--------\n+    Trex:http://trex-tgn.cisco.com/trex/release/v2.26.tar.gz\n+\n+General set up\n+--------------\n+1. Compile DPDK::\n+\n+    # CC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib -Dexamples=all --default-library=static <dpdk build dir>\n+    # ninja -C <dpdk build dir> -j 110\n+    For example:\n+    CC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib -Dexamples=all --default-library=static x86_64-native-linuxapp-gcc\n+    ninja -C x86_64-native-linuxapp-gcc -j 110\n \n-Test Case1: LSC event between vhost-user and virtio-user with split ring and cbdma enabled\n-==========================================================================================\n+2. Get the PCI device ID and DMA device ID of DUT, for example, 0000:18:00.0 is PCI device ID, 0000:00:04.0, 0000:00:04.1 is DMA device ID::\n \n-flow: Vhost <--> Virtio\n+    <dpdk dir># ./usertools/dpdk-devbind.py -s\n+\n+    Network devices using kernel driver\n+    ===================================\n+    0000:18:00.0 'Device 159b' if=ens785f0 drv=ice unused=vfio-pci\n+\n+    DMA devices using kernel driver\n+    ===============================\n+    0000:00:04.0 'Sky Lake-E CBDMA Registers 2021' drv=ioatdma unused=vfio-pci\n+    0000:00:04.1 'Sky Lake-E CBDMA Registers 2021' drv=ioatdma unused=vfio-pci\n+\n+Test case\n+=========\n+\n+Test Case1: Split ring LSC event between vhost-user and virtio-user with cbdma enable\n+-------------------------------------------------------------------------------------\n+This case tests the LSC interrupt of split ring virtio-user with vhost-user as the back-end\n+when vhost uses the asynchronous operations with CBDMA channels.\n+Flow: Vhost <--> Virtio\n \n 1. Bind 1 CBDMA channel to vfio-pci driver, then start vhost-user side::\n \n-    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x3000 -n 4 -a 00:04.0 --file-prefix=vhost --vdev 'net_vhost0,iface=vhost-net,queues=1,client=0,dmas=[txq0@00:04.0]' -- -i\n+    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x3000 -n 4 -a 00:04.0 --file-prefix=vhost --vdev 'net_vhost0,iface=vhost-net,queues=1,client=0,dmas=[txq0;rxq0]' \\\n+    -- -i --lcore-dma=[lcore13@0000:00:04.0]\n     testpmd> set fwd mac\n     testpmd> start\n \n@@ -37,20 +108,21 @@ flow: Vhost <--> Virtio\n     testpmd>  show port info 0\n     #it should show \"down\"\n \n-Test Case2: Split ring virtio-user interrupt test with vhost-user as backend and cbdma enabled\n-==============================================================================================\n-\n-flow: TG --> NIC --> Vhost --> Virtio\n+Test Case2: Split ring virtio-user interrupt test with vhost-user as backend and cbdma enable\n+---------------------------------------------------------------------------------------------\n+This case tests Rx interrupt of split ring virtio-user with vhost-user as the back-end when vhost uses the asynchronous operations with CBDMA channels.\n+Flow: TG --> NIC --> Vhost --> Virtio\n \n 1. Bind 1 CBDMA channel and 1 NIC port to vfio-pci, launch testpmd with a virtual vhost device as backend::\n \n-    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x7c -n 4 --vdev 'net_vhost0,iface=vhost-net,queues=1,dmas=[txq0@00:04.0]' -- -i  --rxq=1 --txq=1\n+    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x7c -n 4 --vdev 'net_vhost0,iface=vhost-net,queues=1,dmas=[txq0;rxq0]' \\\n+    -- -i  --rxq=1 --txq=1 --lcore-dma=[lcore3@0000:00:04.0,lcore3@0000:00:04.1]\n     testpmd> start\n \n 2. Start l3fwd-power with a virtio-user device::\n \n     ./x86_64-native-linuxapp-gcc/examples/dpdk-l3fwd-power -c 0xc000 -n 4 --log-level='user1,7' --no-pci --file-prefix=l3fwd-pwd \\\n-    --vdev=virtio_user0,path=./vhost-net -- -p 1 --config=\"(0,0,14)\" --parse-ptype\n+    --vdev=virtio_user0,path=./vhost-net -- -p 1 -P --config=\"(0,0,14)\" --parse-ptype\n \n 3. Send packets with packet generator, check the virtio-user related core can be wakeup status.\n \n@@ -58,14 +130,16 @@ flow: TG --> NIC --> Vhost --> Virtio\n \n 5. Restart sending packets with packet generator, check virtio-user related core change to wakeup status again.\n \n-Test Case3: LSC event between vhost-user and virtio-user with packed ring and cbdma enabled\n-===========================================================================================\n-\n-flow: Vhost <--> Virtio\n+Test Case3: Packed ring LSC event between vhost-user and virtio-user with cbdma enable\n+--------------------------------------------------------------------------------------\n+This case tests the LSC interrupt of packed ring virtio-user with vhost-user as the back-end\n+when vhost uses the asynchronous operations with CBDMA channels.\n+Flow: Vhost <--> Virtio\n \n 1. Bind one cbdma port to vfio-pci driver, then start vhost-user side::\n \n-    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x3000 -n 4 -a 00:04.0 --file-prefix=vhost --vdev 'net_vhost0,iface=vhost-net,queues=1,client=0,dmas=[txq0@00:04.0]' -- -i\n+    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x3000 -n 4 -a 00:04.0 --file-prefix=vhost --vdev 'net_vhost0,iface=vhost-net,queues=1,client=0,dmas=[txq0;rxq0]' \\\n+    -- -i --lcore-dma=[lcore13@0000:00:04.0,lcore13@0000:00:04.1]\n     testpmd> set fwd mac\n     testpmd> start\n \n@@ -85,20 +159,22 @@ flow: Vhost <--> Virtio\n     testpmd>  show port info 0\n     #it should show \"down\"\n \n-Test Case4: Packed ring virtio-user interrupt test with vhost-user as backend and cbdma enabled\n-================================================================================================\n+Test Case4: Packed ring virtio-user interrupt test with vhost-user as backend and cbdma enable\n+----------------------------------------------------------------------------------------------\n+This case tests Rx interrupt of packed ring virtio-user with vhost-user as the back-end when vhost uses the asynchronous operations with CBDMA channels. \n \n flow: TG --> NIC --> Vhost --> Virtio\n \n 1. Bind one cbdma port and one NIC port to vfio-pci, launch testpmd with a virtual vhost device as backend::\n \n-    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x7c -n 4 --vdev 'net_vhost0,iface=vhost-net,queues=1,dmas=[txq0@00:04.0]' -- -i  --rxq=1 --txq=1\n+    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c 0x7c -n 4 --vdev 'net_vhost0,iface=vhost-net,queues=1,dmas=[txq0;rxq0]' \\\n+    -- -i  --rxq=1 --txq=1 --lcore-dma=[lcore3@0000:00:04.0]\n     testpmd> start\n \n 2. Start l3fwd-power with a virtio-user device::\n \n     ./x86_64-native-linuxapp-gcc/examples/dpdk-l3fwd-power -c 0xc000 -n 4 --log-level='user1,7' --no-pci --file-prefix=l3fwd-pwd \\\n-    --vdev=virtio_user0,path=./vhost-net,packed_vq=1 -- -p 1 --config=\"(0,0,14)\" --parse-ptype\n+    --vdev=virtio_user0,path=./vhost-net,packed_vq=1 -- -p 1 -P --config=\"(0,0,14)\" --parse-ptype\n \n 3. Send packets with packet generator, check the virtio-user related core can be wakeup status.\n \n@@ -106,3 +182,4 @@ flow: TG --> NIC --> Vhost --> Virtio\n \n 5. Restart sending packets with packet generator, check virtio-user related core change to wakeup status again.\n \n+\n",
    "prefixes": [
        "V2",
        "1/2"
    ]
}