Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/136230/?format=api
{ "id": 136230, "url": "http://patches.dpdk.org/api/patches/136230/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20240131093804.357465-2-bingz@nvidia.com/", "project": { "id": 1, "url": "http://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": "<20240131093804.357465-2-bingz@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20240131093804.357465-2-bingz@nvidia.com", "date": "2024-01-31T09:38:03", "name": "[v2,1/2] ethdev: introduce NAT64 action", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "f47107f210e20b32cb3700908a752f45ad1b1dd1", "submitter": { "id": 1976, "url": "http://patches.dpdk.org/api/people/1976/?format=api", "name": "Bing Zhao", "email": "bingz@nvidia.com" }, "delegate": { "id": 319, "url": "http://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20240131093804.357465-2-bingz@nvidia.com/mbox/", "series": [ { "id": 30950, "url": "http://patches.dpdk.org/api/series/30950/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30950", "date": "2024-01-31T09:38:02", "name": "support NAT64 action", "version": 2, "mbox": "http://patches.dpdk.org/series/30950/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/136230/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/136230/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 9F54F43A1A;\n\tWed, 31 Jan 2024 10:38:55 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 8CAF1427E5;\n\tWed, 31 Jan 2024 10:38:55 +0100 (CET)", "from NAM12-MW2-obe.outbound.protection.outlook.com\n (mail-mw2nam12on2072.outbound.protection.outlook.com [40.107.244.72])\n by mails.dpdk.org (Postfix) with ESMTP id D7113427E0\n for <dev@dpdk.org>; Wed, 31 Jan 2024 10:38:53 +0100 (CET)", "from BLAPR03CA0063.namprd03.prod.outlook.com (2603:10b6:208:329::8)\n by MW3PR12MB4586.namprd12.prod.outlook.com (2603:10b6:303:53::7) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7249.22; Wed, 31 Jan\n 2024 09:38:50 +0000", "from MN1PEPF0000F0E4.namprd04.prod.outlook.com\n (2603:10b6:208:329:cafe::a) by BLAPR03CA0063.outlook.office365.com\n (2603:10b6:208:329::8) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7249.24 via Frontend\n Transport; Wed, 31 Jan 2024 09:38:49 +0000", "from mail.nvidia.com (216.228.117.161) by\n MN1PEPF0000F0E4.mail.protection.outlook.com (10.167.242.42) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.7249.19 via Frontend Transport; Wed, 31 Jan 2024 09:38:49 +0000", "from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com\n (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.41; Wed, 31 Jan\n 2024 01:38:33 -0800", "from nvidia.com (10.126.231.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.41; Wed, 31 Jan\n 2024 01:38:30 -0800" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=R70805DO2A3uuaBzwIECqblwiSM+h7YP48H1ivN3iJhxRuprf6ZQafdOe/pymUB7/K5SKdDS4JhFzCbMPSWzM7hliSBtRadhVLKbR8cby86q81Gm5OHfeDn1awaeLTVuosuCcf9eM/MJwEY5UOwEd+VxMTzRkAoqCid9JylOwMfeykSone/SzRMSqU9jqVxzdU0gIqqAttl2Y8LgZfjwJXEaxYYz50My/X+K1VTjy4g1XPGPmHExT3BTOJttdslYEZqEh/hSnYirjFyccHNfdV7X3Vgy2DwedQphF+ieQCjmxzysLlOmMW2/Ow8NfmQ8/oZ/ezrTFqP2zL/QruGdBA==", "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=hPWz4UByh/xdY7LJhLiwkVeNo13XqYN+6OhDtBh4pg0=;\n b=GKPmSdGHVrNRXbHmNM80RKAQl/z2BArZSl9jE8xY8iEay4jqSzb461B0AZBygVjIQT1NiJpE0rhp3OPi+boODkZ+kh82vtx4vyonfbeqQUPEGoa9nhFqMYaFO9lxnmTDZSZNtuRwvXm0QRxPqRnEZN1Aj7qtZvstYBhGnMOqtyX0Y1HXkQYsBe9+3hU/eWADojXwpmG024exiBsOPSkKbrtc1udDyoki7cDL2twxdrO5mPx/SwA8FEOylroF5WFeanbkrtlvDlt3HYSFJsdpyuQn8Jc0GcMamI6tfZOx6u5A0xLa2ee7LO3Y8T+eiQA6Z1hBvcdiyy7f2kDoVDNd8g==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 216.228.117.161) smtp.rcpttodomain=intel.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 (0)", "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=hPWz4UByh/xdY7LJhLiwkVeNo13XqYN+6OhDtBh4pg0=;\n b=klKN7aBifgPgVsBw4nLctVBv64vkTutEqQ33gFXBRPhfJXrGjwBlBbcv3hmiZpiSzrMn3uPo4PY34t/MVFVdm9YxbSFjhAwMB6+2X28fo/XJBvoXijklEi0079qTQHE40DLiRhB2OnK1FeJs/i27qiY13kdA8vsPCtzhWV1+d1jhJpGPrVBqwSBB9uisE+KwWKnOIMqFjbK6+Uy40Cxz/qra2n57qEyCZKNUEH2MnDIlnaKgr3ETv3Z1obRgGoSPJfqsC+f4cYJMSWthRhGSxTCQ73pB/5DfIOlVERCIV15J1Jq9WbKObjKFdGYm+eROvbE1MWzjiXKvNEHMSB952Q==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 216.228.117.161)\n smtp.mailfrom=nvidia.com;\n 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 216.228.117.161 as permitted sender) receiver=protection.outlook.com;\n client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C", "From": "Bing Zhao <bingz@nvidia.com>", "To": "<orika@nvidia.com>, <aman.deep.singh@intel.com>, <yuying.zhang@intel.com>,\n <dsosnowski@nvidia.com>, <viacheslavo@nvidia.com>, <suanmingm@nvidia.com>,\n <matan@nvidia.com>, <thomas@monjalon.net>, <ferruh.yigit@amd.com>,\n <andrew.rybchenko@oktetlabs.ru>, <dev@dpdk.org>, <rasland@nvidia.com>", "Subject": "[PATCH v2 1/2] ethdev: introduce NAT64 action", "Date": "Wed, 31 Jan 2024 11:38:03 +0200", "Message-ID": "<20240131093804.357465-2-bingz@nvidia.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20240131093804.357465-1-bingz@nvidia.com>", "References": "<20231227090731.2569427-1-bingz@nvidia.com>\n <20240131093804.357465-1-bingz@nvidia.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-Originating-IP": "[10.126.231.35]", "X-ClientProxiedBy": "rnnvmail202.nvidia.com (10.129.68.7) To\n rnnvmail201.nvidia.com (10.129.68.8)", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-TrafficTypeDiagnostic": "MN1PEPF0000F0E4:EE_|MW3PR12MB4586:EE_", "X-MS-Office365-Filtering-Correlation-Id": "f32c02ff-153b-4ef2-bd7e-08dc22406e12", "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 4atTsptpx6y4SvsIw5khuIA+Gs5KbTGaUbtSaMEDYno/GKl/hUVG9HmVw3vkJ6XdtNcagreBFOJ/KZkQONa3SlrqDXWhylDIYPSb6T6XrW+uuYp4cNfp2+Fd4CMOF6al77bvV5ETOfXGfU9yCrpXdfI303EaUoGw7n+O9CNpxf7AAsF22yTb/3WwQAfeS9+6uskuThSMHtng16EKfF+zgKw9ynwelGNwOOK0/SU7uwMku/Ftm8OJue7PtpBndCiFcSUgM5iC+wWiHJH17Jw74rOqSzbLmyRpna3Srh7xxEv4SryAvsoSdslaEyMArkft5FJNT6v/xq7AsHR6CbQhDhVwToR31fwrd6Acl944Di18mK1R4CzknhkPztkI0E3X481z/IX6WcgaqhDpcnPidzGdCT4/WxPkrJhDjTGq0LgwGAYtODIYqdkrC8jcQ5HKPM4iq9CmAxXi+2ZBw/pGO0L35gvUQa8lo6pfQX8UHtFjXR/4ESv70GJl3aJfR+8zlVbSSg7zqgHBQcIv0HUTEB1lyC2Ll9zoJkJTi3C2CtlHm8BGrZUa9DoLG90xTMqYj+5mvz44s3MJNgH2KuyQKqHued42ewGCsN8pcQc41sUntPOSeabXv19V4/xPIc4HV/BkJbOrKotfQIhRlz2Rh0K3PeQRChJQs5KD/0kl5dmhHbEdYa5VD2uZECHu28dhQoHHloOvnReiefy3L2EZxFU44laWFfxOrAv5uWGw9Ao9NSg1wszYAjSxs4NtBYJyfMAaN8YTZQY1TzQxBKg1Z2PthozpH3NKTngyKcpjOMqhNAuCyPQArl5SFwO+YsQKm8oAfTG8vNQbdpWF8vzl8w==", "X-Forefront-Antispam-Report": "CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1;\n SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE;\n SFS:(13230031)(4636009)(376002)(396003)(136003)(346002)(39860400002)(230922051799003)(230173577357003)(230273577357003)(451199024)(1800799012)(82310400011)(186009)(64100799003)(46966006)(36840700001)(40470700004)(41300700001)(83380400001)(47076005)(6286002)(2616005)(426003)(336012)(16526019)(26005)(1076003)(356005)(7636003)(36860700001)(8936002)(8676002)(5660300002)(2906002)(478600001)(966005)(7696005)(70586007)(6666004)(82740400003)(110136005)(316002)(6636002)(70206006)(921011)(86362001)(36756003)(40480700001)(40460700003)(55016003);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "31 Jan 2024 09:38:49.7397 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n f32c02ff-153b-4ef2-bd7e-08dc22406e12", "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.117.161];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-AuthSource": "\n MN1PEPF0000F0E4.namprd04.prod.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "MW3PR12MB4586", "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": "In order to support the communication between IPv4 and IPv6 nodes in\nthe network, different technologies are used, like dual-stacks,\ntunneling and NAT64. In some IPv4-only clients, it is hard to deploy\nnew software and(or) hardware to support IPv6 protocol.\n\nNAT64 is a choice and it will also reduce the unnecessary overhead of\nthe traffic in the network. The NAT64 gateways take the\nresponsibility of the packet headers translation between the IPv6\nclouds and IPv4-only clouds.\n\nThe commit introduce the NAT64 flow action to offload the software\ninvolvement to the hardware.\n\nThis action should support the offloading of the IP headers'\ntranslation. The following fields should be reset correctly in the\ntranslation.\n - Version\n - Traffic Class / TOS\n - Flow Label (0 in v4)\n - Payload Length / Total length\n - Next Header\n - Hop Limit / TTL\n\nThe PMD needs to support the basic conversion of the fields above,\nand the well-known prefix will be used when translating IPv4 address\nto IPv6 address. Another modify fields can be used after the NAT64 to\nsupport other modes with different prefix and offset.\n\nThe ICMP* and transport layers protocol is out of the scope of NAT64\nrte_flow action.\n\nReference links:\n - https://datatracker.ietf.org/doc/html/rfc6146\n - https://datatracker.ietf.org/doc/html/rfc6052\n - https://datatracker.ietf.org/doc/html/rfc6145\n\nSigned-off-by: Bing Zhao <bingz@nvidia.com>\n---\n doc/guides/nics/features/default.ini | 1 +\n doc/guides/prog_guide/rte_flow.rst | 8 ++++++++\n lib/ethdev/rte_flow.c | 1 +\n lib/ethdev/rte_flow.h | 27 +++++++++++++++++++++++++++\n 4 files changed, 37 insertions(+)", "diff": "diff --git a/doc/guides/nics/features/default.ini b/doc/guides/nics/features/default.ini\nindex 6d50236292..4db7e41193 100644\n--- a/doc/guides/nics/features/default.ini\n+++ b/doc/guides/nics/features/default.ini\n@@ -171,6 +171,7 @@ mark =\n meter =\n meter_mark =\n modify_field =\n+nat64 =\n nvgre_decap =\n nvgre_encap =\n of_copy_ttl_in =\ndiff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst\nindex 900fdaefb6..7af329bd93 100644\n--- a/doc/guides/prog_guide/rte_flow.rst\n+++ b/doc/guides/prog_guide/rte_flow.rst\n@@ -3520,6 +3520,14 @@ The packets will be received by the kernel driver sharing the same device\n as the DPDK port on which this action is configured.\n \n \n+Action: ``NAT64``\n+^^^^^^^^^^^^^^^^^\n+\n+This action does the header translation between IPv4 and IPv6. Besides\n+converting the IP addresses, other fields in the IP header are handled as\n+well. The ``type`` field should be provided as defined in the\n+``rte_flow_action_nat64`` when creating the action.\n+\n Negative types\n ~~~~~~~~~~~~~~\n \ndiff --git a/lib/ethdev/rte_flow.c b/lib/ethdev/rte_flow.c\nindex 3f58d792f9..156545454c 100644\n--- a/lib/ethdev/rte_flow.c\n+++ b/lib/ethdev/rte_flow.c\n@@ -271,6 +271,7 @@ static const struct rte_flow_desc_data rte_flow_desc_action[] = {\n \t\t sizeof(struct rte_flow_action_indirect_list)),\n \tMK_FLOW_ACTION(PROG,\n \t\t sizeof(struct rte_flow_action_prog)),\n+\tMK_FLOW_ACTION(NAT64, sizeof(struct rte_flow_action_nat64)),\n };\n \n int\ndiff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h\nindex 1267c146e5..1dded812ec 100644\n--- a/lib/ethdev/rte_flow.h\n+++ b/lib/ethdev/rte_flow.h\n@@ -3051,6 +3051,13 @@ enum rte_flow_action_type {\n \t * @see struct rte_flow_action_prog.\n \t */\n \tRTE_FLOW_ACTION_TYPE_PROG,\n+\n+\t/**\n+\t * Support the NAT64 translation.\n+\t *\n+\t * @see struct rte_flow_action_nat64\n+\t */\n+\tRTE_FLOW_ACTION_TYPE_NAT64,\n };\n \n /**\n@@ -4180,6 +4187,26 @@ rte_flow_dynf_metadata_set(struct rte_mbuf *m, uint32_t v)\n \t*RTE_FLOW_DYNF_METADATA(m) = v;\n }\n \n+/**\n+ * NAT64 translation type for IP headers.\n+ */\n+enum rte_flow_nat64_type {\n+\tRTE_FLOW_NAT64_6TO4 = 0, /**< IPv6 to IPv4 headers translation. */\n+\tRTE_FLOW_NAT64_4TO6 = 1, /**< IPv4 to IPv6 headers translation. */\n+};\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this structure may change without prior notice\n+ *\n+ * RTE_FLOW_ACTION_TYPE_NAT64\n+ *\n+ * Specify the NAT64 translation type.\n+ */\n+struct rte_flow_action_nat64 {\n+\tenum rte_flow_nat64_type type;\n+};\n+\n /**\n * Definition of a single action.\n *\n", "prefixes": [ "v2", "1/2" ] }