common: dma-mapping: introduce dma_get_sgtable() function
authorMarek Szyprowski <m.szyprowski@samsung.com>
Wed, 13 Jun 2012 08:05:52 +0000 (10:05 +0200)
committerHiroshi Doyu <hdoyu@nvidia.com>
Fri, 7 Sep 2012 08:46:11 +0000 (11:46 +0300)
commit1085cc08c0315705f962c4686e9b27e21867955b
treed7eb834f6650a788977b53db502eeeb4b746524e
parentc067d15d6ced400c76224d76ffa5721e6ec4bae3
common: dma-mapping: introduce dma_get_sgtable() function

This patch adds dma_get_sgtable() function which is required to let
drivers to share the buffers allocated by DMA-mapping subsystem. Right
now the driver gets a dma address of the allocated buffer and the kernel
virtual mapping for it. If it wants to share it with other device (= map
into its dma address space) it usually hacks around kernel virtual
addresses to get pointers to pages or assumes that both devices share
the DMA address space. Both solutions are just hacks for the special
cases, which should be avoided in the final version of buffer sharing.

To solve this issue in a generic way, a new call to DMA mapping has been
introduced - dma_get_sgtable(). It allocates a scatter-list which
describes the allocated buffer and lets the driver(s) to use it with
other device(s) by calling dma_map_sg() on it.

This patch provides a generic implementation based on virt_to_page()
call. Architectures which require more sophisticated translation might
provide their own get_sgtable() methods.

Signed-off-by: Marek Szyprowski <m.szyprowski@samsung.com>
Reviewed-by: Kyungmin Park <kyungmin.park@samsung.com>
Reviewed-by: Daniel Vetter <daniel.vetter@ffwll.ch>
drivers/base/dma-mapping.c
include/asm-generic/dma-mapping-common.h
include/linux/dma-mapping.h