diff options
| author | Daniel Stone <daniels@collabora.com> | 2023-08-03 18:47:29 +0300 |
|---|---|---|
| committer | Simon Ser <contact@emersion.fr> | 2023-08-21 19:20:05 +0300 |
| commit | 504245a5ab6b6e1bfe0280baa4885c551e082099 (patch) | |
| tree | c68649063bf017f7f83d473d48236714fe091736 /Documentation/driver-api | |
| parent | 09902f3a1f83085006742f18388b5098c1b57132 (diff) | |
| download | linux-504245a5ab6b6e1bfe0280baa4885c551e082099.tar.xz | |
doc: uapi: Add document describing dma-buf semantics
Since there's a lot of confusion around this, document both the rules
and the best practices around negotiating, allocating, importing, and
using buffers when crossing context/process/device/subsystem boundaries.
This ties up all of dma-buf, formats and modifiers, and their usage.
Signed-off-by: Daniel Stone <daniels@collabora.com>
Signed-off-by: Simon Ser <contact@emersion.fr>
Reviewed-by: Simon Ser <contact@emersion.fr>
Reviewed-by: Sui Jingfeng <suijingfeng@loongson.cn>
Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Link: https://patchwork.freedesktop.org/patch/msgid/20230803154908.105124-4-daniels@collabora.com
Diffstat (limited to 'Documentation/driver-api')
| -rw-r--r-- | Documentation/driver-api/dma-buf.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/driver-api/dma-buf.rst b/Documentation/driver-api/dma-buf.rst index 862dbc2759d0..0c153d79ccc4 100644 --- a/Documentation/driver-api/dma-buf.rst +++ b/Documentation/driver-api/dma-buf.rst @@ -22,6 +22,14 @@ interact with the three main primitives offered by dma-buf: allowing implicit (kernel-ordered) synchronization of work to preserve the illusion of coherent access + +Userspace API principles and use +-------------------------------- + +For more details on how to design your subsystem's API for dma-buf use, please +see Documentation/userspace-api/dma-buf-alloc-exchange.rst. + + Shared DMA Buffers ------------------ |