From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id 46D9F1B42D for ; Thu, 2 Aug 2018 04:38:04 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga007.jf.intel.com ([10.7.209.58]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 01 Aug 2018 19:38:03 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.51,434,1526367600"; d="scan'208";a="61371003" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by orsmga007.jf.intel.com with ESMTP; 01 Aug 2018 19:38:02 -0700 Received: from fmsmsx125.amr.corp.intel.com (10.18.125.40) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Wed, 1 Aug 2018 19:38:02 -0700 Received: from shsmsx152.ccr.corp.intel.com (10.239.6.52) by FMSMSX125.amr.corp.intel.com (10.18.125.40) with Microsoft SMTP Server (TLS) id 14.3.319.2; Wed, 1 Aug 2018 19:38:02 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.100]) by SHSMSX152.ccr.corp.intel.com ([169.254.6.173]) with mapi id 14.03.0319.002; Thu, 2 Aug 2018 10:37:59 +0800 From: "Wang, Zhihong" To: "Burakov, Anatoly" , "dev@dpdk.org" CC: Neil Horman , "Mcnamara, John" , "Kovacevic, Marko" , "thomas@monjalon.net" , "Wiles, Keith" Thread-Topic: [dpdk-dev] [PATCH] doc: add deprecation notice on external memory support Thread-Index: AQHUKZBP1Un7F/0kxUWvKSe1rhTra6Srv/0w Date: Thu, 2 Aug 2018 02:37:59 +0000 Message-ID: <8F6C2BD409508844A0EFC19955BE094151572C2B@SHSMSX103.ccr.corp.intel.com> References: <12c37dfc8dda4acbd7b49b00a577c3a9f5cbfbba.1533125146.git.anatoly.burakov@intel.com> In-Reply-To: <12c37dfc8dda4acbd7b49b00a577c3a9f5cbfbba.1533125146.git.anatoly.burakov@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.239.127.40] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCH] doc: add deprecation notice on external memory support 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: , X-List-Received-Date: Thu, 02 Aug 2018 02:38:04 -0000 > -----Original Message----- > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Anatoly Burakov > Sent: Wednesday, August 1, 2018 8:07 PM > To: dev@dpdk.org > Cc: Neil Horman ; Mcnamara, John > ; Kovacevic, Marko > ; thomas@monjalon.net; Wiles, Keith > > Subject: [dpdk-dev] [PATCH] doc: add deprecation notice on external > memory support >=20 > Due to the upcoming external memory support [1], some API and ABI > changes will be required. In addition, although the changes called > out in the deprecation notice are not yet present in form of code > in the published RFC itself, they are based on consensus on the > mailing list [2] on how to best implement this feature. >=20 > [1] http://patches.dpdk.org/project/dpdk/list/?series=3D453&state=3D* > [2] https://mails.dpdk.org/archives/dev/2018-July/108002.html >=20 > Signed-off-by: Anatoly Burakov > --- > doc/guides/rel_notes/deprecation.rst | 15 +++++++++++++++ > 1 file changed, 15 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 14714fe94..629154711 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -8,6 +8,21 @@ API and ABI deprecation notices are to be posted here. > Deprecation Notices > ------------------- >=20 > +* eal: certain structures will change in EAL on account of upcoming exte= rnal > + memory support. Aside from internal changes leading to an ABI break, t= he > + following externally visible changes will also be implemented: > + > + - ``rte_memseg_list`` will change to include a boolean flag indicating > + whether a particular memseg list is externally allocated. This will = have > + implications for any users of memseg-walk-related functions, as they= will > + now have to skip externally allocated segments in most cases if the = intent > + is to only iterate over internal DPDK memory. > + - ``socket_id`` parameter across the entire DPDK will gain additional > meaning, > + as some socket ID's will now be representing externally allocated me= mory. > No > + changes will be required for existing code as backwards compatibilit= y will > + be kept, and those who do not use this feature will not see these ex= tra > + socket ID's. > + > * eal: both declaring and identifying devices will be streamlined in v18= .08. > New functions will appear to query a specific port from buses, classes= of > device and device drivers. Device declaration will be made coherent wi= th > the > -- > 2.17.1 Acked-by: Wang, Zhihong Thanks