d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: add deprecation notice for external memory

Browse Source 
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 <anatoly.burakov@intel.com>
Acked-by: Keith Wiles <keith.wiles@intel.com>
Acked-by: Zhihong Wang <zhihong.wang@intel.com>
Acked-by: Jerin Jacob <jerin.jacob@caviumnetworks.com>
Acked-by: Yongseok Koh <yskoh@mellanox.com>
Acked-by: Maxime Coquelin <maxime.coquelin@redhat.com>
Acked-by: Shreyansh Jain <shreyansh.jain@nxp.com>
This commit is contained in:
Anatoly Burakov 2018-08-01 13:07:16 +01:00 committed by Thomas Monjalon
parent 3a787d5bf1
commit 9cb0a93457
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/guides/rel_notes/deprecation.rst
View File

@ -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