get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 115992,
    "url": "https://patches.dpdk.org/api/patches/115992/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20220907024020.2474860-1-rongweil@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": "<20220907024020.2474860-1-rongweil@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20220907024020.2474860-1-rongweil@nvidia.com",
    "date": "2022-09-07T02:40:20",
    "name": "[v1] ethdev: add direction info when creating the transfer table",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "7ab4c9ab620d589d0a09ff181ff5a41f385d6e3b",
    "submitter": {
        "id": 2223,
        "url": "https://patches.dpdk.org/api/people/2223/?format=api",
        "name": "Rongwei Liu",
        "email": "rongweil@nvidia.com"
    },
    "delegate": {
        "id": 3961,
        "url": "https://patches.dpdk.org/api/users/3961/?format=api",
        "username": "arybchenko",
        "first_name": "Andrew",
        "last_name": "Rybchenko",
        "email": "andrew.rybchenko@oktetlabs.ru"
    },
    "mbox": "https://patches.dpdk.org/project/dpdk/patch/20220907024020.2474860-1-rongweil@nvidia.com/mbox/",
    "series": [
        {
            "id": 24569,
            "url": "https://patches.dpdk.org/api/series/24569/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=24569",
            "date": "2022-09-07T02:40:20",
            "name": "[v1] ethdev: add direction info when creating the transfer table",
            "version": 1,
            "mbox": "https://patches.dpdk.org/series/24569/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/115992/comments/",
    "check": "success",
    "checks": "https://patches.dpdk.org/api/patches/115992/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 718A3A0542;\n\tWed,  7 Sep 2022 04:41:22 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 14AF8400D6;\n\tWed,  7 Sep 2022 04:41:22 +0200 (CEST)",
            "from NAM11-BN8-obe.outbound.protection.outlook.com\n (mail-bn8nam11on2040.outbound.protection.outlook.com [40.107.236.40])\n by mails.dpdk.org (Postfix) with ESMTP id 27A0840042\n for <dev@dpdk.org>; Wed,  7 Sep 2022 04:41:21 +0200 (CEST)",
            "from MW2PR2101CA0007.namprd21.prod.outlook.com (2603:10b6:302:1::20)\n by MN2PR12MB4439.namprd12.prod.outlook.com (2603:10b6:208:262::17)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5588.11; Wed, 7 Sep\n 2022 02:41:19 +0000",
            "from CO1NAM11FT034.eop-nam11.prod.protection.outlook.com\n (2603:10b6:302:1:cafe::54) by MW2PR2101CA0007.outlook.office365.com\n (2603:10b6:302:1::20) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5632.4 via Frontend\n Transport; Wed, 7 Sep 2022 02:41:18 +0000",
            "from mail.nvidia.com (12.22.5.236) by\n CO1NAM11FT034.mail.protection.outlook.com (10.13.174.248) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.5612.13 via Frontend Transport; Wed, 7 Sep 2022 02:41:18 +0000",
            "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL109.nvidia.com\n (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.38;\n Wed, 7 Sep 2022 02:40:39 +0000",
            "from nvidia.com (10.126.230.35) by rnnvmail201.nvidia.com\n (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.29; Tue, 6 Sep 2022\n 19:40:35 -0700"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=Pu2Ga1Z8IqOnrX/+seC7MB4xfLRVLjfNj0WRRfkwbB6SIj3F7WxakEAJ29MKEVru40oBllg4CsoXR0zVcU3CXIdgTAWIjXP1DWY9EaxIun2RW7jbfgABh+FnTC17bRXnBYpaVqJFJCFAAusbSNkKx05CVfpg3/Id3crLgQ+SE847uj2luJq9eD8oc0cTK9mc4EDFYg9ppEVr/ctmgEZtStNTA/Sx0nSDTvXKMpBhU7ge/YryOBA+76zCSlOZzbShnD6KpjS3miBGJYusuqw8in16xUamQWtaPM+dgxLpvU21buVEnj0zXwnivrkAn4/NFKmkq2G3lhFQGSd9NDio2g==",
        "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=VdZHYoflQMnvZqyAIZj5+oUJpcQXBzrzsg+x8GuSlog=;\n b=OfBoVL403l3VV90ds/BTMyLhwscuHV8FjerW5VleCykRyYUKspUWHhenfIQY++89NeKV15Ka7nrKOHEo0sXcn/uAKYogFcDi1E737dBVGDWlNS/a8hh5Jetu7WQwj5Er2BgbiQWjGxB51S1OHK7ZzmyjKu6ctyj4fwLbxKGdddrSz9Ip+UChePeQn3inUaLF3EOTUkL6ZgRs4YjkXcPTq8bqVaoSfbJemQllhanwboaxoMWtpcUbZzcuyCxJkTgwYNr4mhL1ijDPYrZnpi1JCBMc+hEClgB/DyhVi94p6Bv42Dn8KPjUbQOkMdilN6nvYAzGQQwHvxgl0fUIgQJ1yA==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.236) smtp.rcpttodomain=xilinx.com smtp.mailfrom=nvidia.com;\n dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com;\n 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=VdZHYoflQMnvZqyAIZj5+oUJpcQXBzrzsg+x8GuSlog=;\n b=KnXzH2UWfvD9rxwsF/qjNENIVJzm5yvCCG8PyB/iTrZjpu2CFvBYjZHjiYDcXMMDB2tS5AhX4hBY2YxLT2jV7zwEGd5Z3PRsf4QO/2eBLoUUQR67fUFwPfWUpBEEP1l/bP8dgn9Com9FnR3fPBwvWv5qqh9v/qaWpgc+QC/WxJMBNwuI+6bEqz+sRETOBqAKVlI9TFx1WUFyO66oLWOVrgdWSrRc7VGc3btyyEIqJqvpJq7wvd+B4iqUOLhhU98VxDr32IUKIEHik8qpySni3soixk6SYynBo/BPPmtNcp4SQJjCt+kTDKt3zTkZZJMAE01aYtwUcaH0pDsnbceM3w==",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.236)\n smtp.mailfrom=nvidia.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=nvidia.com;",
        "Received-SPF": "Pass (protection.outlook.com: domain of nvidia.com designates\n 12.22.5.236 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.236; helo=mail.nvidia.com; pr=C",
        "From": "Rongwei Liu <rongweil@nvidia.com>",
        "To": "<matan@nvidia.com>, <viacheslavo@nvidia.com>, <orika@nvidia.com>,\n <thomas@monjalon.net>, Aman Singh <aman.deep.singh@intel.com>, Yuying Zhang\n <yuying.zhang@intel.com>, Ferruh Yigit <ferruh.yigit@xilinx.com>, \"Andrew\n Rybchenko\" <andrew.rybchenko@oktetlabs.ru>",
        "CC": "<dev@dpdk.org>, <rasland@nvidia.com>",
        "Subject": "[PATCH v1] ethdev: add direction info when creating the transfer\n table",
        "Date": "Wed, 7 Sep 2022 05:40:20 +0300",
        "Message-ID": "<20220907024020.2474860-1-rongweil@nvidia.com>",
        "X-Mailer": "git-send-email 2.27.0",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[10.126.230.35]",
        "X-ClientProxiedBy": "rnnvmail203.nvidia.com (10.129.68.9) To\n rnnvmail201.nvidia.com (10.129.68.8)",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-TrafficTypeDiagnostic": "CO1NAM11FT034:EE_|MN2PR12MB4439:EE_",
        "X-MS-Office365-Filtering-Correlation-Id": "f69f9c64-f539-4d32-dad9-08da907a7116",
        "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n /w85oy8+M1cxYpgjZNIdD6uqOzTDMxZo4YSG7ph/jAYC4QOuXvcphOwct0z9FSE4S/L7UNWiGggaY7n7LTlau5amiXq9FUqyXnt+EIt1EN+icaO3DOwWa0tiXUxDKy6vwdV+c2WpKwjBw2Lso8XzhIvXv1DwJo3LKFCkDkaVImhGhH0YMb2U04cL4ZVcxIrH6rPUM0cddIh+EUeCpc2YAllXwkIi6L4c3DZfNnAuuaMJl7zw4HcWCXBvCtpmJHKRGbE2SVIgMEk5qjBPTKObsX2BYD62RtGrR/8+i0W+sP8iNfhirf91FIlCBQ2yG2FjP7uQ7AC2ly+BRRiZ3FgmRC1LKkh6zDiIbaVU4ZrK0ntNvZDClsrSRBK2Ws+a2LSbIIv/NHHOESasm+yVw0wpsSzVwp33yTxE1aNF0sTnKUyL/4HuzyD6cMfBDn1gdHDk5s/taAGwmVBL9/u7+FFoVP+JIZBrpx+0Vsjmv4eXypE0GyaVoLJm5e8cW5VO6deykluj/YQabT8axq87JpNcu+q6AErmTCGbTc22zS9208IxoyiucGskj6cWh0iv35r0y6w8XsLxdXp9Zac5bXfCKdOpfTRQ3AakDjGoKllT3P+Zk/Tw0JYgLFA2nVen1yqrL7nq85ms0xThbO+ZYWrrZHDdWKLLBhO8EDuipb55ljuULEYg4LN+AhaxIzF9mjxqo5OW/3OYqxoxnQfrouInVqsjpG+iDPUy4SbMknD3q3OPSlPMEd7u9YfZYe1UjSm6weAW9bv6RwVWVKxGms3isD1zUtvmhtaBJQt/6KDgypA=",
        "X-Forefront-Antispam-Report": "CIP:12.22.5.236; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(13230016)(4636009)(39860400002)(346002)(136003)(376002)(396003)(46966006)(40470700004)(36840700001)(81166007)(356005)(82740400003)(40460700003)(36860700001)(4326008)(55016003)(8676002)(70206006)(70586007)(82310400005)(110136005)(316002)(54906003)(426003)(26005)(5660300002)(8936002)(16526019)(40480700001)(2616005)(6286002)(83380400001)(47076005)(1076003)(478600001)(6666004)(186003)(107886003)(7696005)(2906002)(86362001)(336012)(41300700001)(36756003)(36900700001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "07 Sep 2022 02:41:18.2985 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n f69f9c64-f539-4d32-dad9-08da907a7116",
        "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.236];\n Helo=[mail.nvidia.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n CO1NAM11FT034.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "MN2PR12MB4439",
        "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"
    },
    "content": "The transfer domain rule is able to match traffic wire/vf\norigin and it means two directions' underlayer resource.\n\nIn customer deployments, they usually match only one direction\ntraffic in single flow table: either from wire or from vf.\n\nIntroduce one new member transfer_mode into rte_flow_attr to\nindicate the flow table direction property: from wire, from vf\nor bi-direction(default).\n\nIt helps to save underlayer memory also on insertion rate.\n\nBy default, the transfer domain is bi-direction, and no behavior changes.\n\n1. Match wire origin only\n   flow template_table 0 create group 0 priority 0 transfer wire_orig...\n2. Match vf origin only\n   flow template_table 0 create group 0 priority 0 transfer vf_orig...\n\nSigned-off-by: Rongwei Liu <rongweil@nvidia.com>\n---\n app/test-pmd/cmdline_flow.c                 | 26 +++++++++++++++++++++\n doc/guides/testpmd_app_ug/testpmd_funcs.rst |  3 ++-\n lib/ethdev/rte_flow.h                       |  9 ++++++-\n 3 files changed, 36 insertions(+), 2 deletions(-)",
    "diff": "diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c\nindex 7f50028eb7..b25b595e82 100644\n--- a/app/test-pmd/cmdline_flow.c\n+++ b/app/test-pmd/cmdline_flow.c\n@@ -177,6 +177,8 @@ enum index {\n \tTABLE_INGRESS,\n \tTABLE_EGRESS,\n \tTABLE_TRANSFER,\n+\tTABLE_TRANSFER_WIRE_ORIG,\n+\tTABLE_TRANSFER_VF_ORIG,\n \tTABLE_RULES_NUMBER,\n \tTABLE_PATTERN_TEMPLATE,\n \tTABLE_ACTIONS_TEMPLATE,\n@@ -1141,6 +1143,8 @@ static const enum index next_table_attr[] = {\n \tTABLE_INGRESS,\n \tTABLE_EGRESS,\n \tTABLE_TRANSFER,\n+\tTABLE_TRANSFER_WIRE_ORIG,\n+\tTABLE_TRANSFER_VF_ORIG,\n \tTABLE_RULES_NUMBER,\n \tTABLE_PATTERN_TEMPLATE,\n \tTABLE_ACTIONS_TEMPLATE,\n@@ -2881,6 +2885,18 @@ static const struct token token_list[] = {\n \t\t.next = NEXT(next_table_attr),\n \t\t.call = parse_table,\n \t},\n+\t[TABLE_TRANSFER_WIRE_ORIG] = {\n+\t\t.name = \"wire_orig\",\n+\t\t.help = \"affect rule direction to transfer\",\n+\t\t.next = NEXT(next_table_attr),\n+\t\t.call = parse_table,\n+\t},\n+\t[TABLE_TRANSFER_VF_ORIG] = {\n+\t\t.name = \"vf_orig\",\n+\t\t.help = \"affect rule direction to transfer\",\n+\t\t.next = NEXT(next_table_attr),\n+\t\t.call = parse_table,\n+\t},\n \t[TABLE_RULES_NUMBER] = {\n \t\t.name = \"rules_number\",\n \t\t.help = \"number of rules in table\",\n@@ -8894,6 +8910,16 @@ parse_table(struct context *ctx, const struct token *token,\n \tcase TABLE_TRANSFER:\n \t\tout->args.table.attr.flow_attr.transfer = 1;\n \t\treturn len;\n+\tcase TABLE_TRANSFER_WIRE_ORIG:\n+\t\tif (!out->args.table.attr.flow_attr.transfer)\n+\t\t\treturn -1;\n+\t\tout->args.table.attr.flow_attr.transfer_mode = 1;\n+\t\treturn len;\n+\tcase TABLE_TRANSFER_VF_ORIG:\n+\t\tif (!out->args.table.attr.flow_attr.transfer)\n+\t\t\treturn -1;\n+\t\tout->args.table.attr.flow_attr.transfer_mode = 2;\n+\t\treturn len;\n \tdefault:\n \t\treturn -1;\n \t}\ndiff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst\nindex 330e34427d..603b7988dd 100644\n--- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst\n+++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst\n@@ -3332,7 +3332,8 @@ It is bound to ``rte_flow_template_table_create()``::\n \n    flow template_table {port_id} create\n        [table_id {id}] [group {group_id}]\n-       [priority {level}] [ingress] [egress] [transfer]\n+       [priority {level}] [ingress] [egress]\n+       [transfer [vf_orig] [wire_orig]]\n        rules_number {number}\n        pattern_template {pattern_template_id}\n        actions_template {actions_template_id}\ndiff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h\nindex a79f1e7ef0..512b08d817 100644\n--- a/lib/ethdev/rte_flow.h\n+++ b/lib/ethdev/rte_flow.h\n@@ -130,7 +130,14 @@ struct rte_flow_attr {\n \t * through a suitable port. @see rte_flow_pick_transfer_proxy().\n \t */\n \tuint32_t transfer:1;\n-\tuint32_t reserved:29; /**< Reserved, must be zero. */\n+\t/**\n+\t * 0 means bidirection,\n+\t * 0x1 origin uplink,\n+\t * 0x2 origin vport,\n+\t * N/A both set.\n+\t */\n+\tuint32_t transfer_mode:2;\n+\tuint32_t reserved:27; /**< Reserved, must be zero. */\n };\n \n /**\n",
    "prefixes": [
        "v1"
    ]
}