From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 72681A0613 for ; Tue, 30 Jul 2019 13:06:20 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 37C021C0B2; Tue, 30 Jul 2019 13:06:20 +0200 (CEST) Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-eopbgr60072.outbound.protection.outlook.com [40.107.6.72]) by dpdk.org (Postfix) with ESMTP id 361EC1C0AE for ; Tue, 30 Jul 2019 13:06:18 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=oH46ydwXs5Xjt0YWdjZv0GH9wucwXo3ql/Yd50EL6fLgPSR7xiODvF2ZxhPyWBPg0voOOm3AW0Yb7VsKoUNiF0+NqoGAiF25XsBq8ETzPiFV3yYw6ckFP6+7wZtD4ma9ha8lBqGL3VScn5edF7GPhv/oR0S5m2rtVpfK9ZNKUmE045BQR+KC5lg21KkY5jWYQV8jcDiTHWCS8jSyvC7s7VOszI+xDi73nM/RBmRWEwbVspYA1ErGZhbu+hsl7ukEv+qzzek300/gXB9rsCG0fdGyAOMLSXHaI/7h15gdADzUTOsoxtTubtmoob7xeUI1B6i+AjZhjGmxbojCdipYtQ== 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=M9QtXGowIhazWb8PotkowHbl3/NNazeSBj6zajkAArQ=; b=FTDUqIflxeov6VREqF/z8RZmBliUapcqKncq88pwXS+zOI6rN/1I58BertuW+ss7Xo0pcylWuaOpU7JkrlK7NAjqUQ9DAKrM+3knxrr1RB4/4jFeGSwjGOkMMAIwcjWVHFfSGqXwTBdxvpI5EEvZ8g8gVq0C81xd1Yg0YDOwViCEVJCSdFr0Ct9sPF6x90FR5jUZrwc3WktTMEl7gVhdAJJMM6uVPe8tAYw5kEU3LHV/dDgsHzoUe8XnGCyH89RGwwdG+dbk9tcbAurZb6v7b5hoqg39mCd1Mw635H7Qkwco0AnwMUlW3nxy3wBvzOseh4Owo8peM6FN2U8XvjtUHQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1;spf=pass smtp.mailfrom=nxp.com;dmarc=pass action=none header.from=nxp.com;dkim=pass header.d=nxp.com;arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=M9QtXGowIhazWb8PotkowHbl3/NNazeSBj6zajkAArQ=; b=Vw7K1rTZ2MJoUHpbNeYTWFeZLBAYqKZeDwtDGrJZ1JY343TSc+E6ZcPgEtDJ2WjJ4mc4/sdWRyibx9VjgFtSVAGDkPxlwi607kHNwEfNQqhL0jwTCOjgvrWlddMb3PQLDkzEFBkOProh/peSt6VMEY2st9gTnYLVZD6bE0Lcl0k= Received: from VE1PR04MB6639.eurprd04.prod.outlook.com (20.179.235.82) by VE1PR04MB6557.eurprd04.prod.outlook.com (20.179.234.86) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2115.11; Tue, 30 Jul 2019 11:06:17 +0000 Received: from VE1PR04MB6639.eurprd04.prod.outlook.com ([fe80::964:4ddc:346b:e2ec]) by VE1PR04MB6639.eurprd04.prod.outlook.com ([fe80::964:4ddc:346b:e2ec%7]) with mapi id 15.20.2115.005; Tue, 30 Jul 2019 11:06:17 +0000 From: Akhil Goyal To: "Ananyev, Konstantin" , Thomas Monjalon CC: "Iremonger, Bernard" , "dev@dpdk.org" , Anoob Joseph , Jerin Jacob Kollanukkaran , Narayana Prasad Raju Athreya Thread-Topic: [dpdk-dev] [EXT] [PATCH] doc: deprecate legacy code path in ipsec-secgw Thread-Index: AQHVRitzwTpsrZhZLECEWe3JhP6PuqbiqGgwgAAWsgCAAAED4IAAC4QAgAAOSbCAAAM9gIAAAOwQgAAHK4CAABdmoA== Date: Tue, 30 Jul 2019 11:06:16 +0000 Message-ID: References: <1562835937-24141-1-git-send-email-bernard.iremonger@intel.com> <2417926.RaMoeEf8dU@xps> <2658214.f7z3ihukRQ@xps> <2601191342CEEE43887BDE71AB9772580168A5F46A@irsmsx105.ger.corp.intel.com> In-Reply-To: <2601191342CEEE43887BDE71AB9772580168A5F46A@irsmsx105.ger.corp.intel.com> Accept-Language: en-IN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=akhil.goyal@nxp.com; x-originating-ip: [92.120.1.65] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: c0ce2bbe-0eb9-41b6-5404-08d714ddf1aa x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600148)(711020)(4605104)(1401327)(4618075)(2017052603328)(7193020); SRVR:VE1PR04MB6557; x-ms-traffictypediagnostic: VE1PR04MB6557: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-forefront-prvs: 0114FF88F6 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(376002)(366004)(346002)(396003)(39860400002)(136003)(199004)(189003)(102836004)(229853002)(9686003)(6246003)(8676002)(66556008)(446003)(66446008)(14444005)(7696005)(64756008)(66476007)(68736007)(6436002)(110136005)(6506007)(66946007)(54906003)(256004)(71200400001)(7736002)(55016002)(81166006)(33656002)(476003)(305945005)(76116006)(71190400001)(11346002)(53936002)(4326008)(25786009)(14454004)(76176011)(86362001)(26005)(81156014)(3846002)(8936002)(52536014)(44832011)(6116002)(316002)(478600001)(5660300002)(99286004)(66066001)(2906002)(74316002)(486006)(186003); DIR:OUT; SFP:1101; SCL:1; SRVR:VE1PR04MB6557; H:VE1PR04MB6639.eurprd04.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; received-spf: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) x-ms-exchange-senderadcheck: 1 x-microsoft-antispam-message-info: adEXIoTzep5Z+lxO4bLNn7QfBiY+qyCPDli9fQ28ug4t6FDI8tn6vlXiDwTE6JDCmN7RxkXwmw4Q+PwQpU1ToRnvcT5x+YNhyi8m0ZkJmLfoY4zLrV7yMPKNXBULSNEHVQhoDEbwCwYclosE7B3UL0xf4OVOaSLrgWqI9gp8JHO1voWY9px+6p7G1dPLhAKg+cDy3F1dlLOBUJ7zmZb1ULnZ2vvWDFKIt4LA2+zjXhaA1ZqqdrttjtSIkBVzC9J8g2Sw6Yp9xrBbtpLxpVuDgsIruazRAmkZJqVhmgD3tjuvGfj5DIi3rd0Zcv6R1qYBtQU6MtnfuPjWqY2+zP6QtrVotmv4rS6dryFyRnh5k4ZwmJQVtbzJn+8CmKexkhZQipnmgkU79PqiqN2ZO1hEjRWuJChQJcx8tXEid4gTWZw= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: c0ce2bbe-0eb9-41b6-5404-08d714ddf1aa X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Jul 2019 11:06:16.9465 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: akhil.goyal@nxp.com X-MS-Exchange-Transport-CrossTenantHeadersStamped: VE1PR04MB6557 Subject: Re: [dpdk-dev] [EXT] [PATCH] doc: deprecate legacy code path in ipsec-secgw X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 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" > > > > > > 30/07/2019 10:48, Akhil Goyal: > > > > > 30/07/2019 09:20, Akhil Goyal: > > > > > > > 30/07/2019 07:55, Akhil Goyal: > > > > > > > > > > > > All the functionality of the legacy code path in no= w available > > > > > > > > > > > > in the librte_ipsec library. > > > > > > > > > > > > It is planned to deprecate the legacy code path in = the 19.11 > > > > > > > > > > > > release and remove the legacy code path in the 20.0= 2 > release. > > > > > > > > > > > > > > > > > > > > > > > > Signed-off-by: Bernard Iremonger > > > > > > > > > > > > > > > Acked-by: Konstantin Ananyev > > > > > > > > > > > > > Acked-by: Fan Zhang > > > > > > > > > > > > Acked-by: Akhil Goyal > > > > > > > > > > > > --- > > > > > > > > > > > > doc/guides/rel_notes/deprecation.rst | 5 +++++ > > > > > > > > > > > > 1 file changed, 5 insertions(+) > > > > > > > > > > > > > > > > > > > > > > > Acked-by: Anoob Joseph > > > > > > > > > > > > > > > > > > > > Applied to dpdk-next-crypto > > > > > > > > > > > > > > > > > > Why do we have a deprecation notice for some code path in= an > > > example? > > > > > > > > > The deprecation notices are for the API. > > > > > > > > > > > > > > > > > > I think you can drop the legacy code in 19.11, > > > > > > > > > and I don't merge this patch in master. > > > > > > > > > > > > > > > > We are planning to remove the original code and replace it = with > IPSec > > > > > > > > library APIs which are still experimental. > > > > > > > > With this change there won't be any example of the legacy i= psec > code > > > path. > > > > > > > > > > That's good to drop old code. > > > > > If someone still wants to look at it, it is in old releases. > > > > > > > > > > > > > Applications over DPDK take ipsec-secgw as an example and I= PSec > > > > > > > > is a major use case for customers. There may also be perfor= mance > > > > > > > > differences in the two code paths. Atleast on NXP platforms= I saw > > > > > > > > 5-7% drop when the patches were originally submitted. > > > > > > > > Not sure what is the current state. > > > > > > > > > > That's a different issue you need to solve in the library. > > > > > > > > > > > > > I feel it is worth notifying the users that the original co= depath is > > > > > > > > getting deprecated, so that they can plan to move to new IP= Sec > APIs. > > > > > > > > > > I hope they already planned to move when they saw the new library= . > > > > > > > > > > > > The deprecation notice is not the right place for a change in= an > example. > > > > > > > What change is there in IPsec API? In which release? > > > > > > > > > > > > IPSec lib was introduced in 1902 release and a few enhancements > > > > > > are done thereafter. > > > > > > Previously all IPSec related stuff was done in the application, > > > > > > now we have IPSec Lib which perform similar work. > > > > > > There are changes both in datapath as well as control path. > > > > > > User need to adapt to the recent changes, as we may no longer > > > > > > support/maintain the datapath/control path which was done previ= ously > > > > > > and there may be some conflict. > > > > > > > > > > So the real DPDK change is to have a new library in 19.02. > > > > > > > > > > > If deprecation notice is not the right place, > > > > > > then where should it be notified before actually making the cha= nge. > > > > > > > > > > It has already been notified in "New Features" of 19.02 > > > > > that there is an IPsec library. What do you want to notify more? > > > > > Again, the example is not supposed to be a real application. > > > > > If you want to maintain an IPsec application with better quality = rules, > > > > > I suggest to start a new git repository for it. > > > > > > > > OK got your point, but in that case, I would say, legacy code shall= not be > > > removed > > > > Until we have the ipsec lib as experimental. > > > > User should have both the code paths as long as we have ipsec libra= ry > > > experimental. >=20 > Not sure why it is needed? There is some performance gap. Original Idea for ipsec lib was to have better performing APIs. How much gain is observed using these APIs on intel= ? Do we have data? Atleast on NXP devices, these are not performing better. > Why DPDK sample app can't use DPDK experimental API as it is, > without some alternate code-path? Sample app can use experimental APIs as is. There is no issue with that. The intent is just to notify the users that it will be removed so that they can be ready for change in their code.=20 >=20 > > > > > > That's your take. > > > When do you plan to remove experimental status of IPsec library? > > > > > There have been addition of some functionality in this release cycle. I= would > say we > > can wait for 1 release cycle for some fixes or changes which may be req= uired. > > If it looks stable in next release cycle, we can make formal in DPDK 20= 02. >=20 > If we'll leave legacy code in 19.11, does it mean we'll have to > support it for next 2 years (LTS cycle)? The original intent of this patch was also to remove the legacy code in 200= 2 release and not in 1911. Moreover, it is the application code that we need to remove. W= e can get that patch backported to the 19.11.1 release as well. Then it would be same. > Konstantin