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 5CD3EA0548; Wed, 19 May 2021 18:56:24 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id D036340041; Wed, 19 May 2021 18:56:23 +0200 (CEST) Received: from NAM10-BN7-obe.outbound.protection.outlook.com (mail-bn7nam10on2063.outbound.protection.outlook.com [40.107.92.63]) by mails.dpdk.org (Postfix) with ESMTP id D74C64003F for ; Wed, 19 May 2021 18:56:21 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=LHYeEgfSVpxDPffUNNCAneT/h11MlWMa94+Wjs/gDEWXdm0rgaYxjgkrI1SzwrOopCD9dUMKcm3Wci++G9oW4pTFHHX5VFEAKcahxQ5gJTakh52uxBcJ3JZRFw+kXPc8A4sRkG9m8b8myAePQQJTTYAf4j56twMNZfPasAJCJW720Y8/ON4GYxwH+Cl2y4pxaVFYuZ2B6+GluN5BqIGLOw3naPauW407ylX56d5OlviUTbYj+92iFC4lUKy2K8fUMapk7hskmus59QKxC1i7H2p3aEp6vY1J1EZh9T6E3ur1ZhB8X5VhyuzcUurfpGm+OYMblc5X/WqWovEJv2US+Q== 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-SenderADCheck; bh=Dk5ZYvvX6p62mfd+vDeypI0N+LIAHVETIpKcL4a0nz4=; b=P8pCyzsgJ3bm0/8k4Db9ejCu0MFaNVUBh0zCZPQ6n+RDYkQrWNBQyMmjh69zbeEV2CpZc1NV035To8OEmkjE6UeFE4nD/GTjjFmUlTts8YkOF28k7Jk8S3PJyiy2EkMrzPzqnYqEBqDuQLBt/rz0EYf8sPrOuCG9ZHrfquiuxYoB91NiEB0WgBJXqH8dJFiRgC3X5FywZm0RdczeXCd0NCr391O4lQ5RrNKxs39j8ky8wsHnL8N/GajvHJTDPxuG3is9L+Pl1C4+ePmS1uKjICjtk4Gq9NOsYoBin0GaIZM/sx3+i+OlLPo7nbZoJ2K/B1Kp8uHRiPqHVPSkVRbvNQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; 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=Dk5ZYvvX6p62mfd+vDeypI0N+LIAHVETIpKcL4a0nz4=; b=YJ8dCpomFvj+CGvn7xGnVVeSnXuiVAGSIdSjO1lkmWQLfMLniUHsZDfh+J3vAa0nbXA8GK2fudCQ0AhGV1j8GB3EY/8FgmsSfbi8RlK4WwINFoKG8XAYiitIz8azCiKn+LEGR0h81DfO2jdTYg57sg0a9ZGwaFTFGr/UBdLp/Ny+w57hKKJ+lPEkPyUHyAthX/Y8/DKNY1BoKSNUlClU77h56PsJTIqcbNYDZmp48JMZOiF7c/h3f+54DaWatvcv4hls6SrVU1p3L6pmvD1OjfbtdAxoau48UZkS98ng8qKmXXUB6GspSVe6UvMNQxn+A+iRDwyCE8TeaoyDd1OQlQ== Received: from BL1PR12MB5335.namprd12.prod.outlook.com (2603:10b6:208:317::19) by BL1PR12MB5349.namprd12.prod.outlook.com (2603:10b6:208:31f::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4129.25; Wed, 19 May 2021 16:56:20 +0000 Received: from BL1PR12MB5335.namprd12.prod.outlook.com ([fe80::f461:6348:5b36:a055]) by BL1PR12MB5335.namprd12.prod.outlook.com ([fe80::f461:6348:5b36:a055%5]) with mapi id 15.20.4129.034; Wed, 19 May 2021 16:56:20 +0000 From: Ori Kam To: NBU-Contact-Thomas Monjalon , "dev@dpdk.org" Thread-Topic: [PATCH] doc: remove obsolete future considerations in flow guide Thread-Index: AQHXJLvzrwkm5AGFz0uuMLkcZHpl9qrrVcew Date: Wed, 19 May 2021 16:56:20 +0000 Message-ID: References: <20210329165214.668793-1-thomas@monjalon.net> In-Reply-To: <20210329165214.668793-1-thomas@monjalon.net> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: monjalon.net; dkim=none (message not signed) header.d=none;monjalon.net; dmarc=none action=none header.from=nvidia.com; x-originating-ip: [147.236.145.254] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 53e53a9b-d19b-40ca-a439-08d91ae706e0 x-ms-traffictypediagnostic: BL1PR12MB5349: x-ld-processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: jxf+S3Wb9Zom3BR3eU/xG9YEHVe3qKtkYIBNwaihSEEt5VGSbHE8ICW5jF9EFHBBPstbWyxVEs+wDpnj1Fkm0tkqM64nlH1VXC5Vh23ADUGYbRWrPCCVdUqZKmoysSXzTV3GyhpYPEGMyg9b2s5VHVZ1ZtfQEsk7JuSP3L1Hfg/3V65OPvyjZCd0VtUfXluwaJWTRuA7buB0QoFSZj3Qd/xRhtLM7g2z8mDbObNYzjzQehwvotGI3zKnaQWtBZeM6tdLSQZj3q2aLBVJdKkJMCMoyz2hBLnP0cjrLu5T60eMejKURi+kP6Yqmr7zATyAPV3ZTxHRfTFqLnQLVMwEGDAV/Sq2s7Wig3LUmVeAOXqQ3MJ+H2L0bqCgIQ5wTZkCJXkAzeYUMBZVLo0uCIfIX6QD0Wb+2I3TamfymQs1h8k5rsnE3WUttD4zyKu3LkB12KgUqn+KS5z/a6TkeTg6zocABY+FW5XmntjP2hPS4mtyNEhgMRSLKaXzkxpdjp8/o3P3GVc03w1RNZVeMT3AGFSNEU31u0rY00dkHnFwEoFlPbZLHrsWwZVukQRXxTXVzNkl31EwhafBCdADjbCrgRbkJqtwulD1qiryiIhPbkJY38HTZjpWexxutPuszuCBPaBefuM8KNDTArG5S++q0AKbsmpMUqwA39LHWFsxc0ejmzIh4VpYUOdoFuOiwyWM x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BL1PR12MB5335.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(376002)(346002)(396003)(39860400002)(366004)(136003)(966005)(478600001)(186003)(33656002)(66946007)(86362001)(45080400002)(66476007)(8936002)(2906002)(64756008)(316002)(76116006)(5660300002)(66556008)(7696005)(66446008)(26005)(71200400001)(9686003)(52536014)(55016002)(110136005)(38100700002)(6506007)(122000001)(8676002)(83380400001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: =?us-ascii?Q?AvlyL1htu0sdw34POrJiQxOOytjJbZl4m6DDDBAX6qPdNiWAW/60MDDs+Hpj?= =?us-ascii?Q?4BU214evmBbG2tv4IXDpeNcO6HXjXmDsN9xpmV567L17uR4LZWUSNFwtJuhu?= =?us-ascii?Q?VZhW1ZM/ot7LT4L7wxImSPWPSesto2kUo0VWfqZA5e9hh+aqH0wWK8OcJHuB?= =?us-ascii?Q?FXAwGsP71SVSYCsVF57ddITj3cdPdcu09noHzHYEbZfymm5xj3BOL4juKDcJ?= =?us-ascii?Q?WQuI4qVuNmbtXGYns5JBmTEZprnAF9is0TWtl8roPZ+yLmLNMW802RREPpRQ?= =?us-ascii?Q?j7H8HKeHyaLJubj/N6eaT9a92sGxqtMFLjS1yKRUfEzXw5W8bI1qBq94YtLj?= =?us-ascii?Q?9sNT0IpgggYKYFw5qONbLgVYID3Mc3l45V/kwn28MMAzGzQCQtlPE/Npxnpv?= =?us-ascii?Q?laXf1i3yqtZEfmtD4wK5NFVeR148jhJzEsB/WZCio9fg2CwC5kMNhu2jdHQ/?= =?us-ascii?Q?QQDtwb8qjEf69dy8zXwv7SjF81tINULa2Wm+1yl4CClAMNtWlYh7Ek+aSfqM?= =?us-ascii?Q?sr1ICzU13kbKBgJNabnSeqrZz5lDOZmFu87Y6WUbZqhrd/05HMqpyg5HUh1+?= =?us-ascii?Q?svWpzHGstVDjt4VFbqFH+Lfj7xzrn3G+ZsfptdY8QjvHhuCkFED5ZWQB5UHa?= =?us-ascii?Q?RNY0tCijjH/co/51q26l1ZNkuuN0KoBLM7F3v+ALjzZjppn/NvzO6aEu4E8K?= =?us-ascii?Q?y9aKyXYG9qZEOKbhEp/DlI4oLpY30brhcZWoGrFYWW3RNOV6TggQVHK3QxEb?= =?us-ascii?Q?tMrvc05aOedD3dsAeUEH+YTn9hkkO+QyGTzjJwRXPTPIx+sO9Ytwjo3BS1JA?= =?us-ascii?Q?6IN8bkj88VvAvgXV1t0HE0mGcBlyB8rZQ3eoS4zkiGybtPsZXOj9qBQBWgM3?= =?us-ascii?Q?myJcGfD2j1k9Kzi68JeUGfDFkkjKszrCKeYO+xaXW9dFX4Fn8YZYc5rEVqqs?= =?us-ascii?Q?NI6FC9NYlKgX9l9Ta0aObkIEAuNGekojwXe2dUcdQzEKsjmyJBsFLLF2kgWH?= =?us-ascii?Q?LICQaUU1AP6IqBE9UbBXJP/kAZme5+ipNH26ec0mXglHe1W/QdWIUcG137qp?= =?us-ascii?Q?uWvKiNgH9udPMs7wxn68Rp5rCnutlqNcWcHfm4PoL+tjjtVFcffjU16sSpJQ?= =?us-ascii?Q?hO/3ZpAYXzVfZhdQcXldXR+RguuwP4KcvF3pjOr7/pZxJfQ7czP2R54rGH3m?= =?us-ascii?Q?TE0RIipbRwduZhVMBw3rWCmE+xTf2qNSsaqRS7XOkRvXwBZXG+OZttTng5h7?= =?us-ascii?Q?wFRfzKOUsF5jKc5bBfOLUb0wsGtwuIDWiTFTQZaQPUwT9fc9fA9YdhzsAMq0?= =?us-ascii?Q?peb5Sd8YMdrKaw6GPukdZ1y/?= x-ms-exchange-transport-forked: True Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: BL1PR12MB5335.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 53e53a9b-d19b-40ca-a439-08d91ae706e0 X-MS-Exchange-CrossTenant-originalarrivaltime: 19 May 2021 16:56:20.3773 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 7FS+Glk+STcoJF4ntwbuJP0S/O8ze9IRaJTYUNfRIarI3PHjVqDujQKiupze16YU7z50aILCzyUEt6H07PdV8w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL1PR12MB5349 Subject: Re: [dpdk-dev] [PATCH] doc: remove obsolete future considerations in flow guide 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 Sender: "dev" Hi Thomas, > -----Original Message----- > From: Thomas Monjalon > Subject: [PATCH] doc: remove obsolete future considerations in flow guide >=20 > After 4 years, rte_flow has evolved enough to not require special notes > about what could be added in future. > Part of the removed plans were obsolete anyway. >=20 > Signed-off-by: Thomas Monjalon > --- > doc/guides/prog_guide/rte_flow.rst | 38 +----------------------------- > 1 file changed, 1 insertion(+), 37 deletions(-) >=20 > diff --git a/doc/guides/prog_guide/rte_flow.rst > b/doc/guides/prog_guide/rte_flow.rst > index 62a57919eb..c6cef43bdd 100644 > --- a/doc/guides/prog_guide/rte_flow.rst > +++ b/doc/guides/prog_guide/rte_flow.rst > @@ -719,9 +719,6 @@ Most of these are basically protocol header > definitions with associated bit-masks. They must be specified (stacked) = from > lowest to highest protocol layer to form a matching pattern. >=20 > -The following list is not exhaustive, new protocols will be added in the= - > future. > - > Item: ``ANY`` > ^^^^^^^^^^^^^ >=20 > @@ -1523,8 +1520,7 @@ that VOID is ignored. > Action types > ~~~~~~~~~~~~ >=20 > -Common action types are described in this section. Like pattern item typ= es, - > this list is not exhaustive as new actions will be added in the future. > +Common action types are described in this section. >=20 > Action: ``END`` > ^^^^^^^^^^^^^^^ > @@ -2854,19 +2850,6 @@ A method to generate them remains to be > defined. > Application may use PMD dynamic items or actions in flow rules. In that = case > size of configuration object in dynamic element must be a pointer size. >=20 > -Planned types > -~~~~~~~~~~~~~ > - > -Pattern item types will be added as new protocols are implemented. > - > -Variable headers support through dedicated pattern items, for example in= - > order to match specific IPv4 options and IPv6 extension headers would be = - > stacked after IPv4/IPv6 items. > - > -Other action types are planned but are not defined yet. These include th= e - > ability to alter packet data in several ways, such as performing - > encapsulation/decapsulation of tunnel headers. > - > Rules management > ---------------- >=20 > @@ -3361,8 +3344,6 @@ so the API level protection is disabled. > Please note that this API-level mutex protects only rte_flow functions, > other control path functions are not in scope. >=20 > -More will be added over time. > - > Device compatibility > -------------------- >=20 > @@ -3511,22 +3492,5 @@ PMDs. > - In order to save priority levels, PMDs may evaluate whether rules are > likely to collide and adjust their priority accordingly. >=20 > -Future evolutions > ------------------ > - > -- A device profile selection function which could be used to force a > - permanent profile instead of relying on its automatic configuration ba= sed > - on existing flow rules. > - > -- A method to optimize *rte_flow* rules with specific pattern items and > - action types generated on the fly by PMDs. DPDK should assign negative > - numbers to these in order to not collide with the existing types. See > - `Negative types`_. > - > -- Adding specific egress pattern items and actions as described in > - `Attribute: Traffic direction`_. > - > -- Optional software fallback when PMDs are unable to handle requested > flow > - rules so applications do not have to implement their own. >=20 > .. _OpenFlow Switch Specification: > https://nam11.safelinks.protection.outlook.com/?url=3Dhttps%3A%2F%2Fww > w.opennetworking.org%2Fsoftware-defined- > standards%2Fspecifications%2F&data=3D04%7C01%7Corika%40nvidia.com > %7C5e9459a6e52c4e9b7e6e08d8f2d31458%7C43083d15727340c1b7db39efd9 > ccc17a%7C0%7C0%7C637526335691409134%7CUnknown%7CTWFpbGZsb3d8 > eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3 > D%7C1000&sdata=3Dgj8TzUA%2Fo%2BsULeKO%2Fk5%2F7Z%2FAMyfrpe0 > yprqheQPeuAE%3D&reserved=3D0 > -- > 2.30.1 Acked-by: Ori Kam Thanks, Ori