From patchwork Thu May 18 17:40:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Baum X-Patchwork-Id: 127046 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 95FD542B34; Thu, 18 May 2023 19:40:48 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id CA94742D4B; Thu, 18 May 2023 19:40:43 +0200 (CEST) Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2040.outbound.protection.outlook.com [40.107.93.40]) by mails.dpdk.org (Postfix) with ESMTP id 5153442BDA; Thu, 18 May 2023 19:40:42 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=nyOE73RX2clTNs283RoYf9QAPkuC1IdcUaoTCKfhhkh0fgYc/WfQiFPxHZ8BGsEMwWXvHM2St63Rmj0+18WV95PatNEwWUUe3oEwMD9uqQqSCEALx0lwCnGzBfmqcnF/fQZ7eF/7SSV5Sp67tgOBEdSWpHMkuMkrfv9IFIJ7R91gBZi64z87vzPGkNjSVtFRw9jKuLuqoY5d13HFrNofTTaBkPdpBE7dEjalsFnNFHyq02p2DQZbhKFm5+o2aCngmseoE5/YgKv9TfkDXow7RIHKWz6mPSum5Ho5WnNettLK++0oy6tpXavx0omHA4FiIruUm5L4jpzGe+Kn8llbbA== 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=3627LIotpgp6BILDvCXKuaDznZItiZ4j3jX8U/lQ9/0=; b=mVAzFM+x8mYRShAv5GDNj36DZR3pyg/J5d4Sm2HrEqpexI5Slw8TTDjffdZWZqCrt72jjhGvAF+Ij/UiwLwfQEXAJDow76PVfzZJTst8TnCkLWbOxzwEljvByDWpfuq8QEix0GMMOIcrroej9mIgJ4Rqhch+oojec5w6xyi3lFOTBRrSIhKqGN+uqduwrgVubyD2JnTWxr6QgMbiGgWERg/dhCa4sYid0DE56uslywMgBKv2nAcdeSVZgStiam9xPo5xpH+AL+1vdDrq1ClTt0uHUrkKN/7eD/gRTT9u4/3rKBkFwaqDhYd7+9dPbCaPA2QlumkH8qQ15UvsfwKA3g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.118.233) smtp.rcpttodomain=dpdk.org 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 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=3627LIotpgp6BILDvCXKuaDznZItiZ4j3jX8U/lQ9/0=; b=KXBiY4YUdXpBzwHuku9OoFCbUHet20IRtSqA0dS+/6YofwqMm9Lz//75HcfUKg3trYsoA/gZgLgUIw88daR9GfdpPmmJ9vE7gW5gAtjTY5AdMthnA2Is68LvEAuqXGlwjn1oKXOOF5qahFPfBm7lNusC3eePD+rtxKtLtck5hZoDD5fTcBcWCkDyECEmY3+QPocTQq49JwhJUVTJz2ipDjrsXbNeryYPP8IBCMnSHCBIQadYLAWvZ1OJ7VNy6U4jlWD5JO6RuuDbOIxEyf82dXgDiHZk4EgM0YTxL0v9mlwC7GjSa0E9usCEtZPBrIbHn6GkGFwt1hvlo+St8yan+g== Received: from BY3PR05CA0005.namprd05.prod.outlook.com (2603:10b6:a03:254::10) by CY8PR12MB7268.namprd12.prod.outlook.com (2603:10b6:930:54::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19; Thu, 18 May 2023 17:40:40 +0000 Received: from CO1PEPF000042AC.namprd03.prod.outlook.com (2603:10b6:a03:254:cafe::8e) by BY3PR05CA0005.outlook.office365.com (2603:10b6:a03:254::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6433.6 via Frontend Transport; Thu, 18 May 2023 17:40:40 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.118.233) 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.118.233 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.118.233; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.118.233) by CO1PEPF000042AC.mail.protection.outlook.com (10.167.243.41) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.11 via Frontend Transport; Thu, 18 May 2023 17:40:40 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by mail.nvidia.com (10.127.129.6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Thu, 18 May 2023 10:40:24 -0700 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Thu, 18 May 2023 10:40:23 -0700 Received: from nvidia.com (10.127.8.13) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37 via Frontend Transport; Thu, 18 May 2023 10:40:21 -0700 From: Michael Baum To: CC: Ori Kam , Aman Singh , "Yuying Zhang" , Ferruh Yigit , "Thomas Monjalon" , , Subject: [PATCH v2 1/5] doc: fix blank lines in modify field action description Date: Thu, 18 May 2023 20:40:11 +0300 Message-ID: <20230518174015.3373185-2-michaelba@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230518174015.3373185-1-michaelba@nvidia.com> References: <20230516063747.3047758-1-michaelba@nvidia.com> <20230518174015.3373185-1-michaelba@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1PEPF000042AC:EE_|CY8PR12MB7268:EE_ X-MS-Office365-Filtering-Correlation-Id: f7c232d2-6e37-48de-6c7b-08db57c6ff85 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: vSdxdgajGhktMPqIoEqvK8BdGP6YMgdpT5TRPIEI9gCMQQfsbeaGfvy6fjmnFFoA7OSUdQJmOfT4Pd2AWz8IDjngdfV8h99KKMjG/rG/1ncjMCTa6C6xDCQAAi4BBOEd33uxXx29jomclIQK8CWnbCZ590dnWrSjqTIq62zNcASMGDM+sJRHn6U+hFGfaOVH2exnRXlGG4U96r2qK+PV3JVYesGItk73LGNoLPtZ3P/0KVnvcEemwYtmYeSMXgZu3g3u48I6Bp9FvIrPs+6rnZCxnvGOP3EM279qq4WbL/XQM0eiIonqN7KaXER1FNDmzMggxltmiJhasfd4L9gXrHwlzIEVjHym4kF2hOKDp+87R4o3M47lzZ0uRdmq2Op2T+KpGhIkB6i88auZU1cwaAFym7W5iBsGP2vpnK+vvyHal2N7FEqcUI1MNJjtSNJwbCCcatkmOOMVPZa+bDVy8jyPgHZqH5aoNib3N0fPHSMJloXTF0GRvKbddc1pcRzzVtwA5/CchOh2zGV/99ke865fxqrd7Cnfms+dtvaX7EMBg+5HDfBw+r+qfAX1a5WRQinHzD2obpLiUSnmvVe5efujRgJadz9LoWyYsPeHXluDkoT/3WntS7cybbqqnCKlTBebYI04gz+h2Xn+pFV3dhCmMagcOlyBUg8+xgkD4A+NgI6snodG6n9CZD3d5bwnIvmF8rsCQv2G2zXr5yypH8MMrtlJmGtTKTOtnI2howg= X-Forefront-Antispam-Report: CIP:216.228.118.233; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc7edge2.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(136003)(39860400002)(346002)(396003)(376002)(451199021)(40470700004)(46966006)(36840700001)(2906002)(478600001)(41300700001)(8676002)(316002)(8936002)(54906003)(7696005)(6666004)(70586007)(70206006)(5660300002)(4326008)(6916009)(1076003)(26005)(40460700003)(186003)(6286002)(356005)(55016003)(82740400003)(83380400001)(426003)(36756003)(40480700001)(47076005)(36860700001)(336012)(7636003)(86362001)(82310400005)(2616005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2023 17:40:40.4038 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: f7c232d2-6e37-48de-6c7b-08db57c6ff85 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.118.233]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1PEPF000042AC.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR12MB7268 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 The modify field action description inside "Generic flow API (rte_flow)" documentation, lists all operations supported for a destination field. In addition, it lists the values supported for a encapsulation level field. Before the lists, in both cases, miss a blank line causing them to look regular text lines. This patch adds the blank lines. Fixes: 73b68f4c54a0 ("ethdev: introduce generic modify flow action") Cc: akozyrev@nvidia.com Cc: stable@dpdk.org Signed-off-by: Michael Baum Acked-by: Ori Kam --- doc/guides/prog_guide/rte_flow.rst | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 32fc45516a..e7faa368a1 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -2917,20 +2917,23 @@ The immediate value ``RTE_FLOW_FIELD_VALUE`` (or a pointer to it ``RTE_FLOW_FIELD_START`` is used to point to the beginning of a packet. See ``enum rte_flow_field_id`` for the list of supported fields. -``op`` selects the operation to perform on a destination field. +``op`` selects the operation to perform on a destination field: + - ``set`` copies the data from ``src`` field to ``dst`` field. - ``add`` adds together ``dst`` and ``src`` and stores the result into ``dst``. -- ``sub`` subtracts ``src`` from ``dst`` and stores the result into ``dst`` +- ``sub`` subtracts ``src`` from ``dst`` and stores the result into ``dst``. ``width`` defines a number of bits to use from ``src`` field. ``level`` is used to access any packet field on any encapsulation level -as well as any tag element in the tag array. -- ``0`` means the default behaviour. Depending on the packet type, it can -mean outermost, innermost or anything in between. +as well as any tag element in the tag array: + +- ``0`` means the default behaviour. Depending on the packet type, + it can mean outermost, innermost or anything in between. - ``1`` requests access to the outermost packet encapsulation level. - ``2`` and subsequent values requests access to the specified packet -encapsulation level, from outermost to innermost (lower to higher values). + encapsulation level, from outermost to innermost (lower to higher values). + For the tag array (in case of multiple tags are supported and present) ``level`` translates directly into the array index. From patchwork Thu May 18 17:40:12 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Baum X-Patchwork-Id: 127045 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 46C4D42B34; Thu, 18 May 2023 19:40:42 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 82D7F42D3F; Thu, 18 May 2023 19:40:41 +0200 (CEST) Received: from NAM11-BN8-obe.outbound.protection.outlook.com (mail-bn8nam11on2040.outbound.protection.outlook.com [40.107.236.40]) by mails.dpdk.org (Postfix) with ESMTP id 8311B42BDA; Thu, 18 May 2023 19:40:40 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mg9ZpdQ+qmXBycOPdHG6twCPbv7/DwJrU8mjsajlGl20KNoifMQN7ma5kI86JrNYqoAGMIsp1AFlPpGv4+aObCLQEgMzUDuiGcasuAZvAm+zEJouzZl7NllLaFevlJF/qdxOkzx1WMOXgLyR8y3Nqwn3EU2woQ//gwBEVxHlVGup6GQbs5INqw96lc6K4EFVQ1Ttx2bhMgOTYhuGcfMKiA9YSglRUyBtirfaVcOQUyc+4i1bEd6pLLKBfutEprPddv/MQewqgLURxyFzLXEq/o5Rf49S1PlAxXTvpv7KJHO/DHjivvp1a9NgYR7OIJ5hwBo7p0qFtUuk8Hz4BMbQYQ== 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=/CfZD85Sxp04CRLqu0toRF0GmUg6OTrwIMt0S4eW5bY=; b=Qeoo6wey4B1n43slskg6oVgpidGWXpfsHsOCPcVNvtgHDfOfM2xvoa2eL98XpBmGHlG9hdqPOhiIv+s94Wxo9bHYEGZI1G3QZ07uW1i7leJ/IgPjSZsOFkoYL5ZhKflRg/hjYM5e/sUBnSyqf7k3SNh/ZFMZDm0sXi4lMIgnYI47GTRSVeUymovTjk/VK+H/mSEyLgwhk1ok53jqF9/NaJIZ1cJqORa7NNqpCCAutZmQBrkDo5nRb3WTx8ehBD75sAAwLbELEEyTvS4RypC2dlnMK4VLzttr0+Kj+j5CSu4N+yX6WC9tEjjTkU9cWrlpFf5uytfQZLMJoWTOITp6CA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.118.232) smtp.rcpttodomain=dpdk.org 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 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=/CfZD85Sxp04CRLqu0toRF0GmUg6OTrwIMt0S4eW5bY=; b=N4bpRJXUWjBRJfUaQ8r9nphCaDrWhciKcTdGWRgOFLdDyZjSa13bLZlMPDKHGsbnaZc1l641d/Og0Pi4fsE3md0G7T7CMUOfDvbJvTz6IVQZNrxLlyXkXVsrxRKg/KQNwM+ihh8oKxHVVKlS2uCXoxWnBFDAC4TmTK/0ywy4itbo1j8m4MfrsovkkR4qiHrtr6eHxJoHrfdsGZo5VBk4bNEq0H0QaS/QdOCr0KE8YN9qZFbruRsClwbnKfNgM1nr2xwkdKaenAterCskT5dBOZBakE8tnAWlOYQE1UKWkD7RWOCiIqWBORWusgFxHpRtabkRrZ5h/SnDFL83b8dG1w== Received: from MW4PR04CA0307.namprd04.prod.outlook.com (2603:10b6:303:82::12) by BL1PR12MB5237.namprd12.prod.outlook.com (2603:10b6:208:30b::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.17; Thu, 18 May 2023 17:40:38 +0000 Received: from CO1NAM11FT050.eop-nam11.prod.protection.outlook.com (2603:10b6:303:82:cafe::be) by MW4PR04CA0307.outlook.office365.com (2603:10b6:303:82::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19 via Frontend Transport; Thu, 18 May 2023 17:40:38 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.118.232) 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.118.232 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.118.232; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.118.232) by CO1NAM11FT050.mail.protection.outlook.com (10.13.174.79) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19 via Frontend Transport; Thu, 18 May 2023 17:40:38 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by mail.nvidia.com (10.127.129.5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Thu, 18 May 2023 10:40:26 -0700 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Thu, 18 May 2023 10:40:26 -0700 Received: from nvidia.com (10.127.8.13) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37 via Frontend Transport; Thu, 18 May 2023 10:40:24 -0700 From: Michael Baum To: CC: Ori Kam , Aman Singh , "Yuying Zhang" , Ferruh Yigit , "Thomas Monjalon" , , Subject: [PATCH v2 2/5] doc: fix blank line in asynchronous operations description Date: Thu, 18 May 2023 20:40:12 +0300 Message-ID: <20230518174015.3373185-3-michaelba@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230518174015.3373185-1-michaelba@nvidia.com> References: <20230516063747.3047758-1-michaelba@nvidia.com> <20230518174015.3373185-1-michaelba@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1NAM11FT050:EE_|BL1PR12MB5237:EE_ X-MS-Office365-Filtering-Correlation-Id: 6ce178d1-ee0e-4172-08c5-08db57c6fe66 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: 2ivrx6OX8jeXJnUe247wk4XOCmymBh6lANyBEn4KUXJZ3hUabwTfBgVbq5aicE5gI0H6X3S2+Qz69M8O9Sq1TgsnhPZjNK00sM0M6u9uIVWxYAw0l8eRBpQk6qelGzUiyD3QrMk8caALjdbRi39zUZKPY4R2/3jB4J40Uf0F4a8WmW8vKd+r9x3Ip4UK5Gdyz+lXN+AgH3uMtg2wWTHuWE5E3372S/9UbXYD4LIgRrNFTi5Hwxr8t+mZotOuuhWBz066u8D1FApOwKjTYRCc2QPNzyyQKIyd4RZTjhXJitdPW4Lq5Rl4i6u+CCqErd/tabJDG7JrukkoRETADGV24cmFthC/p5Lrif2Sz8bcGnprULiMFpkGfeLMR7Y+jGLJ5h5q+zTXgY/cLSzwzVjCOGOrgxC2KyTYBGIKPE+X12Ey9y0CbIFqpf4ffBJPXbylJLi2JC0mfs3G05U+DqyPNbvvJFLavpQIyUhh3Km2W0YIDDFaK+sf0OZLG+a47QCfKo9PXCwcqlcEBYF8OXO7ycf/ccRO/+9I47dEvh/soEwXo+JM5RjYqfDdSbWxy2qyHD0VnMoX5G43NzI0CJtVdrqD4AapYJ9FK4H9ldS4SJ0wH39PuR2G18/jilBydv3lDVqt/wYy0y9pFya/TwlLTeHQPsB/xfZwGMlAvPf7Jp5Y/7Dmf+U3LD81jbhS638z5PIaQicx2Cj/LzkYSSjE8vRWrLwuN2OQLXcquu3L94BNGljvk4L3U6vKzprdKtgg X-Forefront-Antispam-Report: CIP:216.228.118.232; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc7edge1.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(396003)(376002)(136003)(39860400002)(346002)(451199021)(40470700004)(36840700001)(46966006)(5660300002)(40460700003)(41300700001)(426003)(2616005)(83380400001)(2906002)(36860700001)(4744005)(336012)(36756003)(47076005)(7636003)(86362001)(82310400005)(356005)(82740400003)(1076003)(26005)(186003)(55016003)(8936002)(8676002)(40480700001)(6286002)(70206006)(70586007)(6666004)(478600001)(7696005)(6916009)(4326008)(54906003)(316002); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2023 17:40:38.5360 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 6ce178d1-ee0e-4172-08c5-08db57c6fe66 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.118.232]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT050.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL1PR12MB5237 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 The asynchronous operations description inside "Generic flow API (rte_flow)" documentation, adds some bullets to describe asynchronous operations behavior. Before the first bullet, miss a blank line causing it to look a regular text line. This patch adds the blank line. Fixes: 197e820c6685 ("ethdev: bring in async queue-based flow rules operations") Cc: akozyrev@nvidia.com Cc: stable@dpdk.org Signed-off-by: Michael Baum Acked-by: Ori Kam --- doc/guides/prog_guide/rte_flow.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index e7faa368a1..76e69190fc 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -3702,6 +3702,7 @@ Asynchronous operations ----------------------- Flow rules management can be done via special lockless flow management queues. + - Queue operations are asynchronous and not thread-safe. - Operations can thus be invoked by the app's datapath, From patchwork Thu May 18 17:40:13 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Baum X-Patchwork-Id: 127047 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 2B5FE42B34; Thu, 18 May 2023 19:40:54 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E1D6F42D50; Thu, 18 May 2023 19:40:46 +0200 (CEST) Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2064.outbound.protection.outlook.com [40.107.223.64]) by mails.dpdk.org (Postfix) with ESMTP id B7B0742D31; Thu, 18 May 2023 19:40:45 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZFldloiSaXPDW5+55HoXf1TvMRlyBmZzEUv6pI6dcMF5HVTgGL7x++oNm0FWvpod3VWE6Glw2iu+9YadhR9+8vxyK51ErIay3Qb6zSTZn6vsxB46Iv/JMJy6N8WEkl4Um9AJaFYsjsIy182MO8XECMHX+lnUjclUIywAn78NuF0XeIVo7l3LXlnyEx8ma4hrGRFEhUdFHwIDZvZ1IhP+xyphGlDC4Xct43VXgthWDjVOstoNitjkI92xoyjF7AGfWF7bmCSf8afQJn62I6TceDlm0GrWrTajOMtj1DL41MKx3BYiiMnt1Xq1jkLxL2z3f/IVM6xwN6l++pY8mnxQSA== 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=/C4uFEHzmRSCszuJIEUQQQ7FdXe11Y50g9A1ubO5JcA=; b=kEh3HEsbMjZsoGLeNKh1IPytc9C26+ShGMPMcKZZf6INSLyAmrm1ksP8YqtxMkzNLTEYD58GV6mowNrjMFpvvoaSQ7Wakid3dnD8fWO+fVRB1fqtP86VLx1Vtb3DsAnLX8EHjEY94D6WfPgs/ocAX7CI2/LLK5nwc7OGmKVz1ySiBuLSK47ORD5ZHaNI0pZCMEUP6r5dLAPMkSc21tzJ8nntZcCs3uGSLcNNgUiapZFRaq2k1k4Ai7R9UjnR6/wdg45gUoUoztQK5rIRnbWlJizUJlc4yn0CRiWMKWWTSZhdpK/CDDs2H04tloKdYK+ZZc3AqwVAtfAF3dQNXyXA1A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.118.232) smtp.rcpttodomain=dpdk.org 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 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=/C4uFEHzmRSCszuJIEUQQQ7FdXe11Y50g9A1ubO5JcA=; b=JhxutDgBk6EWAMtmkEF0y6MiezGODi33xbsLy3bRtGcLuuEDFbwC5hAmals+A3DiSh76j5vgB07OUFE31UuAvccYeg5ITjBJh8Km22IDLoDpjcTqUbneKYBhxCy6cchvhjbbmlQCId4JysQDf+gpXsKL4u3DADEF/4+nGLAwAH4GCbGzteBlCLJN7Y+zQgEkevtXsU+CKLYHLKH8NrOj0+I9y24oVZBKJeCRjLmINZky9KeSCA6KUrZEBBR+m8LA8PrqZ6jqw2igkoDRUKaQaGYu/xrOsNt41RXiylZgWekIzPzxEUyVHtLmd4hrcer9UiOjTyeIRL2r6TmfDMcW6w== Received: from MW4PR03CA0332.namprd03.prod.outlook.com (2603:10b6:303:dc::7) by DS0PR12MB6413.namprd12.prod.outlook.com (2603:10b6:8:ce::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.17; Thu, 18 May 2023 17:40:43 +0000 Received: from CO1NAM11FT043.eop-nam11.prod.protection.outlook.com (2603:10b6:303:dc:cafe::dd) by MW4PR03CA0332.outlook.office365.com (2603:10b6:303:dc::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19 via Frontend Transport; Thu, 18 May 2023 17:40:43 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.118.232) 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.118.232 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.118.232; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.118.232) by CO1NAM11FT043.mail.protection.outlook.com (10.13.174.193) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19 via Frontend Transport; Thu, 18 May 2023 17:40:41 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by mail.nvidia.com (10.127.129.5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Thu, 18 May 2023 10:40:29 -0700 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail203.nvidia.com (10.126.190.182) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Thu, 18 May 2023 10:40:28 -0700 Received: from nvidia.com (10.127.8.13) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37 via Frontend Transport; Thu, 18 May 2023 10:40:26 -0700 From: Michael Baum To: CC: Ori Kam , Aman Singh , "Yuying Zhang" , Ferruh Yigit , "Thomas Monjalon" , , Subject: [PATCH v2 3/5] doc: fix wrong indentation in RSS action description Date: Thu, 18 May 2023 20:40:13 +0300 Message-ID: <20230518174015.3373185-4-michaelba@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230518174015.3373185-1-michaelba@nvidia.com> References: <20230516063747.3047758-1-michaelba@nvidia.com> <20230518174015.3373185-1-michaelba@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1NAM11FT043:EE_|DS0PR12MB6413:EE_ X-MS-Office365-Filtering-Correlation-Id: 57fe5bd4-b737-44ba-f1ff-08db57c70021 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: DguBEcJHPEjXo3OvAPDMi+Ucf5TVtzPARwo8v9uUnEcUNPa4fYiT4jwKaM4kjjXjKoKEMiofkdNUjJQa0x7pRtw7KJIQ6GDo3aC3otxUd/XCLBgsTzWPJIL1/GCCnYsZ4OzEDxDbACIdZtNzPazwgS8QoyBIqtuzRzYXopMa6Xga1NVVBBUZVZPZ3GK1icmxS9odK0xqXJ4mlNT8qLXr3ruY7E/MvT9bnygMAq24KYobFO8qtz+6K++iP4GXxQGcSO8zKh9qBleHUGnTS4IcD6i3LbOnDR66ARr0OG5dXtGUgxk1ekAzyGeH/uRa8goJs5b878/kPcxbrKJJ9Bc7ts/8erF4S1q5jpIyjjafAKX3WkmMI0TAvdtNVFVKiaizUCVqEIJ3pB946rhZd30uoz99RfN/8reUT2JWEjAnSWLAJ2rR1k+25GhQRnBC7Kt0elLSS9v9KHH43Fr3uCqI4XTR9lzeopbqgcn2h+UmZErG1Nou+wc3ownEJ5zpwwWYUnOit367XgGsDYiGGNVYSvBYrWKXHp0J6dyEiuQEpOXG2FvVRQeCKGL+R3TF/T5qDj42XwrnfxnUF1Jn3qviCfgjx7W4eOSZhxPMMC31lgy2YouQX8Qq+E/XOSRXq6LXC6pGP3xY1KvgOHkFH/SwPeHiJMFb8ySIQHdqVyplJOMbUB+0JOea1O/wB11/oyXD9UXCyjPLzoGPxPOb4jTFFwYHw0uhPqlPR7loCdZBcihDseR+oBtZrRhx3Qo1+9km X-Forefront-Antispam-Report: CIP:216.228.118.232; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc7edge1.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(39860400002)(136003)(346002)(396003)(376002)(451199021)(36840700001)(46966006)(40470700004)(40460700003)(1076003)(26005)(7696005)(36860700001)(36756003)(7636003)(2616005)(40480700001)(83380400001)(356005)(86362001)(336012)(426003)(55016003)(82310400005)(47076005)(82740400003)(6286002)(186003)(2906002)(8936002)(478600001)(4326008)(316002)(54906003)(8676002)(70586007)(5660300002)(6666004)(70206006)(41300700001)(6916009); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2023 17:40:41.4452 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 57fe5bd4-b737-44ba-f1ff-08db57c70021 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.118.232]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT043.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS0PR12MB6413 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 The RSS action description inside "Generic flow API (rte_flow)" documentation, lists the values supported for a encapsulation level field. For "2" value, it uses 3 spaces as an indentation instead of 2 after line breaking, causing the first line to be bold. This patch updates the number of spaces in the indentation. Fixes: 18aee2861a1f ("ethdev: add encap level to RSS flow API action") Cc: adrien.mazarguil@6wind.com Cc: stable@dpdk.org Signed-off-by: Michael Baum Acked-by: Ori Kam --- doc/guides/prog_guide/rte_flow.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 76e69190fc..25b57bf86d 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -1954,8 +1954,8 @@ Also, regarding packet encapsulation ``level``: level. - ``2`` and subsequent values request RSS to be performed on the specified - inner packet encapsulation level, from outermost to innermost (lower to - higher values). + inner packet encapsulation level, from outermost to innermost (lower to + higher values). Values other than ``0`` are not necessarily supported. From patchwork Thu May 18 17:40:14 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Baum X-Patchwork-Id: 127048 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 9037042B34; Thu, 18 May 2023 19:41:00 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 39C9D42BFE; Thu, 18 May 2023 19:40:52 +0200 (CEST) Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2084.outbound.protection.outlook.com [40.107.220.84]) by mails.dpdk.org (Postfix) with ESMTP id 42E2442BFE for ; Thu, 18 May 2023 19:40:50 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=McRuJg8St+RnMiKEYywZjL+4zhoytmx712EXs6XeJvv8ADctpFL3keBMsfmym970LoLb6YiQRBpjrTpoglg5Rk2VUM/1yeTK1bpfMyWUS0Tv2ITXLibjLcirImXXENiWFynwasZgyACUQ5rwo88kALpi/zzGSEaDoGG50GlvsgV92a0DA20+v1MoDSdThuk5Z+Zlf7xPfD94Y0Hd+xerlsZuFjqcQLqETYVsDxiSKUHQN0ZVptIvDiWbUdB7ZWEP05Y8UY7ydv/0cjxVRt58mlhcp0YE9gz/HQpBOiU9V1PvJ0uUql81Ni8vdgGkZKxCz/OI+a7HDvq20hZS7Octfg== 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=LWS9IO7WHisZss7AIB/mr8T8g6Rq4kRuMOyZRa+cgng=; b=KUDAaWCWzEAtcaEHA3pRiH61n9A4VQefvfuzBBlss4rVh3ZrrIeRgviKgrfsOrFyc+7y6JM9dcP/Drq59QX017ui8ASviReRIxBs+7lHe7E18sui9MM8SE6m1L70W3aZNaIzg5ydwYLLlIU7eqGaY8Hh/Bpjtoj/XaAN6kqu+opMz5T6TF59et3O2R3NiSQ67gMwAsxVjjpwONR5Csn/xwiG3e+qf2gSLr5zhuiwsh+v84TKoC7WWXbwn+Oe5S5YQ/K4n8MlQ7sr8njVP9dM9itwRwFBtvlWlRog2GtTiyh3yGOEIXojEw7misvQU8g34Td1o4A+tqbSnNxsGC+iFw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.118.233) smtp.rcpttodomain=dpdk.org 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 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=LWS9IO7WHisZss7AIB/mr8T8g6Rq4kRuMOyZRa+cgng=; b=KazqXAYrg+1FAlLKebPElxrgQJbjkYD5V/jYb0xmHkf0wG+jSGdtl5KJBPJ3enepwitRsnFw+e3XoUTNSxMJ0hhVAUru7G72emYd7K1eAraacHLy+SSvgMnacRf+fWtpO0+u6oObVo9fHTsBDmJMLQ4fXRmkqxJdpilo5Ij0uUrCutvMPYnUjuE7KiVt+hb57PbCcBbLRq84ll+WyWVQMiUlRZTgMxIG093F9T0dWKVoJZ0fJSIxk0l70HvbHPrALNSywBRV+J1ETcdzYQTm4LcdU21m3qDhhvbUtNnwJW4AHuE+NkXKnP8OY8lWfw2LzrRkAIqE3oFt6USDexwvTA== Received: from MW2PR16CA0066.namprd16.prod.outlook.com (2603:10b6:907:1::43) by CY8PR12MB8298.namprd12.prod.outlook.com (2603:10b6:930:7c::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19; Thu, 18 May 2023 17:40:48 +0000 Received: from CO1PEPF000042AB.namprd03.prod.outlook.com (2603:10b6:907:1:cafe::b7) by MW2PR16CA0066.outlook.office365.com (2603:10b6:907:1::43) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.19 via Frontend Transport; Thu, 18 May 2023 17:40:47 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.118.233) 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.118.233 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.118.233; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.118.233) by CO1PEPF000042AB.mail.protection.outlook.com (10.167.243.40) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.11 via Frontend Transport; Thu, 18 May 2023 17:40:47 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by mail.nvidia.com (10.127.129.6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Thu, 18 May 2023 10:40:31 -0700 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Thu, 18 May 2023 10:40:30 -0700 Received: from nvidia.com (10.127.8.13) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37 via Frontend Transport; Thu, 18 May 2023 10:40:29 -0700 From: Michael Baum To: CC: Ori Kam , Aman Singh , "Yuying Zhang" , Ferruh Yigit , "Thomas Monjalon" Subject: [PATCH v2 4/5] ethdev: add GENEVE TLV option modification support Date: Thu, 18 May 2023 20:40:14 +0300 Message-ID: <20230518174015.3373185-5-michaelba@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230518174015.3373185-1-michaelba@nvidia.com> References: <20230516063747.3047758-1-michaelba@nvidia.com> <20230518174015.3373185-1-michaelba@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1PEPF000042AB:EE_|CY8PR12MB8298:EE_ X-MS-Office365-Filtering-Correlation-Id: 2d01ce8b-23c1-4f20-1bf3-08db57c703bf 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: /64/61cL9wz8zTE7WyjDsGQ/VEhpZEqMmMRFsPzUmRJNjYCVr/Ua8rWksYETFQrLMsQteWq0p8TtQa3Fwvkyh2HxZTapFl8wmUc71oxnHo3TTP+XqUceEMRIUaW5AU6H0dda2Rk/Ti84NnHCEPdAo3GY36GrrO91nE4MeaJ/mQ9XwgGKBRNPVihIe6n7MJtw5meUUz8AanqINM39X4mJlxsXrRtu81wdO0SGT1qroX90kX5K3Hwoi0cZt2Q5Zy/3KhGjLriIpE5RpNDYqrkklT/lA+pBwzT95SoJtGqQqHzZPy0fuFGWC40ABJSgPuJQRkrvojPhm/hykcEx/0O9ky+w6budkKKiybA/dVJqQPnrffj0zNYdZDtYX11BIdue5oMfsI+LQ9gWz1G14x7r02Ms6dSrePUV0nX2apVl3BDrTbs8XQPGV8xrqCmNuuwQkhd/ItDURLWhRLJIaHagmbdcNbG54VrHjHR3RhN+PAE8ZChuJ7zNtcPCA8G0DGt73paxGoBYkNHlxM0TEz0GeYSb3sexu9iFtCVNyyrDIQo/EPUOt2KodpK07J/NT3vLaaMmzv898Wa/hrPq35U9V9YPR0io1SCdvw51S2xOmF3zptDO2wSX/9JrQQbulixFfwSAtvPLmFFIe/RzqEYFitI4UXFX4GNKqmsAxhrJOowebkr7AuCqP89pYbk2A+UKQ6SLxlJfOWOuM85AwVGbZwJUr34VcshJE3bVtVkyMGoqQ2r/MvYOZVpGFowreL6s7da0XZRkeBoAdgwNeh+vHA== X-Forefront-Antispam-Report: CIP:216.228.118.233; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc7edge2.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(346002)(396003)(376002)(39860400002)(136003)(451199021)(46966006)(36840700001)(40470700004)(26005)(40460700003)(1076003)(7696005)(36860700001)(83380400001)(2616005)(40480700001)(36756003)(47076005)(336012)(426003)(82310400005)(86362001)(356005)(55016003)(82740400003)(7636003)(6286002)(186003)(54906003)(478600001)(30864003)(316002)(2906002)(6916009)(4326008)(8676002)(8936002)(41300700001)(5660300002)(70586007)(70206006)(6666004)(21314003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2023 17:40:47.4927 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2d01ce8b-23c1-4f20-1bf3-08db57c703bf X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.118.233]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1PEPF000042AB.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR12MB8298 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 Add modify field support for GENEVE option fields: - "RTE_FLOW_FIELD_GENEVE_OPT_TYPE" - "RTE_FLOW_FIELD_GENEVE_OPT_CLASS" - "RTE_FLOW_FIELD_GENEVE_OPT_DATA" Each GENEVE TLV option is identified by both its "class" and "type", so 2 new fields were added to "rte_flow_action_modify_data" structure to help specify which option to modify. To get room for those 2 new fields, the "level" field move to use "uint8_t" which is more than enough for encapsulation level. This patch also reduces all modify field encapsulation level "fully masked" initializations to use UINT8_MAX instead of UINT32_MAX. This change avoids compilation warning caused by this API changing. Signed-off-by: Michael Baum Acked-by: Ori Kam --- app/test-pmd/cmdline_flow.c | 48 +++++++++++++++++++++++++- doc/guides/prog_guide/rte_flow.rst | 23 ++++++++++++ doc/guides/rel_notes/release_23_07.rst | 3 ++ drivers/net/mlx5/mlx5_flow_hw.c | 22 ++++++------ lib/ethdev/rte_flow.h | 48 +++++++++++++++++++++++++- 5 files changed, 131 insertions(+), 13 deletions(-) diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c index 58939ec321..8c1dea53c0 100644 --- a/app/test-pmd/cmdline_flow.c +++ b/app/test-pmd/cmdline_flow.c @@ -636,11 +636,15 @@ enum index { ACTION_MODIFY_FIELD_DST_TYPE_VALUE, ACTION_MODIFY_FIELD_DST_LEVEL, ACTION_MODIFY_FIELD_DST_LEVEL_VALUE, + ACTION_MODIFY_FIELD_DST_TYPE_ID, + ACTION_MODIFY_FIELD_DST_CLASS_ID, ACTION_MODIFY_FIELD_DST_OFFSET, ACTION_MODIFY_FIELD_SRC_TYPE, ACTION_MODIFY_FIELD_SRC_TYPE_VALUE, ACTION_MODIFY_FIELD_SRC_LEVEL, ACTION_MODIFY_FIELD_SRC_LEVEL_VALUE, + ACTION_MODIFY_FIELD_SRC_TYPE_ID, + ACTION_MODIFY_FIELD_SRC_CLASS_ID, ACTION_MODIFY_FIELD_SRC_OFFSET, ACTION_MODIFY_FIELD_SRC_VALUE, ACTION_MODIFY_FIELD_SRC_POINTER, @@ -854,7 +858,9 @@ static const char *const modify_field_ids[] = { "ipv4_ecn", "ipv6_ecn", "gtp_psc_qfi", "meter_color", "ipv6_proto", "flex_item", - "hash_result", NULL + "hash_result", + "geneve_opt_type", "geneve_opt_class", "geneve_opt_data", + NULL }; static const char *const meter_colors[] = { @@ -2295,6 +2301,8 @@ static const enum index next_action_sample[] = { static const enum index action_modify_field_dst[] = { ACTION_MODIFY_FIELD_DST_LEVEL, + ACTION_MODIFY_FIELD_DST_TYPE_ID, + ACTION_MODIFY_FIELD_DST_CLASS_ID, ACTION_MODIFY_FIELD_DST_OFFSET, ACTION_MODIFY_FIELD_SRC_TYPE, ZERO, @@ -2302,6 +2310,8 @@ static const enum index action_modify_field_dst[] = { static const enum index action_modify_field_src[] = { ACTION_MODIFY_FIELD_SRC_LEVEL, + ACTION_MODIFY_FIELD_SRC_TYPE_ID, + ACTION_MODIFY_FIELD_SRC_CLASS_ID, ACTION_MODIFY_FIELD_SRC_OFFSET, ACTION_MODIFY_FIELD_SRC_VALUE, ACTION_MODIFY_FIELD_SRC_POINTER, @@ -6388,6 +6398,24 @@ static const struct token token_list[] = { .call = parse_vc_modify_field_level, .comp = comp_none, }, + [ACTION_MODIFY_FIELD_DST_TYPE_ID] = { + .name = "dst_type_id", + .help = "destination field type ID", + .next = NEXT(action_modify_field_dst, + NEXT_ENTRY(COMMON_UNSIGNED)), + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_modify_field, + dst.type)), + .call = parse_vc_conf, + }, + [ACTION_MODIFY_FIELD_DST_CLASS_ID] = { + .name = "dst_class", + .help = "destination field class ID", + .next = NEXT(action_modify_field_dst, + NEXT_ENTRY(COMMON_UNSIGNED)), + .args = ARGS(ARGS_ENTRY_HTON(struct rte_flow_action_modify_field, + dst.class_id)), + .call = parse_vc_conf, + }, [ACTION_MODIFY_FIELD_DST_OFFSET] = { .name = "dst_offset", .help = "destination field bit offset", @@ -6423,6 +6451,24 @@ static const struct token token_list[] = { .call = parse_vc_modify_field_level, .comp = comp_none, }, + [ACTION_MODIFY_FIELD_SRC_TYPE_ID] = { + .name = "src_type_id", + .help = "source field type ID", + .next = NEXT(action_modify_field_src, + NEXT_ENTRY(COMMON_UNSIGNED)), + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_modify_field, + src.type)), + .call = parse_vc_conf, + }, + [ACTION_MODIFY_FIELD_SRC_CLASS_ID] = { + .name = "src_class", + .help = "source field class ID", + .next = NEXT(action_modify_field_src, + NEXT_ENTRY(COMMON_UNSIGNED)), + .args = ARGS(ARGS_ENTRY_HTON(struct rte_flow_action_modify_field, + src.class_id)), + .call = parse_vc_conf, + }, [ACTION_MODIFY_FIELD_SRC_OFFSET] = { .name = "src_offset", .help = "source field bit offset", diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 25b57bf86d..ec812de335 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -2937,6 +2937,14 @@ as well as any tag element in the tag array: For the tag array (in case of multiple tags are supported and present) ``level`` translates directly into the array index. +``type`` is used to specify (along with ``class_id``) the Geneve option which +is being modified. +This field is relevant only for ``RTE_FLOW_FIELD_GENEVE_OPT_XXXX`` type. + +``class_id`` is used to specify (along with ``type``) the Geneve option which +is being modified. +This field is relevant only for ``RTE_FLOW_FIELD_GENEVE_OPT_XXXX`` type. + ``flex_handle`` is used to specify the flex item pointer which is being modified. ``flex_handle`` and ``level`` are mutually exclusive. @@ -2967,6 +2975,17 @@ to replace the third byte of MAC address with value 0x85, application should specify destination width as 8, destination offset as 16, and provide immediate value as sequence of bytes {xxx, xxx, 0x85, xxx, xxx, xxx}. +The ``RTE_FLOW_FIELD_GENEVE_OPT_DATA`` type supports modifying only one DW in +single action and align to 32 bits. For example, for modifying 16 bits start +from offset 24, 2 different actions should be prepared. The first one includs +``offset=24`` and ``width=8``, and the seconde one includs ``offset=32`` and +``width=8``. +Application should provide the data in immediate value memory only for the +single DW even though the offset is related to start of first DW. For example, +to replace the third byte of second DW in Geneve option data with value 0x85, +application should specify destination width as 8, destination offset as 48, +and provide immediate value 0xXXXX85XX. + .. _table_rte_flow_action_modify_field: .. table:: MODIFY_FIELD @@ -2994,6 +3013,10 @@ value as sequence of bytes {xxx, xxx, 0x85, xxx, xxx, xxx}. +-----------------+----------------------------------------------------------+ | ``level`` | encapsulation level of a packet field or tag array index | +-----------------+----------------------------------------------------------+ + | ``type`` | geneve option type | + +-----------------+----------------------------------------------------------+ + | ``class_id`` | geneve option class ID | + +-----------------+----------------------------------------------------------+ | ``flex_handle`` | flex item handle of a packet field | +-----------------+----------------------------------------------------------+ | ``offset`` | number of bits to skip at the beginning | diff --git a/doc/guides/rel_notes/release_23_07.rst b/doc/guides/rel_notes/release_23_07.rst index a9b1293689..ce1755096f 100644 --- a/doc/guides/rel_notes/release_23_07.rst +++ b/doc/guides/rel_notes/release_23_07.rst @@ -84,6 +84,9 @@ API Changes Also, make sure to start the actual text at the margin. ======================================================= +* The ``level`` field in experimental structure + ``struct rte_flow_action_modify_data`` was reduced to 8 bits. + ABI Changes ----------- diff --git a/drivers/net/mlx5/mlx5_flow_hw.c b/drivers/net/mlx5/mlx5_flow_hw.c index 7e0ee8d883..1b68a19900 100644 --- a/drivers/net/mlx5/mlx5_flow_hw.c +++ b/drivers/net/mlx5/mlx5_flow_hw.c @@ -3565,7 +3565,7 @@ flow_hw_validate_action_modify_field(const struct rte_flow_action *action, return rte_flow_error_set(error, EINVAL, RTE_FLOW_ERROR_TYPE_ACTION, action, "immediate value, pointer and hash result cannot be used as destination"); - if (mask_conf->dst.level != UINT32_MAX) + if (mask_conf->dst.level != UINT8_MAX) return rte_flow_error_set(error, EINVAL, RTE_FLOW_ERROR_TYPE_ACTION, action, "destination encapsulation level must be fully masked"); @@ -3579,7 +3579,7 @@ flow_hw_validate_action_modify_field(const struct rte_flow_action *action, "destination field mask and template are not equal"); if (action_conf->src.field != RTE_FLOW_FIELD_POINTER && action_conf->src.field != RTE_FLOW_FIELD_VALUE) { - if (mask_conf->src.level != UINT32_MAX) + if (mask_conf->src.level != UINT8_MAX) return rte_flow_error_set(error, EINVAL, RTE_FLOW_ERROR_TYPE_ACTION, action, "source encapsulation level must be fully masked"); @@ -4450,7 +4450,7 @@ flow_hw_set_vlan_vid(struct rte_eth_dev *dev, .operation = RTE_FLOW_MODIFY_SET, .dst = { .field = RTE_FLOW_FIELD_VLAN_ID, - .level = 0xffffffff, .offset = 0xffffffff, + .level = 0xff, .offset = 0xffffffff, }, .src = { .field = RTE_FLOW_FIELD_VALUE, @@ -4583,12 +4583,12 @@ flow_hw_actions_template_create(struct rte_eth_dev *dev, .operation = RTE_FLOW_MODIFY_SET, .dst = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .src = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .width = UINT32_MAX, @@ -5653,7 +5653,7 @@ flow_hw_create_tx_repr_tag_jump_acts_tmpl(struct rte_eth_dev *dev) .operation = RTE_FLOW_MODIFY_SET, .dst = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .src = { @@ -5677,12 +5677,12 @@ flow_hw_create_tx_repr_tag_jump_acts_tmpl(struct rte_eth_dev *dev) .operation = RTE_FLOW_MODIFY_SET, .dst = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .src = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .width = UINT32_MAX, @@ -6009,7 +6009,7 @@ flow_hw_create_ctrl_regc_jump_actions_template(struct rte_eth_dev *dev) .operation = RTE_FLOW_MODIFY_SET, .dst = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .src = { @@ -6182,12 +6182,12 @@ flow_hw_create_tx_default_mreg_copy_actions_template(struct rte_eth_dev *dev) .operation = RTE_FLOW_MODIFY_SET, .dst = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .src = { .field = (enum rte_flow_field_id)MLX5_RTE_FLOW_FIELD_META_REG, - .level = UINT32_MAX, + .level = UINT8_MAX, .offset = UINT32_MAX, }, .width = UINT32_MAX, diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index 713ba8b65c..f30d4b033f 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -3773,6 +3773,9 @@ enum rte_flow_field_id { RTE_FLOW_FIELD_IPV6_PROTO, /**< IPv6 next header. */ RTE_FLOW_FIELD_FLEX_ITEM, /**< Flex item. */ RTE_FLOW_FIELD_HASH_RESULT, /**< Hash result. */ + RTE_FLOW_FIELD_GENEVE_OPT_TYPE, /**< GENEVE option type */ + RTE_FLOW_FIELD_GENEVE_OPT_CLASS,/**< GENEVE option class */ + RTE_FLOW_FIELD_GENEVE_OPT_DATA /**< GENEVE option data */ }; /** @@ -3788,7 +3791,50 @@ struct rte_flow_action_modify_data { struct { /** Encapsulation level or tag index or flex item handle. */ union { - uint32_t level; + struct { + /** + * Packet encapsulation level containing + * the field modify to. + * + * - @p 0 requests the default behavior. + * Depending on the packet type, it + * can mean outermost, innermost or + * anything in between. + * + * It basically stands for the + * innermost encapsulation level + * modification can be performed on + * according to PMD and device + * capabilities. + * + * - @p 1 requests modification to be + * performed on the outermost packet + * encapsulation level. + * + * - @p 2 and subsequent values request + * modification to be performed on + * the specified inner packet + * encapsulation level, from + * outermost to innermost (lower to + * higher values). + * + * Values other than @p 0 are not + * necessarily supported. + */ + uint8_t level; + /** + * Geneve option type. relevant only + * for RTE_FLOW_FIELD_GENEVE_OPT_XXXX + * modification type. + */ + uint8_t type; + /** + * Geneve option class. relevant only + * for RTE_FLOW_FIELD_GENEVE_OPT_XXXX + * modification type. + */ + rte_be16_t class_id; + }; struct rte_flow_item_flex_handle *flex_handle; }; /** Number of bits to skip from a field. */ From patchwork Thu May 18 17:40:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michael Baum X-Patchwork-Id: 127049 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 4E42D42B34; Thu, 18 May 2023 19:41:06 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4BCB542D4F; Thu, 18 May 2023 19:40:53 +0200 (CEST) Received: from NAM11-BN8-obe.outbound.protection.outlook.com (mail-bn8nam11on2040.outbound.protection.outlook.com [40.107.236.40]) by mails.dpdk.org (Postfix) with ESMTP id 0014F42BFE for ; Thu, 18 May 2023 19:40:50 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IY9wEVLZN5oFBgJOaKQzdvq9kutN4k5c8kfCsBz2V+xv0IOlDacg36iUDSoVdGFoMQ+jsIKdNvmTuiCJL+CWRqLfnzS8uAZ6IRL96cyfWumRN57I20CFdYqjbLWFAS4eHOSlV6vsSl9Eo7p0wzyPq74oXfxnJ3ol484QTcK+IYJfHSMc7pa9lsUeah98O+8RFCwErkndAOk5jKJEzd3UACT1a45u+stNibReeNTRnG1rT9AtGgZyc3ctu9+S5TqJnoskcIW/Z7XtiM51O2xvo96EOaCkh5o0HyK2PmTGYZQP9LEgVr6jQqnYv2ibA6TBbQA0CPb+vUJpCKbGhBk3wA== 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=kz2Qhqb923LJ9zgitOwK4rSwn5MyK9wq3a5dj0e0ruk=; b=Cr2d/iE0ZS1opaFpbGauuCGrR+iFEn7ZGYgicWSO60R2Vvlu3/iSc0o4gBM7HJFNDs/JRKm2F1KN3SVcuz7iyui7bQMumZquGblv/PDuGcSR9dULhwh+csox/jtpH3yizFpBEkzNl35wNdrcbes2pvwUJYiZXeX+6vsAVnhqbtudtDu6TkKyplNtiSF5RvgQTzDCxguWR0Z9unnZNnQJ4odLrpJMunaMC6JdYLY5ut6DAOrsquWLMIGdduSehBtpNYz+jEOTMXDwQ4R1POLqKSREMw2N39iTpw0vIiRt7jUkdN90JqRXfBe3KKBoc3Z4gf9CRdan/+Pp4q9y1XfhGw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.118.233) smtp.rcpttodomain=dpdk.org 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 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=kz2Qhqb923LJ9zgitOwK4rSwn5MyK9wq3a5dj0e0ruk=; b=ay7za0oHZvl6eJQhgcVqP3kaNdKn2fzZV692OFHQvxcJuKEXw/CO/YWnls2c2wRvALwmXwghPCIGFIOPVO3fOM1yi2JHBvy9sa+qyxGBrqX80wVXbTP8IVyeM9x2dA1z6lm3w/LX1/TA0jOer4amLPmmG03aTRmiBRZzV3P3iHbSN/ZtBqvd7zOT46DzVvPFM2iKoERO4CWjSUDT/1yl87yi1OVW+2FZHyCdizmBoywOWyAQKlJDlB5cgxV9jvBKTOgkVaZmFU3Ih0hZ6RFTNHOXkSHiiLLDKekWGua0DJkGhY2hXBMylQ01kjr2OpWylSJfvYmrOd9EtMIArPzbFw== Received: from BYAPR07CA0013.namprd07.prod.outlook.com (2603:10b6:a02:bc::26) by PH7PR12MB5949.namprd12.prod.outlook.com (2603:10b6:510:1d8::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6387.30; Thu, 18 May 2023 17:40:49 +0000 Received: from CO1PEPF000042AA.namprd03.prod.outlook.com (2603:10b6:a02:bc:cafe::c4) by BYAPR07CA0013.outlook.office365.com (2603:10b6:a02:bc::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.20 via Frontend Transport; Thu, 18 May 2023 17:40:48 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.118.233) 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.118.233 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.118.233; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.118.233) by CO1PEPF000042AA.mail.protection.outlook.com (10.167.243.39) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6411.11 via Frontend Transport; Thu, 18 May 2023 17:40:48 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by mail.nvidia.com (10.127.129.6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Thu, 18 May 2023 10:40:33 -0700 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Thu, 18 May 2023 10:40:33 -0700 Received: from nvidia.com (10.127.8.13) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37 via Frontend Transport; Thu, 18 May 2023 10:40:31 -0700 From: Michael Baum To: CC: Ori Kam , Aman Singh , "Yuying Zhang" , Ferruh Yigit , "Thomas Monjalon" Subject: [PATCH v2 5/5] ethdev: add MPLS header modification support Date: Thu, 18 May 2023 20:40:15 +0300 Message-ID: <20230518174015.3373185-6-michaelba@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230518174015.3373185-1-michaelba@nvidia.com> References: <20230516063747.3047758-1-michaelba@nvidia.com> <20230518174015.3373185-1-michaelba@nvidia.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO1PEPF000042AA:EE_|PH7PR12MB5949:EE_ X-MS-Office365-Filtering-Correlation-Id: 8409a92c-ff48-432e-1f3c-08db57c70470 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: bdaVmCeGdqbNrHwyTIdtDMPNjROdvxAKnbXXvYvDVmHS+hUZF6F+dvaXeJ1rjQ2EOfNTH63kpSAXwMUN3HKdXmiB7ZpHQz8N1Xn64yEo70KAvaBeO1+vtMe6dz0/KUe8Zl0j5jO8mVL5whzVfgB0pr1MPHohrGgFka1hDbZZ5qoha3Ue+6re1u5jx/e94N/IYZ1QQtXuq4oQ78qmL2yLdX50eZovlCab508QC1XFW1JeaGn06eGgG2+qgAekwumuc7MHfBcZGDyE4h/66CjAf7DfYhFAPviUK33JmRLnlL8bhb7gzjbFLQlujiZjo9I+g3iFDEZbzDzXQWCSbtnqzvW6vCyKY0+7OMT8UzQfddjxf0+ebAT9GPYAh22r5irZiHY5FEU2XBI9ms0Z/ZOXQXWWaKNtKokUJ5IHP9TjM1kmxvR2HN37//bezi3drGiVSzYCGrKIJOfNe2kIVm/uw4gFnp+Lf7OwGlXHsvJTmorkmUWFpnkq50vw5zGjWboazeiIvJLq4mHZ2e6iIJ9g1vhEOwKD+i988NzKuHv7j7Ir2uIyDaMfOEiHNaTlsiJ/a5Hy25edLFBMK8hqltDGZxiZaO6eX1PWvWgYT9ti/7zLtfuQGVhxoHA82SZ5g/x1dvsQYKVky4XP4ZHWt8B+a1zz0ZQdv83iig2RVO2so+QOSABmwf8zsPnpwy9C036Wskb4lT1k8a/ylvXE8zueHn/NTzMEj+byDgUdWS8SlpXdCZPNQ0BpSVK5JJkX4oaP X-Forefront-Antispam-Report: CIP:216.228.118.233; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc7edge2.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(376002)(136003)(396003)(39860400002)(346002)(451199021)(36840700001)(46966006)(40470700004)(55016003)(6916009)(40460700003)(426003)(6666004)(2616005)(2906002)(54906003)(41300700001)(7696005)(36860700001)(70206006)(83380400001)(70586007)(47076005)(478600001)(8936002)(336012)(26005)(1076003)(186003)(5660300002)(4326008)(6286002)(316002)(8676002)(40480700001)(82740400003)(86362001)(82310400005)(36756003)(7636003)(356005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2023 17:40:48.6841 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8409a92c-ff48-432e-1f3c-08db57c70470 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.118.233]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1PEPF000042AA.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR12MB5949 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 Add support for MPLS modify header using "RTE_FLOW_FIELD_MPLS" id. Since MPLS heaser might appear more the one time in inner/outer/tunnel, a new field was added to "rte_flow_action_modify_data" structure in addition to "level" field. The "tag_index" field is the index of the header inside encapsulation level. It is used for modify multiple MPLS headers in same encapsulation level. This addition enables to modify multiple VLAN headers too, so the description of "RTE_FLOW_FIELD_VLAN_XXXX" was updated. Signed-off-by: Michael Baum --- app/test-pmd/cmdline_flow.c | 24 ++++++++++++++- doc/guides/prog_guide/rte_flow.rst | 12 +++++--- lib/ethdev/rte_flow.h | 49 ++++++++++++++++++++---------- 3 files changed, 63 insertions(+), 22 deletions(-) diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c index 8c1dea53c0..a51e37276b 100644 --- a/app/test-pmd/cmdline_flow.c +++ b/app/test-pmd/cmdline_flow.c @@ -636,6 +636,7 @@ enum index { ACTION_MODIFY_FIELD_DST_TYPE_VALUE, ACTION_MODIFY_FIELD_DST_LEVEL, ACTION_MODIFY_FIELD_DST_LEVEL_VALUE, + ACTION_MODIFY_FIELD_DST_TAG_INDEX, ACTION_MODIFY_FIELD_DST_TYPE_ID, ACTION_MODIFY_FIELD_DST_CLASS_ID, ACTION_MODIFY_FIELD_DST_OFFSET, @@ -643,6 +644,7 @@ enum index { ACTION_MODIFY_FIELD_SRC_TYPE_VALUE, ACTION_MODIFY_FIELD_SRC_LEVEL, ACTION_MODIFY_FIELD_SRC_LEVEL_VALUE, + ACTION_MODIFY_FIELD_SRC_TAG_INDEX, ACTION_MODIFY_FIELD_SRC_TYPE_ID, ACTION_MODIFY_FIELD_SRC_CLASS_ID, ACTION_MODIFY_FIELD_SRC_OFFSET, @@ -859,7 +861,7 @@ static const char *const modify_field_ids[] = { "ipv6_proto", "flex_item", "hash_result", - "geneve_opt_type", "geneve_opt_class", "geneve_opt_data", + "geneve_opt_type", "geneve_opt_class", "geneve_opt_data", "mpls", NULL }; @@ -2301,6 +2303,7 @@ static const enum index next_action_sample[] = { static const enum index action_modify_field_dst[] = { ACTION_MODIFY_FIELD_DST_LEVEL, + ACTION_MODIFY_FIELD_DST_TAG_INDEX, ACTION_MODIFY_FIELD_DST_TYPE_ID, ACTION_MODIFY_FIELD_DST_CLASS_ID, ACTION_MODIFY_FIELD_DST_OFFSET, @@ -2310,6 +2313,7 @@ static const enum index action_modify_field_dst[] = { static const enum index action_modify_field_src[] = { ACTION_MODIFY_FIELD_SRC_LEVEL, + ACTION_MODIFY_FIELD_SRC_TAG_INDEX, ACTION_MODIFY_FIELD_SRC_TYPE_ID, ACTION_MODIFY_FIELD_SRC_CLASS_ID, ACTION_MODIFY_FIELD_SRC_OFFSET, @@ -6398,6 +6402,15 @@ static const struct token token_list[] = { .call = parse_vc_modify_field_level, .comp = comp_none, }, + [ACTION_MODIFY_FIELD_DST_TAG_INDEX] = { + .name = "dst_tag_index", + .help = "destination field tag array", + .next = NEXT(action_modify_field_dst, + NEXT_ENTRY(COMMON_UNSIGNED)), + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_modify_field, + dst.tag_index)), + .call = parse_vc_conf, + }, [ACTION_MODIFY_FIELD_DST_TYPE_ID] = { .name = "dst_type_id", .help = "destination field type ID", @@ -6451,6 +6464,15 @@ static const struct token token_list[] = { .call = parse_vc_modify_field_level, .comp = comp_none, }, + [ACTION_MODIFY_FIELD_SRC_TAG_INDEX] = { + .name = "stc_tag_index", + .help = "source field tag array", + .next = NEXT(action_modify_field_src, + NEXT_ENTRY(COMMON_UNSIGNED)), + .args = ARGS(ARGS_ENTRY(struct rte_flow_action_modify_field, + src.tag_index)), + .call = parse_vc_conf, + }, [ACTION_MODIFY_FIELD_SRC_TYPE_ID] = { .name = "src_type_id", .help = "source field type ID", diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index ec812de335..591e43b5ac 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -2925,8 +2925,7 @@ See ``enum rte_flow_field_id`` for the list of supported fields. ``width`` defines a number of bits to use from ``src`` field. -``level`` is used to access any packet field on any encapsulation level -as well as any tag element in the tag array: +``level`` is used to access any packet field on any encapsulation level: - ``0`` means the default behaviour. Depending on the packet type, it can mean outermost, innermost or anything in between. @@ -2934,8 +2933,9 @@ as well as any tag element in the tag array: - ``2`` and subsequent values requests access to the specified packet encapsulation level, from outermost to innermost (lower to higher values). -For the tag array (in case of multiple tags are supported and present) -``level`` translates directly into the array index. +``tag_index`` is the index of the header inside encapsulation level. +It is used for modify either ``VLAN`` or ``MPLS`` or ``TAG`` headers which +multiple of them might be supported in same encapsulation level. ``type`` is used to specify (along with ``class_id``) the Geneve option which is being modified. @@ -3011,7 +3011,9 @@ and provide immediate value 0xXXXX85XX. +=================+==========================================================+ | ``field`` | ID: packet field, mark, meta, tag, immediate, pointer | +-----------------+----------------------------------------------------------+ - | ``level`` | encapsulation level of a packet field or tag array index | + | ``level`` | encapsulation level of a packet field | + +-----------------+----------------------------------------------------------+ + | ``tag_index`` | tag index inside encapsulation level | +-----------------+----------------------------------------------------------+ | ``type`` | geneve option type | +-----------------+----------------------------------------------------------+ diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index f30d4b033f..34e536d662 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -3740,8 +3740,8 @@ enum rte_flow_field_id { RTE_FLOW_FIELD_START = 0, /**< Start of a packet. */ RTE_FLOW_FIELD_MAC_DST, /**< Destination MAC Address. */ RTE_FLOW_FIELD_MAC_SRC, /**< Source MAC Address. */ - RTE_FLOW_FIELD_VLAN_TYPE, /**< 802.1Q Tag Identifier. */ - RTE_FLOW_FIELD_VLAN_ID, /**< 802.1Q VLAN Identifier. */ + RTE_FLOW_FIELD_VLAN_TYPE, /**< VLAN Tag Identifier. */ + RTE_FLOW_FIELD_VLAN_ID, /**< VLAN Identifier. */ RTE_FLOW_FIELD_MAC_TYPE, /**< EtherType. */ RTE_FLOW_FIELD_IPV4_DSCP, /**< IPv4 DSCP. */ RTE_FLOW_FIELD_IPV4_TTL, /**< IPv4 Time To Live. */ @@ -3775,7 +3775,8 @@ enum rte_flow_field_id { RTE_FLOW_FIELD_HASH_RESULT, /**< Hash result. */ RTE_FLOW_FIELD_GENEVE_OPT_TYPE, /**< GENEVE option type */ RTE_FLOW_FIELD_GENEVE_OPT_CLASS,/**< GENEVE option class */ - RTE_FLOW_FIELD_GENEVE_OPT_DATA /**< GENEVE option data */ + RTE_FLOW_FIELD_GENEVE_OPT_DATA, /**< GENEVE option data */ + RTE_FLOW_FIELD_MPLS /**< MPLS header. */ }; /** @@ -3789,7 +3790,7 @@ struct rte_flow_action_modify_data { RTE_STD_C11 union { struct { - /** Encapsulation level or tag index or flex item handle. */ + /** Encapsulation level and tag index or flex item handle. */ union { struct { /** @@ -3820,20 +3821,36 @@ struct rte_flow_action_modify_data { * * Values other than @p 0 are not * necessarily supported. + * + * @note that for MPLS field, + * encapsulation level also include + * tunnel since MPLS may appear in + * outer, inner or tunnel. */ uint8_t level; - /** - * Geneve option type. relevant only - * for RTE_FLOW_FIELD_GENEVE_OPT_XXXX - * modification type. - */ - uint8_t type; - /** - * Geneve option class. relevant only - * for RTE_FLOW_FIELD_GENEVE_OPT_XXXX - * modification type. - */ - rte_be16_t class_id; + union { + /** + * Tag index array inside + * encapsulation level. + */ + uint8_t tag_index; + /** + * Geneve option identifier. + * relevant only for + * RTE_FLOW_FIELD_GENEVE_OPT_XXXX + * modification type. + */ + struct { + /** + * Geneve option type. + */ + uint8_t type; + /** + * Geneve option class. + */ + rte_be16_t class_id; + }; + }; }; struct rte_flow_item_flex_handle *flex_handle; };