get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 102272,
    "url": "https://patches.dpdk.org/api/patches/102272/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20211019152809.2278464-1-xuemingl@nvidia.com/",
    "project": {
        "id": 1,
        "url": "https://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": "<20211019152809.2278464-1-xuemingl@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20211019152809.2278464-1-xuemingl@nvidia.com",
    "date": "2021-10-19T15:28:02",
    "name": "[v10,0/7] ethdev: introduce shared Rx queue",
    "commit_ref": null,
    "pull_url": null,
    "state": null,
    "archived": false,
    "hash": null,
    "submitter": {
        "id": 1904,
        "url": "https://patches.dpdk.org/api/people/1904/?format=api",
        "name": "Xueming Li",
        "email": "xuemingl@nvidia.com"
    },
    "delegate": null,
    "mbox": "https://patches.dpdk.org/project/dpdk/patch/20211019152809.2278464-1-xuemingl@nvidia.com/mbox/",
    "series": [],
    "comments": "https://patches.dpdk.org/api/patches/102272/comments/",
    "check": "pending",
    "checks": "https://patches.dpdk.org/api/patches/102272/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dev-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 16579A0C41;\n\tTue, 19 Oct 2021 17:28:44 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 03ADB41217;\n\tTue, 19 Oct 2021 17:28:44 +0200 (CEST)",
            "from NAM12-MW2-obe.outbound.protection.outlook.com\n (mail-mw2nam12on2086.outbound.protection.outlook.com [40.107.244.86])\n by mails.dpdk.org (Postfix) with ESMTP id 57BE14117E\n for <dev@dpdk.org>; Tue, 19 Oct 2021 17:28:42 +0200 (CEST)",
            "from BN8PR03CA0002.namprd03.prod.outlook.com (2603:10b6:408:94::15)\n by CH2PR12MB4971.namprd12.prod.outlook.com (2603:10b6:610:6b::7) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4608.17; Tue, 19 Oct\n 2021 15:28:40 +0000",
            "from BN8NAM11FT054.eop-nam11.prod.protection.outlook.com\n (2603:10b6:408:94:cafe::95) by BN8PR03CA0002.outlook.office365.com\n (2603:10b6:408:94::15) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4608.16 via Frontend\n Transport; Tue, 19 Oct 2021 15:28:40 +0000",
            "from mail.nvidia.com (216.228.112.34) by\n BN8NAM11FT054.mail.protection.outlook.com (10.13.177.102) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.4608.15 via Frontend Transport; Tue, 19 Oct 2021 15:28:39 +0000",
            "from nvidia.com (172.20.187.6) by HQMAIL107.nvidia.com\n (172.20.187.13) with Microsoft SMTP Server (TLS) id 15.0.1497.18; Tue, 19 Oct\n 2021 15:28:34 +0000"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=T3WASTQcLEALBXPi3hbdpk3Bf+2pH7Gr0cVrfOIG/weGiE7GgWfSCxjyhuTq1ycVnJZfGPc06M8uIwkePyNODMztueEINWGvloUckB1y1LnsUzm/b0XfAXlr8PHkWBSBeDO5te+h8zQ+ouASexokKqUSo68aSw9Xa5jufdmnyCdp8ckeskJRrP8JApcbTzYRwki/7PSsMQ01FKwXxj7NZ93v+dnNYX30U6PiK16OUbFrAp1zhxPq4Al2NqAAMayJ0xTpLEoGzUnnRdzbg7MAyb2yS6cWZCcfJ81S0G2x1qk4WkmYJsC7mcrmGS8xJPWFFxG0NRyJlCU0nXR8+bMZtQ==",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=H8KJ4r/PK116OpgCzb+32QJNls5oppoUPmV5FQNzxCg=;\n b=EImH1qjgcYc2oRBCgsvr8pod7YrPiRBjxjuCavkK87LjPhcO8kNfyDNseLGV23ZbvcKUABXATG7oxfNMYUjkq2QBRyg/qbvTeLFrFCYk1pgIN0lsDdeN+WfuhR7csiMIbv0zZbd6PhRs39kRfShsvnumme/cIMXEKC/XmIFLeSmvoyI8rvZFPHniXNHXJxU3ijTbx9JpDTdqQ1F0ODs53KOzaMI1kAzZHYmJDQt2TKV46Jdd2XiKaPR22x1woMc7y3s0sS5SXm0i3U8cLh0tAGgZRfA8PegOqd9Dtzb5aTekmeFQ2DE9mo55u6zGZnjRyFZJhhkZYr8o6+4aac+p5A==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 216.228.112.34) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com;\n dmarc=pass (p=quarantine sp=quarantine pct=100) action=none\n header.from=nvidia.com; dkim=none (message not signed); arc=none",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com;\n s=selector2;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=H8KJ4r/PK116OpgCzb+32QJNls5oppoUPmV5FQNzxCg=;\n b=tCuDmnVDheIChzSO1nDFqxTOq5Oj2acOsssMEv5F9xm7qmf1HwjmSE/4GZT0ExpBzfJYXvhdmpryHi3f92zgaVny2JnHRonzsrfOwbskAJQqGnb9IUEPeIaKGBIhPRWMuCc7RnrW7qu+Hg9+BCO/yXuUmaHGLNBsuP9AlydHG/CrIEWD4r8OpSiM22fu9LMaiijzEpX42DXWgK9UTcpw1YAJ3r1qPODZPoLGx+2S9d+aXPzo2WvujMS/eSX9/z5V75IKL3cDzofzSbnVExODkjOZzop5t96c2NYqHRug4xzS62uuRustvTGzkwIZvSgAMPgN0HNXfxI7yVViDpMKbg==",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 216.228.112.34)\n smtp.mailfrom=nvidia.com; monjalon.net; dkim=none (message not signed)\n header.d=none;monjalon.net; dmarc=pass action=none header.from=nvidia.com;",
        "Received-SPF": "Pass (protection.outlook.com: domain of nvidia.com designates\n 216.228.112.34 as permitted sender) receiver=protection.outlook.com;\n client-ip=216.228.112.34; helo=mail.nvidia.com;",
        "From": "Xueming Li <xuemingl@nvidia.com>",
        "To": "<dev@dpdk.org>, Zhang Yuying <yuying.zhang@intel.com>",
        "CC": "<xuemingl@nvidia.com>, Jerin Jacob <jerinjacobk@gmail.com>, Ferruh Yigit\n <ferruh.yigit@intel.com>, Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>,\n Viacheslav Ovsiienko <viacheslavo@nvidia.com>, Thomas Monjalon\n <thomas@monjalon.net>, Lior Margalit <lmargalit@nvidia.com>, \"Ananyev\n Konstantin\" <konstantin.ananyev@intel.com>, Ajit Khaparde\n <ajit.khaparde@broadcom.com>",
        "Date": "Tue, 19 Oct 2021 23:28:02 +0800",
        "Message-ID": "<20211019152809.2278464-1-xuemingl@nvidia.com>",
        "X-Mailer": "git-send-email 2.33.0",
        "In-Reply-To": "<20210727034204.20649-1-xuemingl@nvidia.com>",
        "References": "<20210727034204.20649-1-xuemingl@nvidia.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[172.20.187.6]",
        "X-ClientProxiedBy": "HQMAIL105.nvidia.com (172.20.187.12) To\n HQMAIL107.nvidia.com (172.20.187.13)",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-Office365-Filtering-Correlation-Id": "80470837-7e3a-4d85-7966-08d9931520ba",
        "X-MS-TrafficTypeDiagnostic": "CH2PR12MB4971:",
        "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr",
        "X-Microsoft-Antispam-PRVS": "\n <CH2PR12MB497182B8491303C339464039A1BD9@CH2PR12MB4971.namprd12.prod.outlook.com>",
        "X-MS-Oob-TLC-OOBClassifiers": "OLM:8882;",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n kEovP6w+YfggQNLgtzn/JHuSVzhNZ9bL1yjzfRenNvfH20HvhBJlUf/+vGajRYMQKK1hGrcyZfRxEnaRBMCw4aCC9fN6DDEu2k1L1547aKfskSMEFzEmQ2jgl6g5Egot+tFPKhunnegU6bH1k1elflVbNjaHSqTytZdNdlvGjW0h1QUPX8uCSkElh4qik8dxuz7iT6kehYZgB+sMpA4/0PllDWx3fl8PSCZixr8ywGg4xk7/Irwo5pFJVc3HM3GtXpmxadLFw9RTOQJBpA1yHs54zyR8svSaReEDeQ63XCWb6o18y9TjD7hskjVZKu3OMoGQCUDu+IM/NQeDIj5hM7qtLmyubbdOGWMomrcCa5cq0E46X6qSoITxqO+KyWT2mNovGpY5Bkw4/6lOVyB0g3K5ueQ1hWQ8zA3XdfsRQAtR83znajFF4FxJ6g6hBhFG/hewIZqzdsAcQuNbzmcg9igePDLIirIS4gTplrfes3GbDATC/vK2WHPeW8MK4z4Pwr9nXF/sm1kextOIGaOqHhOhlO0n0oRbA+l891matAjx+L5CIQRRCSzL2p5VywcjxwQfN6WgrhnOsDMbk6xJyWrjBZwqvveHeCou6dL6BvXtUrR2EOejDNyZRoH//SASPtAos1LCFvhEobVlXdB5HkJMQjt97dkv/jLrf2PG8sbJuBSZJPXLT2AIQj4G6RtwwlNBNc3vIMNYUXHWDydG7A==",
        "X-Forefront-Antispam-Report": "CIP:216.228.112.34; CTRY:US; LANG:en; SCL:1;\n SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:schybrid03.nvidia.com; CAT:NONE;\n SFS:(4636009)(46966006)(36840700001)(7696005)(83380400001)(36906005)(336012)(356005)(5660300002)(8676002)(16526019)(26005)(4326008)(7636003)(6286002)(2906002)(426003)(55016002)(70206006)(70586007)(47076005)(86362001)(36756003)(316002)(508600001)(1076003)(54906003)(6666004)(8936002)(110136005)(2616005)(186003)(36860700001)(82310400003);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "19 Oct 2021 15:28:39.6697 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 80470837-7e3a-4d85-7966-08d9931520ba",
        "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.112.34];\n Helo=[mail.nvidia.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n BN8NAM11FT054.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "CH2PR12MB4971",
        "Subject": "[dpdk-dev] [PATCH v10 0/7] ethdev: introduce shared Rx queue",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <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 <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "In current DPDK framework, all Rx queues is pre-loaded with mbufs for\nincoming packets. When number of representors scale out in a switch\ndomain, the memory consumption became significant. Further more,\npolling all ports leads to high cache miss, high latency and low\nthroughputs.\n\nThis patch introduces shared Rx queue. PF and representors in same\nRx domain and switch domain could share Rx queue set by specifying\nnon-zero share group value in Rx queue configuration.\n\nAll ports that share Rx queue actually shares hardware descriptor\nqueue and feed all Rx queues with one descriptor supply, memory is saved.\n\nPolling any queue using same shared Rx queue receives packets from all\nmember ports. Source port is identified by mbuf->port.\n\nMultiple groups is supported by group ID. Port queue number in a shared\ngroup should be identical. Queue index is 1:1 mapped in shared group.\nAn example of two share groups:\n Group1, 4 shared Rx queues per member port: PF, repr0, repr1\n Group2, 2 shared Rx queues per member port: repr2, repr3, ... repr127\n Poll first port for each group:\n  core\tport\tqueue\n  0\t0\t0\n  1\t0\t1\n  2\t0\t2\n  3\t0\t3\n  4\t2\t0\n  5\t2\t1\n\nShared Rx queue must be polled on single thread or core. If both PF0 and\nrepresentor0 joined same share group, can't poll pf0rxq0 on core1 and\nrep0rxq0 on core2. Actually, polling one port within share group is\nsufficient since polling any port in group will return packets for any\nport in group.\n\nThere was some discussion to aggregate member ports in same group into a\ndummy port, several ways to achieve it. Since it optional, need to collect\nmore feedback and requirement from user, make better decision later.\n\nv1:\n  - initial version\nv2:\n  - add testpmd patches\nv3:\n  - change common forwarding api to macro for performance, thanks Jerin.\n  - save global variable accessed in forwarding to flowstream to minimize\n    cache miss\n  - combined patches for each forwarding engine\n  - support multiple groups in testpmd \"--share-rxq\" parameter\n  - new api to aggregate shared rxq group\nv4:\n  - spelling fixes\n  - remove shared-rxq support for all forwarding engines\n  - add dedicate shared-rxq forwarding engine\nv5:\n - fix grammars\n - remove aggregate api and leave it for later discussion\n - add release notes\n - add deployment example\nv6:\n - replace RxQ offload flag with device offload capability flag\n - add Rx domain\n - RxQ is shared when share group > 0\n - update testpmd accordingly\nv7:\n - fix testpmd share group id allocation\n - change rx_domain to 16bits\nv8:\n - add new patch for testpmd to show device Rx domain ID and capability\n - new share_qid in RxQ configuration\nv9:\n - fix some spelling\nv10:\n - add device capability name api\n\nXueming Li (7):\n  ethdev: introduce shared Rx queue\n  ethdev: new API to resolve device capability name\n  app/testpmd: dump device capability and Rx domain info\n  app/testpmd: new parameter to enable shared Rx queue\n  app/testpmd: dump port info for shared Rx queue\n  app/testpmd: force shared Rx queue polled on same core\n  app/testpmd: add forwarding engine for shared Rx queue\n\n app/test-pmd/config.c                         | 139 +++++++++++++++-\n app/test-pmd/meson.build                      |   1 +\n app/test-pmd/parameters.c                     |  13 ++\n app/test-pmd/shared_rxq_fwd.c                 | 148 ++++++++++++++++++\n app/test-pmd/testpmd.c                        |  25 ++-\n app/test-pmd/testpmd.h                        |   5 +\n app/test-pmd/util.c                           |   3 +\n doc/guides/nics/features.rst                  |  13 ++\n doc/guides/nics/features/default.ini          |   1 +\n .../prog_guide/switch_representation.rst      |  11 ++\n doc/guides/rel_notes/release_21_11.rst        |   6 +\n doc/guides/testpmd_app_ug/run_app.rst         |   8 +\n doc/guides/testpmd_app_ug/testpmd_funcs.rst   |   5 +-\n lib/ethdev/rte_ethdev.c                       |  38 +++++\n lib/ethdev/rte_ethdev.h                       |  38 +++++\n lib/ethdev/version.map                        |   3 +\n 16 files changed, 451 insertions(+), 6 deletions(-)\n create mode 100644 app/test-pmd/shared_rxq_fwd.c",
    "diff": null,
    "prefixes": [
        "v10",
        "0/7"
    ]
}