drm/doc: document DRM_IOCTL_MODE_CREATE_DUMB

The main motivation is to repeat that dumb buffers should not be
abused for anything else than basic software rendering with KMS.
User-space devs are more likely to look at the IOCTL docs than to
actively search for the driver-oriented "Dumb Buffer Objects"
section.

v2: reference DRM_CAP_DUMB_BUFFER, DRM_CAP_DUMB_PREFERRED_DEPTH and
DRM_CAP_DUMB_PREFER_SHADOW (Pekka)

Signed-off-by: Simon Ser <contact@emersion.fr>
Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Acked-by: Pekka Paalanen <pekka.paalanen@collabora.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20230821131548.269204-1-contact@emersion.fr

This commit is contained in:

Simon Ser

2023-08-21 13:15:56 +00:00

parent d4b3842285

commit b8644c4ae2

3 changed files with 36 additions and 2 deletions

									
										Documentation/gpu/drm-kms.rst
									
		+2
		
												View File
												
				@@ -360,6 +360,8 @@ Format Functions Reference

				.. kernel-doc:: drivers/gpu/drm/drm_fourcc.c

				   :export:

				.. _kms_dumb_buffer_objects:

				Dumb Buffer Objects

				===================