linux/include/uapi/drm
Simon Ser ec5722adb8
drm/fourcc: document modifier uniqueness requirements
There have suggestions to bake pitch alignment, address alignment,
contiguous memory or other placement (hidden VRAM, GTT/BAR, etc)
constraints into modifiers. Last time this was brought up it seemed
like the consensus was to not allow this. Document this in drm_fourcc.h.

There are several reasons for this.

- Encoding all of these constraints in the modifiers would explode the
  search space pretty quickly (we only have 64 bits to work with).
- Modifiers need to be unambiguous: a buffer can only have a single
  modifier.
- Modifier users aren't expected to parse modifiers (except drivers).

v2: add paragraph about aliases (Daniel)

v3: fix unrelated changes sent with the patch

v4: disambiguate users between driver and higher-level programs (Brian,
Daniel)

v5: fix AFBC example (Brian, Daniel)

v6: remove duplicated paragraph (Daniel)

Signed-off-by: Simon Ser <contact@emersion.fr>
Reviewed-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Reviewed-by: Brian Starkey <brian.starkey@arm.com>
Cc: Daniel Stone <daniel@fooishbar.org>
Cc: Bas Nieuwenhuizen <bas@basnieuwenhuizen.nl>
Cc: Dave Airlie <airlied@gmail.com>
Cc: Marek Olšák <maraeo@gmail.com>
Cc: Alex Deucher <alexdeucher@gmail.com>
Cc: Neil Armstrong <narmstrong@baylibre.com>
Cc: Michel Dänzer <michel@daenzer.net>
Link: https://patchwork.freedesktop.org/patch/msgid/MGwgeXojKNdNXjCxuMhRlwcJM4vdYph_WJcMeGPPGMcRKtHV41XAXlh2tCc-pPJZCAhS3gwbWMWTd8f03NBA2ZYKfr0QxLhcPivpopr5c6M=@emersion.fr
2020-10-09 11:39:19 +02:00
..
amdgpu_drm.h drm/amdgpu: new ids flag for tmz (v2) 2020-08-06 15:45:52 -04:00
armada_drm.h
drm.h drm: Add getfb2 ioctl 2020-01-14 16:22:17 -05:00
drm_fourcc.h drm/fourcc: document modifier uniqueness requirements 2020-10-09 11:39:19 +02:00
drm_mode.h drm: report dp downstream port type as a subconnector property 2020-08-11 14:06:04 +02:00
drm_sarea.h
etnaviv_drm.h drm/etnaviv: implement softpin 2019-08-15 12:07:47 +02:00
exynos_drm.h drm/exynos: Rename Exynos to lowercase 2020-01-21 09:09:42 +09:00
i810_drm.h
i915_drm.h drm/i915: add syncobj timeline support 2020-08-17 16:16:51 -04:00
lima_drm.h drm/lima: support heap buffer creation 2020-01-27 22:01:09 +08:00
mga_drm.h
msm_drm.h drm: msm_drm.h: delete duplicated words in comments 2020-07-15 14:02:58 +02:00
nouveau_drm.h drm/nouveau: support synchronous pushbuf submission 2020-01-29 15:49:56 +10:00
omap_drm.h Revert "drm/omap: add OMAP_BO flags to affect buffer allocation" 2019-10-23 10:41:41 -04:00
panfrost_drm.h drm/panfrost: Add support for GPU heap allocations 2019-08-12 14:21:37 -06:00
qxl_drm.h
r128_drm.h
radeon_drm.h
savage_drm.h
sis_drm.h
tegra_drm.h
v3d_drm.h drm/v3d: clean caches at the end of render jobs on request from user space 2019-09-19 12:57:44 -07:00
vc4_drm.h
vgem_drm.h
via_drm.h
virtgpu_drm.h drm/virtgpu api: cross-device feature 2020-09-29 11:23:18 +02:00
vmwgfx_drm.h drm/vmwgfx: Add SM5 param for userspace 2020-03-23 22:48:57 +01:00