From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by smtp.lore.kernel.org (Postfix) with ESMTP id F20DBC61DA4 for ; Thu, 9 Feb 2023 07:33:29 +0000 (UTC) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 2C9E240DDA; Thu, 9 Feb 2023 08:33:29 +0100 (CET) Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12on2081.outbound.protection.outlook.com [40.107.237.81]) by mails.dpdk.org (Postfix) with ESMTP id 83ECA4067B for ; Thu, 9 Feb 2023 08:33:27 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=N5QafH5Kkc0CZIoJQOMvHnZ/9h+53+ysDqjl9SLVptMLEuUj/E8DkNnxWjbj1F7NQu1AySbBV4OfrC68KvMVVzGNW/hfPLgz+OmtJlHFlmEdOzx2qbTID/fIXrl5n0yij5zLvybybPiIWzVhAGPB9gGUs1/6qeFO+OdT5xS473aedusD4FBVmADYelDokbFvkwOJGXRIy/Oumss7fhcMjui+pYzII1Bur/qGlDsJv7xcz2mpWF/rYXqYK3ryyNoj+XsnrqGYtqTxvMqePnH0yuzB0RP0da37ULtFn2PEHrtMqxPP918tF62ePH84bxa0zQxUCRFyABe5H59QD605vw== 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=RnXhTYLrpmf32MLmPBZdWBw/GqS7CjGkpoELeINWgxo=; b=PlZ7mBs8CIYkZtSLEltbc3jmvIMKlVwXreOC2+Bq9YjzAfWGH7BueVTaXm2BqBwkiJ88L+EPTEIx+Xpob7kfXmVTxfMQBHqH1ksyeTkyU9dnCpVJypGBZhUGxyz5nytyquVcZA4sZPlThZrZGVpKLbl4wPQGRveN+PbKB9QSRNf6x17z0jGcHrCizYcJ/q8Jrv47Kr+70wegtB2BHWODUoLC/36P16hSivMadMjBuZMKnFX6vR1/y3dRDcEDdjiiuRS0N7EzlUDsbCWSHGnnFvG83LyzO9lkZfx9TF70BjOTyy+Qd1X9P2678s5/31rS0oNY9X9ZYBbaEYk7+D21bw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) 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=RnXhTYLrpmf32MLmPBZdWBw/GqS7CjGkpoELeINWgxo=; b=JWzO9R5pcCUpbEtPL4sosX9W+qkvvJV8CdQn13KDlyPd15rdfR3ReslHTlTIJd+l6SRdzZldM8BeIbFMyQoewLZaVDShpb5YgW5dxplRKViqMWhEK7Vd8SAENjnr9bkbdOtOwvhhopV7yAhYb0ftv2FzVVWUgra2dZSfwor37rML78u/WberjgBEEkR6nbgUgBj2esIUjIj2ZE5zIdRWPZesyDPOntQEViJpzbXgPrfup9R5lpLZ4YupUSnWIEQElfUr4Fmf2cZf8ZW5ztBfcgX+/iAZBSWc5wdHHofLnqHgmukqY7t+Ashkl5bdOEIrLmMveZfwkF0rGGOqPy0kdA== Received: from MW2PR16CA0020.namprd16.prod.outlook.com (2603:10b6:907::33) by CH2PR12MB5001.namprd12.prod.outlook.com (2603:10b6:610:61::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.19; Thu, 9 Feb 2023 07:32:57 +0000 Received: from CO1NAM11FT040.eop-nam11.prod.protection.outlook.com (2603:10b6:907:0:cafe::39) by MW2PR16CA0020.outlook.office365.com (2603:10b6:907::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.19 via Frontend Transport; Thu, 9 Feb 2023 07:32:57 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) 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.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by CO1NAM11FT040.mail.protection.outlook.com (10.13.174.140) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.18 via Frontend Transport; Thu, 9 Feb 2023 07:32:57 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Wed, 8 Feb 2023 23:32:51 -0800 Received: from nvidia.com (10.126.230.37) 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.986.36; Wed, 8 Feb 2023 23:32:49 -0800 From: Rongwei Liu To: , , , , CC: , Ferruh Yigit , "Andrew Rybchenko" Subject: [PATCH v6] ethdev: add flow rule group description Date: Thu, 9 Feb 2023 09:32:37 +0200 Message-ID: <20230209073237.3185852-1-rongweil@nvidia.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <6522842a-eed6-33f5-dcaf-503925b3e1a9@amd.com> References: <6522842a-eed6-33f5-dcaf-503925b3e1a9@amd.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.230.37] 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: CO1NAM11FT040:EE_|CH2PR12MB5001:EE_ X-MS-Office365-Filtering-Correlation-Id: cd943fc4-2656-4e88-c0a7-08db0a6fdd49 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: K9au7jTWUialm3pjU/ReSZoQ+Ntffi3v0e/5n78xByyL31+gCAPPvI36D4FF8TM7kM7qs8oM7ztKbUprvpRon7hSVypPvqZtKuFWMfwW3F5wXK1AaZtx07O1hCrU/NuBs19PJ785ocvCALi3+rq1UHkhPJvpYKXK3gTJ1aLHy+BUDWB9LjSZ+kNvFvpqqUEAt7Us1U7LlDLBkG7IMWa1dj3TvYzkPSayz0DIIOGL6zDUsVTWjYy0fk3jNiNeM3gsPiLm7wVtrgc1mTPgygdvumMhqfRSCLfsePfnQvRaD+a4/vs96V6lcwfquVSLtj+BWfI9SA64Sgbtmj7JM76XoTvDDI3Bp4zEmCdHmJx43kSaVQLoJVejnlSz4U59ivv/IriWwqpJ6yS5nlBeA/29PTVwhV34vOojde62RYAMERtlVoz74suRJT5xiubO8oj98icdD2WcE2lsLJIEa/xXTGrxzpe3wAx7cpvVUz2C0yMYdkAEGdABHLLpNXPuzpVlL2plW8wRNSooPqnvX1IPx9Fcok783dZ9L9ueEo4dYm4zgoUScnFMR9KyFgOt5U9EVUIAGU9udkmbvMDD+fYBj9rVouQUtgLOJFWMbh7rmDbu8jZrEd76d1Gms9uMTV9TClerJXn8ixrA1pRGyAR0WyxafxBqQrRMDVG7t75S8U2UXjuf7dV3hc5aAQvOX72y6h1B1g/BjqPfydbFin016A== X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230025)(4636009)(376002)(346002)(396003)(136003)(39860400002)(451199018)(40470700004)(46966006)(36840700001)(6666004)(7696005)(36860700001)(40480700001)(36756003)(82310400005)(2906002)(110136005)(82740400003)(54906003)(316002)(8936002)(41300700001)(5660300002)(7636003)(356005)(336012)(26005)(1076003)(186003)(2616005)(83380400001)(478600001)(55016003)(47076005)(426003)(16526019)(6286002)(4326008)(86362001)(8676002)(40460700003)(70206006)(70586007); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Feb 2023 07:32:57.2209 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: cd943fc4-2656-4e88-c0a7-08db0a6fdd49 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.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1NAM11FT040.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR12MB5001 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 more sentences to describe the group concepts and define group 0 as root group for traffic to search a hit rule. Signed-off-by: Rongwei Liu --- lib/ethdev/rte_flow.h | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index b60987db4b..321cf06fbc 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -86,7 +86,17 @@ extern "C" { * but may be valid in a few cases. */ struct rte_flow_attr { - uint32_t group; /**< Priority group. */ + /** + * A group is a superset of multiple rules. + * The default group is 0 and is processed for all packets. + * Rules in other groups are processed only if the group is chained + * by a jump action from a previously matched rule. + * It means the group hierarchy is made by the flow rules, + * and the group 0 is the hierarchy root. + * Note there is no automatic dead loop protection. + * @see rte_flow_action_jump + */ + uint32_t group; uint32_t priority; /**< Rule priority level within group. */ /** * The rule in question applies to ingress traffic (non-"transfer"). -- 2.27.0