]> git.baikalelectronics.ru Git - kernel.git/commit
drm/doc: Clarify PRIME documentation
authorDaniel Vetter <daniel.vetter@ffwll.ch>
Wed, 22 Jan 2014 17:46:33 +0000 (18:46 +0100)
committerDaniel Vetter <daniel.vetter@ffwll.ch>
Thu, 13 Mar 2014 11:48:33 +0000 (12:48 +0100)
commit8cb529f2d8c11eb2a7fb4f489fa4d850e00c89f4
treedf278dfa928bdb649964c97e3e3202e7793c7b6a
parent9af0d8b3402b5cb233feb2b731807f16e209e9ff
drm/doc: Clarify PRIME documentation

PRIME fds aren't actually GEM fds but are (like the modeset API)
independent of the underlying buffer manager, as long as that one uses
uint32_t as handles. So move that entire section out of the GEM
section and reword it a bit to clarify which parts of PRIME are
generic, and which are the mandatory pieces for GEM drivers to
correctly implement the GEM lifetime rules. The rewording mostly
consists of not mixing up GEM, PRIME and DRM.

I've considered adding some blurbs to the GEM object lifetime section
about interactions with dma-bufs, but then dropped that. As long as
drivers use the right helpers they should have this all implemented
correctly and hence can be regarded as an implementation detail of the
PRIME/GEM helpers. So no need to confuse driver writers with those
tricky interactions.

Reviewed-by: Alex Deucher <alexander.deucher@amd.com>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Documentation/DocBook/drm.tmpl