From patchwork Fri May 17 08:07:34 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Gavin Li X-Patchwork-Id: 140171 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id DE73B4404A; Fri, 17 May 2024 10:08:14 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 89938402EC; Fri, 17 May 2024 10:08:14 +0200 (CEST) Received: from NAM10-BN7-obe.outbound.protection.outlook.com (mail-bn7nam10on2050.outbound.protection.outlook.com [40.107.92.50]) by mails.dpdk.org (Postfix) with ESMTP id 065EA4029F for ; Fri, 17 May 2024 10:08:13 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cKHMyTO93T+j8ZG1qdJ0xyHiuRwuWQsxYGqTYk1ZSklrEDm5LnW0+iIYScw4QeBYEeDyvPwm8mLPGv66M/OuLz/xjqdXX92ZmlOwaG7SEaDPlweFOPnAsPDy77a6d2onAbdYiOlOlAKd1RrM1XKU3MXqKp5D50HA69cOjwgZeb76kzmdvrh5T1sJuSHdYVmpRbuLG+xF/Mhvo2JdSvbBqqYvaV+6rxM1WP2xJx5bKBHTwPB2w5U/2KbkYMSYsD0qg9HVweyGu3nlU7CfPrUJrZxqFD9c9LIzT5Als48fGuiTqsDmEdnaKN1V7iNrRiFgU+6H9SVVlpnbemC2o0nnQQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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; bh=hKr0Qefib1nugBW70xAXlnsdAz2pex1H7jnnpY65RcU=; b=CLl+S57KmX636IpCk/88skY76o4hnAnudabYSYBl96GVeg5bn+NiQGZRRehRjkGgNoondP1HJf0CsEm1KeWasLwomVwD7Yj1gDefA10E8OJpoj/DkWX8ByRQlzctEpGimqqNJOJE4AiMRB93a/kj4meLyHN544hbu6BS1cCptSIFtySo3gf7OrfZr58I47f/wZb6Ai32EmsseJavfeB1NAnAhf4XUphgxHLQtznIzEkGIFD3UamxDd/1py03J+Gsta2owTA5LP9fGa++FDMgDxujLxuqzVP6xGoTUePGr9F/6px3VKsXE9QdP/glEejXn4+VSZ4otIrzgfGq81o1+Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none (0) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=hKr0Qefib1nugBW70xAXlnsdAz2pex1H7jnnpY65RcU=; b=bvyxlOX19s0gd4VyF/dPndojBqMnAAt5raPDxSYxaVhLuoUzAbm9hsXLPEXXkTYM+5XrPkHFfOaBXtLuBHTI5tURfCq7wGoNxYr/v8eoA9Z+a8bHCEK2d51QiVaPOFMqhtHI009GC2HDRLdZ/c6VIBPgQq0oP9QaPFfVyRcA/2PetuoJyvHASF5pQtb2G5EW046rm43iFOnpU8c5zNmtXFSiFiQwnqLsbifwSiJ5yajVXI7heDIQpXIilEfqZUZiixXrPrgqhrtPm3RGGvQpw68/6uqi7uVq1alUJPwu5YqWugRumWCeNgtFchT/+jOLHKrM80UPtECI+54KyY4vUQ== Received: from BL1PR13CA0027.namprd13.prod.outlook.com (2603:10b6:208:256::32) by SN7PR12MB7835.namprd12.prod.outlook.com (2603:10b6:806:328::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7587.30; Fri, 17 May 2024 08:08:10 +0000 Received: from BL6PEPF0001AB73.namprd02.prod.outlook.com (2603:10b6:208:256:cafe::2c) by BL1PR13CA0027.outlook.office365.com (2603:10b6:208:256::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7611.12 via Frontend Transport; Fri, 17 May 2024 08:08:09 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by BL6PEPF0001AB73.mail.protection.outlook.com (10.167.242.166) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7587.21 via Frontend Transport; Fri, 17 May 2024 08:08:09 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1544.4; Fri, 17 May 2024 01:07:55 -0700 Received: from nvidia.com (10.126.231.35) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1544.4; Fri, 17 May 2024 01:07:52 -0700 From: Gavin Li To: , , , , Ferruh Yigit , Andrew Rybchenko CC: , Subject: [v1 1/2] net: extend VXLAN header to support more extensions Date: Fri, 17 May 2024 11:07:34 +0300 Message-ID: <20240517080735.1787616-2-gavinl@nvidia.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240517080735.1787616-1-gavinl@nvidia.com> References: <20240517080735.1787616-1-gavinl@nvidia.com> MIME-Version: 1.0 X-Originating-IP: [10.126.231.35] X-ClientProxiedBy: rnnvmail201.nvidia.com (10.129.68.8) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BL6PEPF0001AB73:EE_|SN7PR12MB7835:EE_ X-MS-Office365-Filtering-Correlation-Id: e4c18cb4-66a2-42ab-80e4-08dc76487d91 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; ARA:13230031|36860700004|1800799015|82310400017|376005; X-Microsoft-Antispam-Message-Info: =?utf-8?q?W4aqj4+As9Z7ir90bkM1qAy4IFg5uzA?= =?utf-8?q?7PPaQZqPTkaw1B9B1TS6Eu2yp4rM1b3gJHeJh3ZgLmook6WT13P01mo7is8jK1LQa?= =?utf-8?q?GK8vIlbt7sfxNqwtPubc6pjVwNJ2zQ/zEB3ewhQ6Lo2s7qpNGFFdGqmC7aF+y8XIZ?= =?utf-8?q?5arzV8GcsM3hGS1HCl/i6jPG4bPRdu1ey+5Om37byIUw6qToU3pn9A6rSg84wvj8z?= =?utf-8?q?zsWF8PD9NxdxGxEPyHgYAJaY5Q+etVLwNaKm8DyKXkGRFBFH5bGiWl+2+RIayrPI1?= =?utf-8?q?QQS/rSimc1CGCjJvVgU4k0sS4IyAMprc773508+hJMLsdatroPUK9Zzc+7lL8H2od?= =?utf-8?q?w2rOJlmIrEJgisSecMCelwpK+0l2w6VT4H5DY1vxu1DKYW4eQ4PkejjrPr+CdhdZW?= =?utf-8?q?SlEGa7IcOPq+DF7uTNNrJNBq9QeftYJxpfLhWHwdG1wiwDC5KBAta0hRiLSV7QICp?= =?utf-8?q?Li0RyJMDOa+2oRYskARFprr2EA9ZaBJ5LCnmM0xxM8H0FzARBSz5cPqUk7khq+WDV?= =?utf-8?q?oRnql4dCVZGYw52yyWeXm8Ci06u7SgZg0RHuk3MAAdFXZkJZeuN1mZ4Y/YQd/L+vI?= =?utf-8?q?BTOsjjY6uRPiWuQtulCT3L4g3N9+jXLM11sOva4BwCwJQn99CEizLia29osSyPjrM?= =?utf-8?q?Nb1W6LHKetZYDlRvVGjLtp1gIFY6cE+hX9TsQVslUrKIgERxO2Q+cH0lNXrwmwnqG?= =?utf-8?q?VSGtiYUzhRxyVFSk9B8WJh3q8UjYgB/pXyWJTQmr6P7RjEsp7PqNTl0KYyHTt6nlB?= =?utf-8?q?y0XUAbqeZCGjym76VPOeJC62w7MIJJKt9e5hT2UuVMbObzLROXXCkwFyQqVFAeKtd?= =?utf-8?q?beyjgkE9wt+KAPf97vs5VYDoWp/WD4o1rvToL2KUmbtpU5ls7x/1eT/HC5TNRZFEU?= =?utf-8?q?252YTzPIDye/no3joCZnPrXPZbBBf7BOfnhLTXzjZi+7tvr8Z1pMIwHIJFo9ogPVm?= =?utf-8?q?keoZoljADLFVvarhGBlM9nbiCmP1CIuZ6fYgIKn1Y4MguhDOaWlzuw/9w2nOfTcO0?= =?utf-8?q?pv9HC2uyDV6rtXieS/WvTlLfj8TfiQxxXShSLh5P/HQjkO4kqIiwc26/d855K+gL4?= =?utf-8?q?d0E4Ck4EMp4smJFZJxZ9qhtOz5A8JtCZBIZvr+7jFdfnR2IgZPFEiVtZynVOHNZN3?= =?utf-8?q?DGoYipVjzX81WSPGDQwpe4dbz3JsaLA7/y6x+VgZet2xeVIcy1er54HLaoP6nNxv2?= =?utf-8?q?Ap05eWDmQ1cU350wdwwDxTxF01JzuV7xgwudddnkTy1jA0xXZjaTOh8yhLV+B47ft?= =?utf-8?q?lloDJUIrQjwCTQFlspPls5RdvhCtxOx0lVUcBoZlWKrHQ/pxcpqVsqIU=3D?= X-Forefront-Antispam-Report: CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE; SFS:(13230031)(36860700004)(1800799015)(82310400017)(376005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 May 2024 08:08:09.4147 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e4c18cb4-66a2-42ab-80e4-08dc76487d91 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.161]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BL6PEPF0001AB73.namprd02.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR12MB7835 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Currently, DPDK supports VXLAN and VXLAN-GPE with similar header structures and we are working on adding support for VXLAN-GBP which is another extension to VXLAN. More extension of VXLAN may be added in the future. VXLAN and VXLAN-GBP use the same UDP port(4789) while VXLAN-GPE uses a different one, 4790. The three protocols have the same header length and overall similar header structure as below. 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |R|R|R|R|I|R|R|R| Reserved | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | VXLAN Network Identifier (VNI) | Reserved | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 1: VXLAN Header 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |R|R|Ver|I|P|B|O| Reserved |Next Protocol | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | VXLAN Network Identifier (VNI) | Reserved | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 2: VXLAN-GPE Header 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |G|R|R|R|I|R|R|R|R|D|R|R|A|R|R|R| Group Policy ID | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | VXLAN Network Identifier (VNI) | Reserved | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 3: VXLAN-GBP Extension Both VXLAN-GPE and VXLAN-GBP extended VXLAN by redefining its reserved bits, which means the packets can be processed with same pattern and most of the code can be reused. Instead of adding more new items by copying/pasting code for the VXLAN extensions in the future, it’s better to use existing VXLAN infrastructure and add support code in it. In this patch, all the VXLAN extension header will be merged with VXLAN as union if the overlapped field has different format among protocols. The existing VXLAN-GPE will be marked as deprecated and new extensions of VXLAN should be added to VXLAN instead of a new RTE item. Signed-off-by: Gavin Li Acked-by: Thomas Monjalon --- doc/guides/rel_notes/deprecation.rst | 5 ++ lib/ethdev/rte_flow.h | 13 +++++- lib/net/rte_vxlan.h | 69 ++++++++++++++++++++++++++-- 3 files changed, 81 insertions(+), 6 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 6948641ff6..c9c8cf1868 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -91,6 +91,11 @@ Deprecation Notices - ``rte_flow_item_pppoe`` - ``rte_flow_item_pppoe_proto_id`` +* ethdev: The flow item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE`` is replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``. + The item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE``, the struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask``, + and the header struct ``rte_vxlan_gpe_hdr`` with the macro ``RTE_ETHER_VXLAN_GPE_HLEN`` + will be removed in DPDK 25.11. + * ethdev: Queue specific stats fields will be removed from ``struct rte_eth_stats``. Mentioned fields are: ``q_ipackets``, ``q_opackets``, ``q_ibytes``, ``q_obytes``, ``q_errors``. diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index 6e8ab1d4c7..635b291f90 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -355,6 +355,7 @@ enum rte_flow_item_type { RTE_FLOW_ITEM_TYPE_GENEVE, /** + * @deprecated Replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``. * Matches a VXLAN-GPE header. * * See struct rte_flow_item_vxlan_gpe. @@ -1103,7 +1104,11 @@ static const struct rte_flow_item_sctp rte_flow_item_sctp_mask = { /** * RTE_FLOW_ITEM_TYPE_VXLAN. * - * Matches a VXLAN header (RFC 7348). + * Matches a VXLAN header (RFC 7348), including GPE (draft-ietf-nvo3-vxlan-gpe-13.txt) + * and GBP (draft-smith-vxlan-group-policy-05.txt). + * + * GPE is distinguished with its UDP port. + * UDP port may be specified with ``rte_eth_dev_udp_tunnel_port_add()``. */ struct rte_flow_item_vxlan { union { @@ -1346,6 +1351,7 @@ static const struct rte_flow_item_geneve rte_flow_item_geneve_mask = { #endif /** + * @deprecated Replaced with ``rte_flow_item_vxlan``. * RTE_FLOW_ITEM_TYPE_VXLAN_GPE (draft-ietf-nvo3-vxlan-gpe-05). * * Matches a VXLAN-GPE header. @@ -1367,7 +1373,10 @@ struct rte_flow_item_vxlan_gpe { }; }; -/** Default mask for RTE_FLOW_ITEM_TYPE_VXLAN_GPE. */ +/** + * @deprecated Replaced with ``rte_flow_item_vxlan_mask``. + * Default mask for RTE_FLOW_ITEM_TYPE_VXLAN_GPE. + */ #ifndef __cplusplus static const struct rte_flow_item_vxlan_gpe rte_flow_item_vxlan_gpe_mask = { .hdr.vni = "\xff\xff\xff", diff --git a/lib/net/rte_vxlan.h b/lib/net/rte_vxlan.h index 997fc784fc..2f3024a7fe 100644 --- a/lib/net/rte_vxlan.h +++ b/lib/net/rte_vxlan.h @@ -38,11 +38,68 @@ struct rte_vxlan_hdr { rte_be32_t vx_vni; /**< VNI (24) + Reserved (8). */ }; struct { - uint8_t flags; /**< Should be 8 (I flag). */ - uint8_t rsvd0[3]; /**< Reserved. */ + union { + uint8_t flags; /**< Should be 8 (I flag). */ + /* Flag bits defined by GPE */ + struct { +#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN + uint8_t flag_o:1, + flag_b:1, + flag_p:1, + flag_i_gpe:1, + flag_ver:2, + rsvd_gpe:2; +#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN + uint8_t rsvd_gpe:2, + flag_ver:2, + flag_i_gpe:1, + flag_p:1, + flag_b:1, + flag_o:1; +#endif + } __rte_packed; + /* Flag bits defined by GBP */ + struct { +#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN + uint8_t rsvd_gbp2:3, + flag_i_gbp:1, + rsvd_gbp1:3, + flag_g:1; +#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN + uint8_t flag_g:1, + rsvd_gbp1:3, + flag_i_gbp:1, + rsvd_gbp2:3; +#endif + } __rte_packed; + }; + union { + uint8_t rsvd0[3]; /**< Reserved. */ + /* Overlap with rte_vxlan_gpe_hdr which is deprecated.*/ + struct { + uint8_t rsvd0_gpe[2]; /**< Reserved. */ + uint8_t proto; /**< Next protocol. */ + } __rte_packed; + struct { +#if RTE_BYTE_ORDER == RTE_LITTLE_ENDIAN + uint8_t rsvd0_gbp3:3, + flag_a:1, + rsvd0_gbp2:2, + flag_d:1, + rsvd0_gbp1:1; +#elif RTE_BYTE_ORDER == RTE_BIG_ENDIAN + uint8_t rsvd0_gbp1:1, + flag_d:1, + rsvd0_gbp2:2, + flag_a:1, + rsvd0_gbp3:3; +#endif + uint16_t policy_id; + } __rte_packed; + } __rte_packed; uint8_t vni[3]; /**< VXLAN identifier. */ uint8_t rsvd1; /**< Reserved. */ - }; + } __rte_packed; }; } __rte_packed; @@ -52,6 +109,7 @@ struct rte_vxlan_hdr { /** + * @deprecated Replaced with ``rte_vxlan_hdr``. * VXLAN-GPE protocol header (draft-ietf-nvo3-vxlan-gpe-05). * Contains the 8-bit flag, 8-bit next-protocol, 24-bit VXLAN Network * Identifier and Reserved fields (16 bits and 8 bits). @@ -75,7 +133,10 @@ struct rte_vxlan_gpe_hdr { }; } __rte_packed; -/** VXLAN-GPE tunnel header length. */ +/** + * @deprecated Replaced with ``RTE_ETHER_VXLAN_HLEN``. + * VXLAN-GPE tunnel header length. + */ #define RTE_ETHER_VXLAN_GPE_HLEN (sizeof(struct rte_udp_hdr) + \ sizeof(struct rte_vxlan_gpe_hdr))