doc: uapi: Add document describing dma-buf semantics
authorDaniel Stone <daniels@collabora.com>
Thu, 3 Aug 2023 15:47:29 +0000 (16:47 +0100)
committerSimon Ser <contact@emersion.fr>
Mon, 21 Aug 2023 16:20:05 +0000 (18:20 +0200)
commit504245a5ab6b6e1bfe0280baa4885c551e082099
treec68649063bf017f7f83d473d48236714fe091736
parent09902f3a1f83085006742f18388b5098c1b57132
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
Documentation/driver-api/dma-buf.rst
Documentation/gpu/drm-uapi.rst
Documentation/userspace-api/dma-buf-alloc-exchange.rst [new file with mode: 0644]
Documentation/userspace-api/index.rst
MAINTAINERS