From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 864C44240F; Wed, 18 Jan 2023 16:45:23 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 68D3240223; Wed, 18 Jan 2023 16:45:23 +0100 (CET) Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2073.outbound.protection.outlook.com [40.107.220.73]) by mails.dpdk.org (Postfix) with ESMTP id 9303B400D6 for ; Wed, 18 Jan 2023 16:45:22 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=n0w5zdm7eIg6CQjqxaR3zs9FcQokscyuZFj4D4+xkTLNS7E02pWMaJu8E5XZcDXj4n4YiElvnGvztrGGHwIaoPt/6ffv4TmuauedWoPRngwCNTqY17VTNIdZZEktMxxF+nQunVrwV89IKPObFZ2U7E+RQG/ULIqnfXbBJjwfFz6AO9fPvn22vB8erxaCrSCf4eWmIG8ww/E754qpk7LOQ3fDYoGbVI+7gUFFPU1qYSDxDDZc28CpgVkolte4SdgbZB0XEBwzi5O9dWYbNadupyUQWxgvpHRNE6H3G5ELSNsP4aaGvrypOcC0HH9IrrPo8/yqBwlBP2h9Uvvv03NkjA== 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=hXj2dUrg4IhI9M5LHAjipQZS4eZj/vd0lGYniwVtklg=; b=SYwfwqhO1Vca38006HPKWsqjkplBvZkvAX9BOOyP1Igckbr7L+k1FjnmjFo1RhAstHP6bAjhfPFOyWl6aeUSlgtaYfyHbHJu34vKnoT0q+KG9ggOT1HtmSwGEwnxGzUXxC1qEIe2FH+piM5bXoW0JzneiaCTFFe2PBtQ4Cgspd3G6gvN3d015WNRflW1hLmy46qxRmUoNvWdIapIEVfGzpQIOYHok1Yhy5XKrQByvs2VL2uDqjD+b85FESWFKOubKOV2U48pHFxsWrQubQXMxBTMgEwlMuWWAY17rASvGokgGsj6mYf+8jd2WVXmesVX6jXO1FQVIzzWaKlBjIhLvg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) 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=hXj2dUrg4IhI9M5LHAjipQZS4eZj/vd0lGYniwVtklg=; b=rHKTYIW848dtLBuXnXh5LOprDmwmdOO89fRdcoIJhgCGGz6MdX9swe+fFoeWmcRXi+4P1eG8ekKpK3m9FeCBqUnYvLHitf/CdGvdW42kQCSV4ctvWkrZE2tNBnTu2s9ifzCKcUAI46oCm3LSlRxIbA8FHRMDq9qpKCEAUREhhVR8EZyLIrpMSUw6sx9xSp3uSBC7YEAxGtLpEaRChZLTd/9BPhEimsgNDCdXimxNxPvCLFO40XGWMtPPFQYe5kM+oCQXgssREUVBXCe3aKpCkIdJuWNTyn/HQLucc4eOTxR5VXP2PK0pLK7h4chC/hs0By3WNqNdHFQIaSkPrddbtg== Received: from MW4PR04CA0068.namprd04.prod.outlook.com (2603:10b6:303:6b::13) by DM4PR12MB5360.namprd12.prod.outlook.com (2603:10b6:5:39f::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.24; Wed, 18 Jan 2023 15:45:20 +0000 Received: from CO1NAM11FT061.eop-nam11.prod.protection.outlook.com (2603:10b6:303:6b:cafe::e2) by MW4PR04CA0068.outlook.office365.com (2603:10b6:303:6b::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.19 via Frontend Transport; Wed, 18 Jan 2023 15:45:20 +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 CO1NAM11FT061.mail.protection.outlook.com (10.13.175.200) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.13 via Frontend Transport; Wed, 18 Jan 2023 15:45:20 +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.986.36; Wed, 18 Jan 2023 07:45:04 -0800 Received: from nvidia.com (10.126.231.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, 18 Jan 2023 07:45:02 -0800 From: Rongwei Liu To: , , , , , , CC: , Ferruh Yigit , "Andrew Rybchenko" Subject: [PATCH v4 1/3] ethdev: add flow rule group description Date: Wed, 18 Jan 2023 17:44:44 +0200 Message-ID: <20230118154447.595231-2-rongweil@nvidia.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20230118154447.595231-1-rongweil@nvidia.com> References: <20221221090017.3715030-2-rongweil@nvidia.com> <20230118154447.595231-1-rongweil@nvidia.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.231.37] 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: CO1NAM11FT061:EE_|DM4PR12MB5360:EE_ X-MS-Office365-Filtering-Correlation-Id: 60a9a72a-8609-40d3-17c2-08daf96b0121 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: kSSRNg4f+Bg76k3LG2IhpeizwNyNVphFJTEIRpMe96CiKfY1zyU+2QpmGlgdpTrl3Fc9cNZL8cNGk1Sd+Qo+uyNTbL3loyBFQ9N54nqbhceknNx85pbaiuso21LRLoZdsb/mGDvOBN3qUBkgEgGLpxZFf0ra/JXFNjO6oH6OPwTgESMife7aD/I6PfwmBWKcRXVhBiNwKvD9OsuCEjj0kk6GC2T9Op53C8s2QF1jiwJmFojc2XId2zPSVLbBSGiX/PT2WHJ/ZuyWma8qijhTRgwH+NsrVi2qLCeAVwAi1Mxw/liqzANF7QTCkUL45cfCd+EiiWOdUrfWeJJLbkrLZ8C6RyuKxLFLkCrCw4qGKLn9WjWb6tQ7Op0iBZvboP0e/tgkBG0lxqXoabAwlcZfVhhh/MXUeES7Dek+n2mhwKZf8McKV9SRi+OeiCgSDYB5WlNlIybUARbK7s9JNO3kKVpmrivZGApa++gQzzcPc+NCFt7Z61QbTnzPQvNUiJcK6COk+v8hLGx8kpCdskhhIVJhXPtHRYl4ixuJgreJpuwd7yhMuWRO7Y1mMzNqmePFXV1PMOuWG7iGRkEzXlZ0HQZjPZ/25zFbVzFUqPU8u5B7Af4m6EaFYJHPMdABvhcJsuCIyvwnG0YNREqzKR3xE5+znM/15gxyn7saIIcCTKhiFggZRrU5rHH7G2Hhmh7YKqdgrB5N5c5TDmWGZjQeIg== 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:(13230022)(4636009)(396003)(346002)(136003)(376002)(39860400002)(451199015)(36840700001)(46966006)(40470700004)(7636003)(82740400003)(36860700001)(356005)(86362001)(5660300002)(8936002)(70206006)(2906002)(55016003)(70586007)(40480700001)(4326008)(8676002)(41300700001)(82310400005)(26005)(2616005)(40460700003)(1076003)(83380400001)(6286002)(186003)(336012)(16526019)(47076005)(426003)(316002)(54906003)(6666004)(110136005)(7696005)(478600001)(36756003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Jan 2023 15:45:20.0547 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 60a9a72a-8609-40d3-17c2-08daf96b0121 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: CO1NAM11FT061.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR12MB5360 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 | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index b60987db4b..e71ac0c199 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -86,7 +86,18 @@ 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. + * The group 0 of bifurcated drivers is shared with the kernel. + * 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