From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx1.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by dpdk.org (Postfix) with ESMTP id AE8001B445 for ; Thu, 2 Aug 2018 09:56:57 +0200 (CEST) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id BFA07401DE66; Thu, 2 Aug 2018 07:56:56 +0000 (UTC) Received: from [10.36.112.34] (ovpn-112-34.ams2.redhat.com [10.36.112.34]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D97AC10F1BE6; Thu, 2 Aug 2018 07:56:53 +0000 (UTC) To: Anatoly Burakov , dev@dpdk.org Cc: Neil Horman , John McNamara , Marko Kovacevic , thomas@monjalon.net, keith.wiles@intel.com References: <12c37dfc8dda4acbd7b49b00a577c3a9f5cbfbba.1533125146.git.anatoly.burakov@intel.com> From: Maxime Coquelin Message-ID: Date: Thu, 2 Aug 2018 09:56:52 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <12c37dfc8dda4acbd7b49b00a577c3a9f5cbfbba.1533125146.git.anatoly.burakov@intel.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Scanned-By: MIMEDefang 2.78 on 10.11.54.3 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.11.55.6]); Thu, 02 Aug 2018 07:56:56 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.11.55.6]); Thu, 02 Aug 2018 07:56:56 +0000 (UTC) for IP:'10.11.54.3' DOMAIN:'int-mx03.intmail.prod.int.rdu2.redhat.com' HELO:'smtp.corp.redhat.com' FROM:'maxime.coquelin@redhat.com' RCPT:'' 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 07:56:58 -0000 On 08/01/2018 02:07 PM, Anatoly Burakov wrote: > 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. > > [1] http://patches.dpdk.org/project/dpdk/list/?series=453&state=* > [2] https://mails.dpdk.org/archives/dev/2018-July/108002.html > > Signed-off-by: Anatoly Burakov > --- > doc/guides/rel_notes/deprecation.rst | 15 +++++++++++++++ > 1 file changed, 15 insertions(+) > > 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 > ------------------- > > +* eal: certain structures will change in EAL on account of upcoming external > + memory support. Aside from internal changes leading to an ABI break, the > + 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 memory. No > + changes will be required for existing code as backwards compatibility will > + be kept, and those who do not use this feature will not see these extra > + 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 with the > Acked-by: Maxime Coquelin