get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 120325,
    "url": "https://patches.dpdk.org/api/patches/120325/?format=api",
    "web_url": "https://patches.dpdk.org/project/dts/patch/20221130061728.1163892-1-weix.ling@intel.com/",
    "project": {
        "id": 3,
        "url": "https://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": "<20221130061728.1163892-1-weix.ling@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dts/20221130061728.1163892-1-weix.ling@intel.com",
    "date": "2022-11-30T06:17:28",
    "name": "[V2,1/3] test_plans/basic_4k_pages_dsa_test_plan: modify testplan description",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "badd5d240473a35f1ab0360f01b71c7de66064cf",
    "submitter": {
        "id": 1828,
        "url": "https://patches.dpdk.org/api/people/1828/?format=api",
        "name": "Ling, WeiX",
        "email": "weix.ling@intel.com"
    },
    "delegate": null,
    "mbox": "https://patches.dpdk.org/project/dts/patch/20221130061728.1163892-1-weix.ling@intel.com/mbox/",
    "series": [
        {
            "id": 25941,
            "url": "https://patches.dpdk.org/api/series/25941/?format=api",
            "web_url": "https://patches.dpdk.org/project/dts/list/?series=25941",
            "date": "2022-11-30T06:17:20",
            "name": "add basic_4k_pages_dsa testsuite",
            "version": 2,
            "mbox": "https://patches.dpdk.org/series/25941/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/120325/comments/",
    "check": "pending",
    "checks": "https://patches.dpdk.org/api/patches/120325/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 D812AA00C2;\n\tWed, 30 Nov 2022 07:23:07 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id D27C740A79;\n\tWed, 30 Nov 2022 07:23:07 +0100 (CET)",
            "from mga03.intel.com (mga03.intel.com [134.134.136.65])\n by mails.dpdk.org (Postfix) with ESMTP id 53BE44014F\n for <dts@dpdk.org>; Wed, 30 Nov 2022 07:23:06 +0100 (CET)",
            "from fmsmga003.fm.intel.com ([10.253.24.29])\n by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 29 Nov 2022 22:23:05 -0800",
            "from unknown (HELO localhost.localdomain) ([10.239.252.222])\n by fmsmga003-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 29 Nov 2022 22:23:04 -0800"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1669789386; x=1701325386;\n h=from:to:cc:subject:date:message-id:mime-version:\n content-transfer-encoding;\n bh=vGIY4gIIC28RHjsjuZmbilKVW0Op6lYnm0dnljlegbI=;\n b=i8pvJHGJyp6YOpSFzB4ra6ARwskf/J5gZIKECnW6PYtRwo5tT8VEuqP8\n t0kbp9l+jJGGEQCTwtx5iGArkGBILqgzjmY5DPq6KZAQnbgF0OU2eouZC\n iF7jkRko/DJh5n9uaURIjqVMAso09e7prE+rIgWY0POjv5EeMV3kZdh/k\n y5VBubaJ8/lXjpZO4ug0DE31PfcQLNF+AWznWnixOWO+ClNfTHBlAG+0G\n XzlJps355ZUWmeB4Fr9K0A+IDTpuNII+JdKZHAdTXEmfNf3DEVYVWhZ7F\n 4KS/z0RZ3yd3qLUP3I9Xvq+O4yg2mpuviwBrw/5fpU2ZlFgaPKkjRydE3 Q==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6500,9779,10546\"; a=\"317167335\"",
            "E=Sophos;i=\"5.96,205,1665471600\"; d=\"scan'208\";a=\"317167335\"",
            "E=McAfee;i=\"6500,9779,10546\"; a=\"732861339\"",
            "E=Sophos;i=\"5.96,205,1665471600\"; d=\"scan'208\";a=\"732861339\""
        ],
        "From": "Wei Ling <weix.ling@intel.com>",
        "To": "dts@dpdk.org",
        "Cc": "Wei Ling <weix.ling@intel.com>",
        "Subject": "[dts][PATCH V2 1/3] test_plans/basic_4k_pages_dsa_test_plan: modify\n testplan description",
        "Date": "Wed, 30 Nov 2022 14:17:28 +0800",
        "Message-Id": "<20221130061728.1163892-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": "Modify the description in testplan.\n\nSigned-off-by: Wei Ling <weix.ling@intel.com>\n---\n test_plans/basic_4k_pages_dsa_test_plan.rst | 75 +++++++++++----------\n 1 file changed, 38 insertions(+), 37 deletions(-)",
    "diff": "diff --git a/test_plans/basic_4k_pages_dsa_test_plan.rst b/test_plans/basic_4k_pages_dsa_test_plan.rst\nindex 4a67dfa0..7d0f9d77 100644\n--- a/test_plans/basic_4k_pages_dsa_test_plan.rst\n+++ b/test_plans/basic_4k_pages_dsa_test_plan.rst\n@@ -1,9 +1,9 @@\n .. SPDX-License-Identifier: BSD-3-Clause\n    Copyright(c) 2022 Intel Corporation\n \n-==============================================\n+=============================================\n Basic 4k-pages test with DSA driver test plan\n-==============================================\n+=============================================\n \n Description\n ===========\n@@ -21,10 +21,11 @@ and packed ring vhost-user/virtio-net mergeable and non-mergeable path.\n 4. Multi-queues number dynamic change in vm2vm vhost-user/virtio-net with split ring and packed ring.\n 5. Vhost-user using 1G hugepges and virtio-user using 4k-pages.\n \n-Note:\n-1. When DMA devices are bound to vfio driver, VA mode is the default and recommended. For PA mode, page by page mapping may\n-exceed IOMMU's max capability, better to use 1G guest hugepage.\n-2. DPDK local patch that about vhost pmd is needed when testing Vhost asynchronous data path with testpmd.\n+.. note::\n+\n+   1.When DMA devices are bound to vfio driver, VA mode is the default and recommended. For PA mode, page by page mapping may\n+   exceed IOMMU's max capability, better to use 1G guest hugepage.\n+   2.DPDK local patch that about vhost pmd is needed when testing Vhost asynchronous data path with testpmd.\n \n Prerequisites\n =============\n@@ -41,7 +42,7 @@ General set up\n \tCC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib -Dexamples=all --default-library=static x86_64-native-linuxapp-gcc\n \tninja -C x86_64-native-linuxapp-gcc -j 110\n \n-3. Get the PCI device ID and DSA device ID of DUT, for example, 0000:6a:00.0 is PCI device ID, 0000:6a:01.0 - 0000:f6:01.0 are DSA device IDs::\n+3. Get the PCI device of DUT, for example, 0000:6a:00.0 is NIC port, 0000:6a:01.0 - 0000:f6:01.0 are DSA devices::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -s\n \n@@ -74,14 +75,14 @@ Common steps\n ------------\n 1. Bind 1 NIC port to vfio-pci::\n \n-\t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci <DUT port pci device id>\n+\t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci <nic_pci>\n \tFor example:\n-\t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 0000:00:4f.1\n+\t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 0000:6a:00.0\n \n 2.Bind DSA devices to DPDK vfio-pci driver::\n \n-\t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci <DUT port DSA device id>\n-\tFor example, bind 2 DMA devices to vfio-pci driver:\n+\t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci <dsa_pci>\n+\tFor example, bind 2 DSA devices to vfio-pci driver:\n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 0000:e7:01.0 0000:ec:01.0\n \n .. note::\n@@ -93,18 +94,18 @@ Common steps\n \n 3. Bind DSA devices to kernel idxd driver, and configure Work Queue (WQ)::\n \n-\t<dpdk dir># ./usertools/dpdk-devbind.py -b idxd <numDevices * 2>\n-\t<dpdk dir># ./drivers/dma/dma/idxd/dpdk_idxd_cfg.py -q <numWq> <numDevices>\n+\t<dpdk dir># ./usertools/dpdk-devbind.py -b idxd <dsa_pci>\n+\t<dpdk dir># ./drivers/dma/dma/idxd/dpdk_idxd_cfg.py -q <wq_num> <dsa_idx>\n \n .. note::\n \n \tBetter to reset WQ when need operate DSA devices that bound to idxd drvier:\n \t<dpdk dir># ./drivers/dma/idxd/dpdk_idxd_cfg.py --reset <numDevices>\n \tYou can check it by 'ls /dev/dsa'\n-\tnumDevices: number of devices, where 0<=numDevices<=7, corresponding to 0000:6a:01.0 - 0000:f6:01.0\n-\tnumWq: Number of workqueues per DSA endpoint, where 1<=numWq<=8\n+\tdsa_idx: Index of DSA devices, where 0<=dsa_idx<=7, corresponding to 0000:6a:01.0 - 0000:f6:01.0\n+\twq_num: Number of workqueues per DSA endpoint, where 1<=numWq<=8\n \n-\tFor example, bind 2 DMA devices to idxd driver and configure WQ:\n+\tFor example, bind 2 DSA devices to idxd driver and configure WQ:\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b idxd 6a:01.0 6f:01.0\n \t<dpdk dir># ./drivers/dma/idxd/dpdk_idxd_cfg.py -q 1 0\n@@ -112,10 +113,10 @@ Common steps\n \tCheck WQ by 'ls /dev/dsa' and can find \"wq0.0 wq1.0 wq1.1 wq1.2 wq1.3\"\n \n Test Case 1: PVP split ring multi-queues with 4K-pages and dsa dpdk driver\n-------------------------------------------------------------------------------\n+--------------------------------------------------------------------------\n This case tests split ring with multi-queues can work normally in 4k-pages environment when vhost uses the asynchronous operations with dsa dpdk driver.\n \n-1. Bind 2 dsa device and one nic port to vfio-pci like common step 1-2::\n+1. Bind 2 DSA device and 1 NIC port to vfio-pci like common step 1-2::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 6a:00.0\n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci e7:01.0 ec:01.0\n@@ -172,10 +173,10 @@ This case tests split ring with multi-queues can work normally in 4k-pages envir\n 10. Rerun step 4-6.\n \n Test Case 2: PVP packed ring multi-queues with 4K-pages and dsa dpdk driver\n-------------------------------------------------------------------------------\n+---------------------------------------------------------------------------\n This case tests packed ring with multi-queues can work normally in 4k-pages environment when vhost uses the asynchronous operations with dsa dpdk driver.\n \n-1. Bind 2 dsa device and one nic port to vfio-pci like common step 1-2::\n+1. Bind 2 DSA device and 1 NIC port to vfio-pci like common step 1-2::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 6a:00.0\n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci f1:01.0 f6:01.0\n@@ -232,10 +233,10 @@ This case tests packed ring with multi-queues can work normally in 4k-pages envi\n 10.Rerun step 4-6.\n \n Test Case 3: VM2VM split ring vhost-user/virtio-net 4K-pages and dsa dpdk driver test with tcp traffic\n---------------------------------------------------------------------------------------------------------\n+------------------------------------------------------------------------------------------------------\n This case test the function of Vhost tx offload in the topology of vhost-user/virtio-net split ring mergeable path by verifing the TSO/cksum in the TCP/IP stack when vhost uses the asynchronous operations with dsa dpdk driver in 4k-pages environment.\n \n-1. Bind 1 dsa device to vfio-pci like common step 2::\n+1. Bind 1 DSA device to vfio-pci like common step 2::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci f1:01.0\n \n@@ -291,11 +292,11 @@ This case test the function of Vhost tx offload in the topology of vhost-user/vi\n \ttestpmd>show port xstats all\n \n Test Case 4: VM2VM packed ring vhost-user/virtio-net 4K-pages and dsa dpdk driver test with tcp traffic\n----------------------------------------------------------------------------------------------------------\n+-------------------------------------------------------------------------------------------------------\n This case test the function of Vhost tx offload in the topology of vhost-user/virtio-net packed ring mergeable path \n by verifing the TSO/cksum in the TCP/IP stack when vhost uses the asynchronous operations with dsa dpdk driver in 4k-pages environment.\n \n-1. Bind 1 dsa device to vfio-pci like common step 2::\n+1. Bind 1 DSA device to vfio-pci like common step 2::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci f1:01.0\n  \n@@ -351,7 +352,7 @@ by verifing the TSO/cksum in the TCP/IP stack when vhost uses the asynchronous o\n \ttestpmd>show port xstats all\n \n Test Case 5: VM2VM vhost/virtio-net split packed ring multi queues with 1G/4k-pages and dsa dpdk driver\n----------------------------------------------------------------------------------------------------------\n+-------------------------------------------------------------------------------------------------------\n This case uses iperf and scp to test the payload of large packet (larger than 1MB) is valid after packets forwarding in \n vm2vm vhost-user/virtio-net multi-queues mergeable path when vhost uses the asynchronous operations with dsa dpdk driver.\n And one virtio-net is split ring, the other is packed ring. The vhost run in 1G hugepages and the virtio-user run in 4k-pages environment.\n@@ -417,7 +418,7 @@ And one virtio-net is split ring, the other is packed ring. The vhost run in 1G\n 8. Relaunch vm1 and rerun step 4-7.\n \n Test Case 6: VM2VM vhost/virtio-net split ring multi queues with 1G/4k-pages and dsa dpdk driver\n----------------------------------------------------------------------------------------------------\n+------------------------------------------------------------------------------------------------\n This case uses iperf and scp to test the payload of large packet (larger than 1MB) is valid after packets forwarding in\n vm2vm vhost-user/virtio-net split ring mergeable path when vhost uses the asynchronous operations with\n dsa dpdk driver. The vhost run in 1G hugepages and the virtio-user run in 4k-pages environment.\n@@ -507,10 +508,10 @@ dsa dpdk driver. The vhost run in 1G hugepages and the virtio-user run in 4k-pag\n 11. Rerun step 6-7.\n \n Test Case 7: PVP split ring multi-queues with 4K-pages and dsa kernel driver\n---------------------------------------------------------------------------------\n+----------------------------------------------------------------------------\n This case tests split ring with multi-queues can work normally in 4k-pages environment when vhost uses the asynchronous operations with dsa kernel driver.\n \n-1. Bind one nic port to vfio-pci and 2 dsa device to idxd like common step 1 and 3::\n+1. Bind 1 NIC port to vfio-pci and 2 DSA device to idxd like common step 1 and 3::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 6a:00.0\n \n@@ -563,10 +564,10 @@ This case tests split ring with multi-queues can work normally in 4k-pages envir\n 8. Rerun step 4-6.\n \n Test Case 8: PVP packed ring multi-queues with 4K-pages and dsa kernel driver\n----------------------------------------------------------------------------------\n+-----------------------------------------------------------------------------\n This case tests split ring with multi-queues can work normally in 4k-pages environment when vhost uses the asynchronous operations with dsa kernel driver.\n \n-1. Bind one nic port to vfio-pci and 2 dsa device to idxd like common step 1 and 3::\n+1. Bind 1 NIC port to vfio-pci and 2 DSA device to idxd like common step 1 and 3::\n \n \t<dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci 6a:00.0\n \n@@ -619,12 +620,12 @@ This case tests split ring with multi-queues can work normally in 4k-pages envir\n 8. Rerun step 4-6.\n \n Test Case 9: VM2VM split ring vhost-user/virtio-net 4K-pages and dsa kernel driver test with tcp traffic\n----------------------------------------------------------------------------------------------------------\n+--------------------------------------------------------------------------------------------------------\n This case test the function of Vhost tx offload in the topology of vhost-user/virtio-net split ring mergeable path\n by verifing the TSO/cksum in the TCP/IP stack when vhost uses the asynchronous operations with dsa dpdk driver\n in 4k-pages environment.\n \n-1. Bind 1 dsa device to idxd like common step 2::\n+1. Bind 1 DSA device to idxd like common step 2::\n \n \tls /dev/dsa #check wq configure, reset if exist\n \t<dpdk dir># ./usertools/dpdk-devbind.py -u 6a:01.0\n@@ -684,12 +685,12 @@ in 4k-pages environment.\n \ttestpmd>show port xstats all\n \n Test Case 10: VM2VM packed ring vhost-user/virtio-net 4K-pages and dsa kernel driver test with tcp traffic\n------------------------------------------------------------------------------------------------------------\n+----------------------------------------------------------------------------------------------------------\n This case test the function of Vhost tx offload in the topology of vhost-user/virtio-net packed ring mergeable path\n by verifing the TSO/cksum in the TCP/IP stack when vhost uses the asynchronous operations with dsa dpdk driver\n in 4k-pages environment.\n \n-1. Bind 2 dsa device to idxd like common step 2::\n+1. Bind 2 DSA device to idxd like common step 2::\n \n \tls /dev/dsa #check wq configure, reset if exist\n \t<dpdk dir># ./usertools/dpdk-devbind.py -u 6a:01.0 6f:01.0\n@@ -750,12 +751,12 @@ in 4k-pages environment.\n \ttestpmd>show port xstats all\n \n Test Case 11: VM2VM vhost/virtio-net split packed ring multi queues with 1G/4k-pages and dsa kernel driver\n------------------------------------------------------------------------------------------------------------\n+----------------------------------------------------------------------------------------------------------\n This case uses iperf and scp to test the payload of large packet (larger than 1MB) is valid after packets forwarding in\n vm2vm vhost-user/virtio-net split and packed ring mergeable path when vhost uses the asynchronous operations with\n dsa kernel driver. The vhost run in 1G hugepages and the virtio-user run in 4k-pages environment.\n \n-1. Bind 8 dsa device to idxd like common step 3::\n+1. Bind 8 DSA device to idxd like common step 3::\n \n \tls /dev/dsa #check wq configure, reset if exist\n \t<dpdk dir># ./usertools/dpdk-devbind.py -u 6a:01.0 6f:01.0 74:01.0 79:01.0 e7:01.0 ec:01.0 f1:01.0 f6:01.0\n@@ -827,7 +828,7 @@ dsa kernel driver. The vhost run in 1G hugepages and the virtio-user run in 4k-p\n 8. Relaunch vm1 and rerun step 4-7.\n \n Test Case 12: VM2VM vhost/virtio-net split ring multi queues with 1G/4k-pages and dsa kernel driver\n------------------------------------------------------------------------------------------------------\n+---------------------------------------------------------------------------------------------------\n This case uses iperf and scp to test the payload of large packet (larger than 1MB) is valid after packets forwarding in\n vm2vm vhost-user/virtio-net split ring mergeable path when vhost uses the asynchronous operations with\n dsa kernel driver. The vhost run in 1G hugepages and the virtio-user run in 4k-pages environment.\n",
    "prefixes": [
        "V2",
        "1/3"
    ]
}