From patchwork Thu Dec 1 08:20:04 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rongwei Liu X-Patchwork-Id: 120411 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 BCB5DA00C5; Thu, 1 Dec 2022 09:20:49 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A9EF342D21; Thu, 1 Dec 2022 09:20:46 +0100 (CET) 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 10FEC42D0D for ; Thu, 1 Dec 2022 09:20:45 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=h8Tw3ba3myeJL1/Z4Oo4wf2X/Au8vQNbKd28KiHya6Lu7g41tMv3AHfDQMX9njao8VSOkCSo5vA1bBxYpz0r95ytufL2W0XfPLSWOVU1VI5GVbB08HGKfcaEN5NDeKSiw+TV8dNE+oW+t/KfBr7KgyqJ5fYhdShUrqo7dSfLbJxMjVULRb95ppAE4sDwuPsN39lDCDvxKJJ4N4Fwspjl6R1NhNylnTcotKsTc5KJLDUTiQUUVHbqdb1G5O1QiwoPn+/sR0ZPSl0b/o/legbKhjqJAdSrnlaW5MkOVBdfIZrH4CiKm6PBbXMx5Zpgc5eutqZmpdx+8dpYk4lOYtH6jw== 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=BsZRyADDK1/x22yyOOen14c3M7sbLV9OmuNg18qeP/I=; b=HA4+UlRPmiPvk6Bz4Tjcm7pxigJ/nP+jESSBKRHOabXK3hs9ApJoV963/FKEoGkf/ovaHJBYgp1lhv89q7Szwa7ElYER1LPpXj6aHfdptZUh1S3Z2rmUKs7eu+eLUbuAz0i/wyfQ+blc7wQJ2/RMswWPUhWcW85R0mola6RpX1Ek23nQvTKDImnPa6PA9zyA8shpOGCUZg6nZZdJeJSlKkto4B1mxg33VdhEaeIwY4BW072mq28FAuzQNVPDBW08VagtGT25hYdpeCgiMzLQ3ZYZXGZ4BGfEp+rGyrmj8HGZpyoSsuC6s21O+w+gzzhOt22yANYf7cmb587iiVh34Q== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) 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 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=BsZRyADDK1/x22yyOOen14c3M7sbLV9OmuNg18qeP/I=; b=iPhlxptlQnFLEJ+PqvtBiElvV6f3hpVPLMDZfo+IznlW71hFELK41zWOinViQmX7ZTt4I2ru/IYzc+Gz1wyBC1vh2xLBv+kdAh5xSpQdwGnmQeTSjPHwo3H6MSUjDSgASuwLw5bhIedjHVB5t7iGPtzeq7Uk3d34qiwmXCa3YCzrwTyGonRsJr5cL0jr5+TYI8OTDXXe8Dh2mcTvguxGzu5gcMFcsCONtbj9AIeE7HyB5ALC4TEkqYAuK/zRQf9wPvql0wJPeNxTj1dR8iPSKWSsN20QgrRNeuuItk12+iFUn4Cpx1dnuFtoOmdgYpPMRw3f26nnl8bbFLzfTKGi6w== Received: from BN1PR10CA0005.namprd10.prod.outlook.com (2603:10b6:408:e0::10) by BN9PR12MB5258.namprd12.prod.outlook.com (2603:10b6:408:11f::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5857.23; Thu, 1 Dec 2022 08:20:41 +0000 Received: from BN8NAM11FT012.eop-nam11.prod.protection.outlook.com (2603:10b6:408:e0:cafe::7d) by BN1PR10CA0005.outlook.office365.com (2603:10b6:408:e0::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.8 via Frontend Transport; Thu, 1 Dec 2022 08:20:41 +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 BN8NAM11FT012.mail.protection.outlook.com (10.13.177.55) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.8 via Frontend Transport; Thu, 1 Dec 2022 08:20:41 +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; Thu, 1 Dec 2022 00:20:24 -0800 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_GCM_SHA384) id 15.2.986.36; Thu, 1 Dec 2022 00:20:21 -0800 From: Rongwei Liu To: , , , , Ferruh Yigit , Andrew Rybchenko CC: , Subject: [RFC 1/2] ethdev: add group description Date: Thu, 1 Dec 2022 10:20:04 +0200 Message-ID: <20221201082005.732252-2-rongweil@nvidia.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20221201082005.732252-1-rongweil@nvidia.com> References: <20221201082005.732252-1-rongweil@nvidia.com> MIME-Version: 1.0 X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: rnnvmail203.nvidia.com (10.129.68.9) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT012:EE_|BN9PR12MB5258:EE_ X-MS-Office365-Filtering-Correlation-Id: 5d3e6d39-4ffe-4dae-3820-08dad374ef8c 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: CksM4Kh4mfcbKWo1u0SMGt4oR3Plrj3CsILD46RUKu7Fr15C91dQ1gRH3aF8LHObrxS0MpYbmAkrTUxAkWZvtgXXVan84vUIdbC0eKm/NmdZ1bRkwsmTmJO2NZrgUHZHDMiCTa16tSdOjXcB8TffOIrwuf38W345D021/87eHOjz3dvABmjc3B8l6cIb/q15NPi8O7fygOQyLUAowjmpU6AzW3V4uwJTB4fr1l1UbEKSSDQM/3A4Pg0QLPmz294TR2jTIEK2C0k3PVXB11NPXFBaVSiw4E+Yiw6AuRqyOJckWHvpyHoe2+4h/JU8m8ovk9RgP8h3ZVQjP2Q5ZVrG/iH+NFXKXAQbVd43+xBAHlUkAUBXYq+oK1LrCsmGU6/QAGpr2iPPX57xGYCjkz/NtrYSgDJlcKsJl2O1SXjLkyVwGVtkOoUIHUfv8AHo/KTvBNN7vSEv6FMhBYQIxEnPXKS7nsS7ZJORQDvJtgt+kktnx0/60VdzUQNfR5KkKr7oBQWHLNywY6GfVABHTgEWlN0Xevj7a3mzw4Z/Pps359R7UmALPy55TtrRugK38cvvb+H4NJy9rgY+daDO6Fzr9fIS3wUEJ9Yh8ulXnHJ1A4Ll3NW98xJ8PXWCuFB7JFHI6k5bZeMN0biQOaH2HWy5j7ue9F/XBSXXp2WPQUHP0AdHoarWmbs2v8D4XkXX+q6y2BfPtfasGiyoazDOo0QO3A== 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:(13230022)(4636009)(396003)(136003)(346002)(39860400002)(376002)(451199015)(46966006)(36840700001)(40470700004)(186003)(16526019)(1076003)(107886003)(2616005)(36860700001)(2906002)(7696005)(6666004)(70206006)(356005)(8676002)(70586007)(41300700001)(40460700003)(82310400005)(36756003)(82740400003)(6286002)(7636003)(478600001)(26005)(40480700001)(47076005)(336012)(8936002)(5660300002)(4326008)(316002)(426003)(86362001)(55016003)(54906003)(110136005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Dec 2022 08:20:41.2926 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 5d3e6d39-4ffe-4dae-3820-08dad374ef8c 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: BN8NAM11FT012.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN9PR12MB5258 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 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 | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index b60987db4b..2443c92c6c 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -86,6 +86,20 @@ extern "C" { * but may be valid in a few cases. */ struct rte_flow_attr { + /** + * Group is a superset of several rules and the user should always + * set the flow rules starting from group 0. Jump action is used + * to find the next rule set by specifying the group ID if matching + * criteria are met. + * The group ID which is to be jumped may be not contiguous with the + * current flow rules' group ID, then the group IDs between them will + * be skipped. + * + * The user should always organize flow rules from lower group to + * higher group number otherwise, the dead loop is expected. + * + * Note: group 0 is shared between kernel and DPDK for bifurcated drivers. + */ uint32_t group; /**< Priority group. */ uint32_t priority; /**< Rule priority level within group. */ /**