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 7D48DA034C; Wed, 21 Dec 2022 10:00:53 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 45C5A4114A; Wed, 21 Dec 2022 10:00:52 +0100 (CET) Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12on2080.outbound.protection.outlook.com [40.107.237.80]) by mails.dpdk.org (Postfix) with ESMTP id B469E40698 for ; Wed, 21 Dec 2022 10:00:50 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Gvl1kcjRALAOMBjJJatCXVcLLm9SMZeX2GUnacBMTuUdXYdIpchGsU+3r16tdE4QYN87aZ9jid9iAVe3SpEC8mxoOi8qEhFeSdhprpRgo0DNBuACs0ovGeHwBDYMxdV0cjBRsx/82aBlg5w/+nbW6bg9W/6aZNQf9pOyPDLTFbJd2RZ2/FFl6HO5eBtFBgnx1oB9qhxPxgfnwRG2i3oH0BsrTUPFR+pr8HdaoeYM+6x2vaJkSS1XeEgHceS0RsImCWRHJ/q02vKm9ytFdG7eVuku6H4WKryj3RAhHMXCYvKew+hwjVgs+xZvpo1kklO/1+2GWSwcuz3rMF9cwLe4Lw== 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=QZ1gRgP2J7lopmO6ooGo+nsD/yiX+IPatgjNOhRJQCk=; b=LOMR6CmKdC28+sl+vCYqRW1/KZT4xFhkU3+ncyjq8fzREWGu4IzJCavzXCefweIoz8R9IvY5IqwsZVEqv0AkoDxG/BBNDMFdsFvw2WH+N4lPNvuG+sq68rNRX7zqJS45TgDO6c5Qom+T+KxTQuhghIDGJxCIMeAs6AZBpxQzSx1a6yg+lfAzNlp5CnqzUZAs4Ml+9S0NdoNosBo39V763tQu0LJXNoU3yJGTQuRXEwDyAY5JJDt1jtqpj+U9hBYfktpgyUjuNs/Qu1KTMCX7hcRGcqb3nUcdC7fnRpmM/tnRxXiRFDXXreVN97ZN9HV+7SAegR2ks19Z3usebFl/Mg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) 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=QZ1gRgP2J7lopmO6ooGo+nsD/yiX+IPatgjNOhRJQCk=; b=iHoXY9SmXmlegi9L9NMQRzFiwK3NVCiOwaP6ytEKm3MreCtVx6DMuOdjs23e48SP+emYvI+EVs7o/7EOFxoLZ2777Zh31+EV4jGSgOgf1ZqP6i3XMR1sEB6e9DL1kB7cCkAeX3CJqhJQOMeqTzKFYtHWc56laugGwABgA5fnVpu+roADZ6AOrMqf2Nh1H0yriKhS1mtUYT80vJfNPjsaYfTHNnqg9Z54PYBKEgSZJk3UzFNh3KYrSrJSUMvE7HRPj2myeZI2OOM9GDMVdrURgA6HJL041l4Fafne9z96RuwhfVEritGGfbwIe2FdiL0NAPPEVzWuNF0TSMPH+2uQlQ== Received: from DS7PR03CA0219.namprd03.prod.outlook.com (2603:10b6:5:3ba::14) by DM6PR12MB4281.namprd12.prod.outlook.com (2603:10b6:5:21e::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5924.16; Wed, 21 Dec 2022 09:00:49 +0000 Received: from DS1PEPF0000E630.namprd02.prod.outlook.com (2603:10b6:5:3ba:cafe::52) by DS7PR03CA0219.outlook.office365.com (2603:10b6:5:3ba::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5924.21 via Frontend Transport; Wed, 21 Dec 2022 09:00:48 +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 DS1PEPF0000E630.mail.protection.outlook.com (10.167.17.134) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5944.8 via Frontend Transport; Wed, 21 Dec 2022 09:00:47 +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, 21 Dec 2022 01:00:35 -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, 21 Dec 2022 01:00:32 -0800 From: Rongwei Liu To: , , , , Ferruh Yigit , Andrew Rybchenko CC: , Subject: [RFC v3 1/2] ethdev: add group description Date: Wed, 21 Dec 2022 11:00:16 +0200 Message-ID: <20221221090017.3715030-2-rongweil@nvidia.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20221221090017.3715030-1-rongweil@nvidia.com> References: <20221205215416.7ac53a55@hermes.local> <20221221090017.3715030-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: 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: DS1PEPF0000E630:EE_|DM6PR12MB4281:EE_ X-MS-Office365-Filtering-Correlation-Id: 58c2f73d-0037-48f5-1281-08dae331da37 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: HOmleXKTJ95npbxT1E0xhATGtobsRvh/7/9iDJkvVrih2ktnLkTDJJXVl3Pr5dN8M2MfgD/4rmm5cl133F3+50QxXJwms0oru2pkGXrsZ+UZ3wtIDK4ATEveUxsRkeyY0j36N5GAO7SmuyVSjaExoTZdf4vjCrSfIyNwDWGk7ISdaGsMiMqhQXNqeTw+Puhdu/62ohQE9QQanpUpHF395Fz0tgtm7EytMxm2TorSAVyWitYfU+yiQJOXeMpPMMTZ2KWstGNk/i9fFwQTC+CvU+PXb1Ryme43chr35A7uIEMDTWPULxEn7jcX5YWDWEug8cfxUgGCdk952L3faSTv8HLvE1KPxEMP0AAU92eEGNA2vFl1ZEVJFfCi0nQFV45yU8fVIMHowKzL62kJxV+1AZAMLeAQ8ijRmdliMnMYB0NlDaj1DlpkNHVNF+BysIbbKzgBPltWC80jp5qaw4kg/13yYYz1KUMWfraLG2ppXo6MCpbwGyNFLs2zE2mqRhHZWQipxhBzXn0QCg7wQLPIzJy3sU2Z7j/QihOMDEdhq1T5g3P1LGMz6xHb2LH32DlVy5PbilHZtfIZKeFnByP2HKhx5KXbsiaLEtVwUAgHQDFN9ifeAbCoYscqVTsBtjSbv9RfYDfmeceDuF1b2mjY7fgaPj0xlI1icAVH8Wf2NpWyo+jDaI95tXSa1wKVvwdmpx+j3KQBdHkjJ08aIa1yRg== 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)(346002)(376002)(39860400002)(396003)(136003)(451199015)(46966006)(36840700001)(40470700004)(5660300002)(4326008)(8676002)(6666004)(110136005)(2906002)(54906003)(70206006)(70586007)(107886003)(478600001)(16526019)(186003)(6286002)(26005)(7696005)(41300700001)(316002)(426003)(86362001)(40480700001)(55016003)(82310400005)(47076005)(36860700001)(2616005)(336012)(1076003)(356005)(36756003)(7636003)(82740400003)(8936002)(40460700003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Dec 2022 09:00:47.7947 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 58c2f73d-0037-48f5-1281-08dae331da37 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: DS1PEPF0000E630.namprd02.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR12MB4281 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 | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index b60987db4b..e004e41ac8 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -86,6 +86,21 @@ 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 make sure no dead loop is introduced when organizing + * flow rules and this can be achieved by always jumping to higher group + * number. + * + * 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. */ /** -- 2.27.0