]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/commit - lib/sg_split.c
lib: scatterlist: add sg splitting function
authorRobert Jarzmik <robert.jarzmik@free.fr>
Sat, 8 Aug 2015 08:44:10 +0000 (10:44 +0200)
committerJens Axboe <axboe@fb.com>
Mon, 24 Aug 2015 20:28:01 +0000 (14:28 -0600)
commitf8bcbe62acd0e1ce9004b83e98a4af87ae385dcf
treed38abf2baec6947702610e0d261cd5672052dcda
parentdb0fa0cb015794dd19f664933d49c6ce902ec1e1
lib: scatterlist: add sg splitting function

Sometimes a scatter-gather has to be split into several chunks, or sub
scatter lists. This happens for example if a scatter list will be
handled by multiple DMA channels, each one filling a part of it.

A concrete example comes with the media V4L2 API, where the scatter list
is allocated from userspace to hold an image, regardless of the
knowledge of how many DMAs will fill it :
 - in a simple RGB565 case, one DMA will pump data from the camera ISP
   to memory
 - in the trickier YUV422 case, 3 DMAs will pump data from the camera
   ISP pipes, one for pipe Y, one for pipe U and one for pipe V

For these cases, it is necessary to split the original scatter list into
multiple scatter lists, which is the purpose of this patch.

The guarantees that are required for this patch are :
 - the intersection of spans of any couple of resulting scatter lists is
   empty.
 - the union of spans of all resulting scatter lists is a subrange of
   the span of the original scatter list.
 - streaming DMA API operations (mapping, unmapping) should not happen
   both on both the resulting and the original scatter list. It's either
   the first or the later ones.
 - the caller is reponsible to call kfree() on the resulting
   scatterlists.

Signed-off-by: Robert Jarzmik <robert.jarzmik@free.fr>
Signed-off-by: Jens Axboe <axboe@fb.com>
include/linux/scatterlist.h
lib/Kconfig
lib/Makefile
lib/sg_split.c [new file with mode: 0644]