From: Jerin Jacob Date: Tue, 11 Jul 2017 10:01:41 +0000 (+0530) Subject: doc: announce change to make DPDK IOVA aware X-Git-Tag: spdx-start~2195 X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=caa570db61307e07efc461cf558ec291a3e71b29;p=dpdk.git doc: announce change to make DPDK IOVA aware When we run DPDK on guest or VFIO mode on host, the dpdk library or device will not be directly accessing the physical address. Instead, the device does go through an IO address translation memory management unit. On x86, we call it as IOMMU and on ARM as SMMU. More details: http://osidays.com/osidays/wp-content/uploads/2014/12/Final_OSI2014_IOMMU_DetailedView_Sanil_Anurup.pdf Based on discussion in the following thread http://dpdk.org/ml/archives/dev/2017-July/070850.html We would like to change reference to physical address to more appropriate name as with IOMMU/SMMU with the device won't be dealing directly with the physical address. An ABI change is planned for 17.11 to change following data structure or functions to more appropriate name. Currently planned to change it iova as instead of phys Please note: The change will be only for the name and functional aspects of the API will remain same. Following functions/data structures name may change. This list is based on v17.05-rc1. It may change based on v17.11 code base. typedef: phys_addr_t structures: struct rte_memseg::phys_addr struct rte_mbuf::buf_physaddr functions: rte_mempool_populate_phys() rte_mempool_populate_phys_tab() rte_eal_using_phys_addrs() rte_mem_virt2phy() rte_dump_physmem_layout() rte_eal_get_physmem_layout() rte_eal_get_physmem_size() rte_malloc_virt2phy() rte_mem_phy2mch() Signed-off-by: Jerin Jacob Acked-by: Santosh Shukla Acked-by: Hemant Agrawal Acked-by: Olivier Matz Acked-by: Thomas Monjalon --- diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index f10c00da6f..8793e28a77 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -32,6 +32,13 @@ Deprecation Notices * eal: the support of Xen dom0 will be removed from EAL in 17.11; and with that, drivers/net/xenvirt and examples/vhost_xen will also be removed. +* eal: An ABI change is planned for 17.11 to make DPDK aware of IOVA address + translation scheme. + Reference to phys address in EAL data-structure or functions may change to + IOVA address or more appropriate name. + The change will be only for the name. + Functional aspects of the API or data-structure will remain same. + * The mbuf flags PKT_RX_VLAN_PKT and PKT_RX_QINQ_PKT are deprecated and are respectively replaced by PKT_RX_VLAN_STRIPPED and PKT_RX_QINQ_STRIPPED, that are better described. The old flags and