From patchwork Tue Jan 18 05:02:11 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexander Kozyrev X-Patchwork-Id: 105989 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 C8087A00C3; Tue, 18 Jan 2022 06:02:45 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7F10741182; Tue, 18 Jan 2022 06:02:45 +0100 (CET) Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2089.outbound.protection.outlook.com [40.107.93.89]) by mails.dpdk.org (Postfix) with ESMTP id 1357F4067E for ; Tue, 18 Jan 2022 06:02:44 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lu4JD/BeYvE06UZZDwmcwrNkI1aNgVKTk0R+OWdwatcmuRgOpzvuUkNb7U+5v9J+D+zc3aeMErTJF55+vT5PNwPcD0PdtdJ6qJNr0vzyHu59aEbeCHK8Aho2U/IBN6PQtdHXxG3+tUEoaJQ67VWmCPDYmUoW5kOQ1rwEpQ/IgrB6q/Qc6YqGSvpM/gaDfpGqhOkauCClSD33Mqnr4oX3LsHAoLavEQvrulyKQhVCHyC7FrLPJMSIB13H59CH72JCRk974L4WDc5Q29rz9LJk9B0rcOTnM5m9NjrOssz/WrTCo+DGU3PVxTcqKf2i4JMmfmuNrWv01rVltT4uiYnobw== 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=k7hoK1hUQ+Jfs1HsGFEk2ojxy5ivkp1d9XBRqUcsvhU=; b=OA8W378eTmUahmEq7MtxQ41bsXa4J2RSMHDmuFSET/+5Qi4smvvjU9/hq46iIqDEyYBEb0FnhCD+PaoQMp/+wVhA9WZ2GVfmPgm5BoyreHnSntrtxG6lf0zpv/PpE6CP19dPdRYFYI2SrG2hDB0162/VPH6M7f3vW59hkw87uwJfwyo+b4xqj983n0+Hnw9PnrOxQEtFol7pK3EF032m9+paoVPjhz3GuxoXryUiaQmrxleszX+z0aOHmCIDCivA1Qjl2ff3RqQDGZTEjbCTINXHuY6oM1slcgFVuBnDnwVwu4m8LXSKBMqTK9AZ+okO2L1qXmyzSYtr7rV9B1hTKA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.234) smtp.rcpttodomain=intel.com 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=k7hoK1hUQ+Jfs1HsGFEk2ojxy5ivkp1d9XBRqUcsvhU=; b=JuUrkYdPsef/8W1YXiRh9CThEkvTBhtK7YqeNCvltB7izub1ygMvDjLzznW5TV6BRw0qUWIoB2r0BzsCDDeoUVFjYRFD45Pw47fG/mOnhoCchvs43C1B9RkMbMwj88wQhG9LNqzAVjhK9upK7bBhZQEokH0urloQaOdgePWQfmJMLmFxTEZFf0I7nHKu4KPG2JSpBw6WG1+MYD1EBuN1lKjk0zykiTu9YaiOFi37+p67yPeDqay+bmPKFck0rNA6TME0+HqcW4oVonY9FWvEQqirnDfESOSQaa1/O8nqPbcgan3SsF/iw5uNyhcC3i28l0SGnsZSaKnKtvc7s9LRDA== Received: from CH0PR12MB5235.namprd12.prod.outlook.com (2603:10b6:610:d2::5) by BN7PR12MB2769.namprd12.prod.outlook.com (2603:10b6:408:2b::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.10; Tue, 18 Jan 2022 05:02:41 +0000 Received: from DM6PR03CA0039.namprd03.prod.outlook.com (2603:10b6:5:100::16) by CH0PR12MB5235.namprd12.prod.outlook.com (2603:10b6:610:d2::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.12; Tue, 18 Jan 2022 05:02:40 +0000 Received: from DM6NAM11FT011.eop-nam11.prod.protection.outlook.com (2603:10b6:5:100:cafe::8d) by DM6PR03CA0039.outlook.office365.com (2603:10b6:5:100::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.9 via Frontend Transport; Tue, 18 Jan 2022 05:02:40 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.234) 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 12.22.5.234 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.234; helo=mail.nvidia.com; Received: from mail.nvidia.com (12.22.5.234) by DM6NAM11FT011.mail.protection.outlook.com (10.13.172.108) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.4888.9 via Frontend Transport; Tue, 18 Jan 2022 05:02:39 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL101.nvidia.com (10.27.9.10) with Microsoft SMTP Server (TLS) id 15.0.1497.18; Tue, 18 Jan 2022 05:02:38 +0000 Received: from nvidia.com (10.126.230.35) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.2.986.9; Mon, 17 Jan 2022 21:02:35 -0800 From: Alexander Kozyrev To: CC: , , , , , , , , Subject: [PATCH 00/10] ethdev: datapath-focused flow rules management Date: Tue, 18 Jan 2022 07:02:11 +0200 Message-ID: <20220118050221.3914960-1-akozyrev@nvidia.com> X-Mailer: git-send-email 2.18.2 MIME-Version: 1.0 X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: HQMAIL107.nvidia.com (172.20.187.13) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 6e52f203-d7ee-4dc6-d1b3-08d9da3fc0a8 X-MS-TrafficTypeDiagnostic: CH0PR12MB5235:EE_|BN7PR12MB2769:EE_ X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr,ExtAddr X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8273; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: vYp/cF16ZxNlZEr//ZiT1y3NOPQQLmAJMR8+IZzcouN8y9qch7OUeYv6qkeLQO/+xA5xnTnkjlGNdSnWCxlwevmREXMZLtixkVOwZPcLFve3/Z3xG6Ofa0QJYnBGtRURFe+ccErdvCFik8UN+BzPoYBfBU88zDbXqvwIvdcnYX7ZYYtZs2XbxyWKuvuWtm94b99wQjwNn3SsM+uh+jc1S9yS5CRvHEzH3ZBMitdmRGjvTzu9znBSwCN5B1eMUf9IYhxPGxeQNCoSJFpczL9PyepRXge4V0M8c+BE3dyOFFp2hl+hwwzf2mTs2wkPV8pByNhEUSt1ndLn23D1zluymLPsM+fnSOCSOF3G1Fh5xZSzSc6HcxJlKpexdAkG5KcDWNG1j+XuKVx0u60qH4O1k7AY7sY0TragIPIXxb2QMFR4T/cwNo0EkbM8veGStyngmDQJgRjvdli8po7N2Gnfc3kgCqqyLISdMfWkKPv+qvmGfa3lMEJXvEqr4B0sCNjShnypXxQsp5gCqiP+TIihKfdmI2PqcmoDZgD8kNELdP/AD60xckm0nysD1ekys0h1oCbxRvscSkLsLEAldQlLbp/SQqWrILybIpwzyW7uUppjVYXq2qstDAdmgKF2YVWq2/NfXWyBCNRkoxw994dRfwWgTzn4b07DYADynIOI76OVrIxE0fSqFrIbU297G9SzwyOoNpJQ+TbpZ2lILjklbXEXTuRhwhIro4g1+fpPBYv1TOh0LAg0NvQcFdaM5I55F8+bkaO/JwhQv9gTD3evSK+BKCh/HHulMVvkh9zAQyGZsl3a/PjWN8JVNgvKH05ycaZhfOQUjvJAvbW9szZpVvvvqRrQ9DLIo/XG+dvDQgZreh/h4fm58fF9xkRANh29 X-Forefront-Antispam-Report: CIP:12.22.5.234; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(4636009)(36840700001)(46966006)(40470700002)(6666004)(70586007)(2616005)(508600001)(5660300002)(4326008)(16526019)(356005)(70206006)(186003)(8676002)(1076003)(426003)(36860700001)(7696005)(8936002)(81166007)(82310400004)(83380400001)(26005)(6286002)(55016003)(54906003)(2906002)(966005)(86362001)(40460700001)(336012)(47076005)(316002)(36756003)(6916009)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Jan 2022 05:02:39.8469 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 6e52f203-d7ee-4dc6-d1b3-08d9da3fc0a8 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.234]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT011.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN7PR12MB2769 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 Three major changes to a generic RTE Flow API were implemented in order to speed up flow rule insertion/destruction and adapt the API to the needs of a datapath-focused flow rules management applications: 1. Pre-configuration hints. Application may give us some hints on what type of resources are needed. Introduce the configuration routine to prepare all the needed resources inside a PMD/HW before any flow rules are created at the init stage. 2. Flow grouping using templates. Use the knowledge about which flow rules are to be used in an application and prepare item and action templates for them in advance. Group flow rules with common patterns and actions together for better resource management. 3. Queue-based flow management. Perform flow rule insertion/destruction asynchronously to spare the datapath from blocking on RTE Flow API and allow it to continue with packet processing. Enqueue flow rules operations and poll for the results later. testpmd examples are part of the patch series. PMD changes will follow. RFC: https://patchwork.dpdk.org/project/dpdk/cover/20211006044835.3936226-1-akozyrev@nvidia.com/ Signed-off-by: Alexander Kozyrev Alexander Kozyrev (10): ethdev: introduce flow pre-configuration hints ethdev: add flow item/action templates ethdev: bring in async queue-based flow rules operations app/testpmd: implement rte flow configure app/testpmd: implement rte flow item/action template app/testpmd: implement rte flow table app/testpmd: implement rte flow queue create flow app/testpmd: implement rte flow queue drain app/testpmd: implement rte flow queue dequeue app/testpmd: implement rte flow queue indirect action app/test-pmd/cmdline_flow.c | 1484 ++++++++++++++++- app/test-pmd/config.c | 731 ++++++++ app/test-pmd/testpmd.h | 61 + doc/guides/prog_guide/img/rte_flow_q_init.svg | 71 + .../prog_guide/img/rte_flow_q_usage.svg | 60 + doc/guides/prog_guide/rte_flow.rst | 319 ++++ doc/guides/rel_notes/release_22_03.rst | 19 + doc/guides/testpmd_app_ug/testpmd_funcs.rst | 350 +++- lib/ethdev/rte_flow.c | 332 ++++ lib/ethdev/rte_flow.h | 680 ++++++++ lib/ethdev/rte_flow_driver.h | 103 ++ lib/ethdev/version.map | 16 + 12 files changed, 4203 insertions(+), 23 deletions(-) create mode 100644 doc/guides/prog_guide/img/rte_flow_q_init.svg create mode 100644 doc/guides/prog_guide/img/rte_flow_q_usage.svg