Go to file
Shahaf Shuler c33a675b62 bus: introduce device level DMA memory mapping
The DPDK APIs expose 3 different modes to work with memory used for DMA:

1. Use the DPDK owned memory (backed by the DPDK provided hugepages).
This memory is allocated by the DPDK libraries, included in the DPDK
memory system (memseg lists) and automatically DMA mapped by the DPDK
layers.

2. Use memory allocated by the user and register to the DPDK memory
systems. Upon registration of memory, the DPDK layers will DMA map it
to all needed devices. After registration, allocation of this memory
will be done with rte_*malloc APIs.

3. Use memory allocated by the user and not registered to the DPDK memory
system. This is for users who wants to have tight control on this
memory (e.g. avoid the rte_malloc header).
The user should create a memory, register it through rte_extmem_register
API, and call DMA map function in order to register such memory to
the different devices.

The scope of the patch focus on #3 above.

Currently the only way to map external memory is through VFIO
(rte_vfio_dma_map). While VFIO is common, there are other vendors
which use different ways to map memory (e.g. Mellanox and NXP).

The work in this patch moves the DMA mapping to vendor agnostic APIs.
Device level DMA map and unmap APIs were added. Implementation of those
APIs was done currently only for PCI devices.

For PCI bus devices, the pci driver can expose its own map and unmap
functions to be used for the mapping. In case the driver doesn't provide
any, the memory will be mapped, if possible, to IOMMU through VFIO APIs.

Application usage with those APIs is quite simple:
* allocate memory
* call rte_extmem_register on the memory chunk.
* take a device, and query its rte_device.
* call the device specific mapping function for this device.

Future work will deprecate the rte_vfio_dma_map and rte_vfio_dma_unmap
APIs, leaving the rte device APIs as the preferred option for the user.

Signed-off-by: Shahaf Shuler <shahafs@mellanox.com>
Acked-by: Anatoly Burakov <anatoly.burakov@intel.com>
Acked-by: Gaetan Rivet <gaetan.rivet@6wind.com>
2019-03-30 16:48:56 +01:00
.ci ci: fix arm64 config filename 2019-03-30 00:01:35 +01:00
app fbarray: add API to find biggest used or free chunks 2019-03-28 23:28:52 +01:00
buildtools config: add static linkage of mlx dependency 2019-01-14 17:44:29 +01:00
config build: use version number from config file 2019-03-27 09:43:47 +01:00
devtools devtools: fix config check when building tags 2019-03-27 00:56:34 +01:00
doc bus: introduce device level DMA memory mapping 2019-03-30 16:48:56 +01:00
drivers bus: introduce device level DMA memory mapping 2019-03-30 16:48:56 +01:00
examples examples: detect default build directory 2019-03-30 01:12:15 +01:00
kernel kni: calculate MTU from mbuf size 2019-03-30 00:59:59 +01:00
lib bus: introduce device level DMA memory mapping 2019-03-30 16:48:56 +01:00
license fix dpdk.org URLs 2018-11-26 20:19:24 +01:00
mk build: use version number from config file 2019-03-27 09:43:47 +01:00
usertools usertools: add octeontx2 SSO and NPA PCIe devices 2019-03-27 01:24:27 +01:00
.gitattributes improve git diff 2016-11-13 15:25:12 +01:00
.gitignore git: ignore build directories 2019-03-13 11:57:05 +01:00
.travis.yml ci: introduce Travis builds for GitHub repositories 2019-03-26 22:31:40 +01:00
GNUmakefile test: move to app directory 2019-02-26 15:29:27 +01:00
MAINTAINERS test/ticketlock: add test cases 2019-03-28 15:02:10 +01:00
Makefile license: use SPDX tag in root makefile 2018-01-04 22:41:38 +01:00
meson_options.txt build: use integer for max ethdev ports option 2019-03-26 23:08:09 +01:00
meson.build build: move meson version handling to config directory 2019-03-27 09:43:35 +01:00
README license: introduce SPDX identifiers 2018-01-04 22:41:38 +01:00
VERSION build: add single source of DPDK version number 2019-03-27 09:43:23 +01:00

DPDK is a set of libraries and drivers for fast packet processing.
It supports many processor architectures and both FreeBSD and Linux.

The DPDK uses the Open Source BSD-3-Clause license for the core libraries
and drivers. The kernel components are GPL-2.0 licensed.

Please check the doc directory for release notes,
API documentation, and sample application information.

For questions and usage discussions, subscribe to: users@dpdk.org
Report bugs and issues to the development mailing list: dev@dpdk.org