Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

drm/docs: More links for implicit/explicit fencing.

drm_atomic_set_fence_for_plane() contains the main discussion from a
driver pov, link to that from more places.

Cc: Pekka Paalanen <pekka.paalanen@collabora.com>
Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.com>
Signed-off-by: Daniel Vetter <daniel.vetter@intel.com>
Cc: Maarten Lankhorst <maarten.lankhorst@linux.intel.com>
Cc: Maxime Ripard <maxime.ripard@bootlin.com>
Cc: Sean Paul <sean@poorly.run>
Cc: David Airlie <airlied@linux.ie>
Cc: Daniel Vetter <daniel@ffwll.ch>
Link: https://patchwork.freedesktop.org/patch/msgid/20190603142848.26487-1-daniel.vetter@ffwll.ch

+7 -1
+6
drivers/gpu/drm/drm_gem_framebuffer_helper.c
··· 284 284 * There is no need for &drm_plane_helper_funcs.cleanup_fb hook for simple 285 285 * gem based framebuffer drivers which have their buffers always pinned in 286 286 * memory. 287 + * 288 + * See drm_atomic_set_fence_for_plane() for a discussion of implicit and 289 + * explicit fencing in atomic modeset updates. 287 290 */ 288 291 int drm_gem_fb_prepare_fb(struct drm_plane *plane, 289 292 struct drm_plane_state *state) ··· 317 314 * &dma_buf attached, extracts the exclusive fence and attaches it to plane 318 315 * state for the atomic helper to wait on. Drivers can use this as their 319 316 * &drm_simple_display_pipe_funcs.prepare_fb callback. 317 + * 318 + * See drm_atomic_set_fence_for_plane() for a discussion of implicit and 319 + * explicit fencing in atomic modeset updates. 320 320 */ 321 321 int drm_gem_fb_simple_display_pipe_prepare_fb(struct drm_simple_display_pipe *pipe, 322 322 struct drm_plane_state *plane_state)
+1 -1
include/drm/drm_plane.h
··· 69 69 * 70 70 * Optional fence to wait for before scanning out @fb. The core atomic 71 71 * code will set this when userspace is using explicit fencing. Do not 72 - * write this directly for a driver's implicit fence, use 72 + * write this field directly for a driver's implicit fence, use 73 73 * drm_atomic_set_fence_for_plane() to ensure that an explicit fence is 74 74 * preserved. 75 75 *