drm/bridge: make devm_drm_bridge_alloc() mandatory for bridge allocation

All DRM bridges are now supposed to be allocated using
devm_drm_bridge_alloc(), which is cleaner and necessary to support
refcounting.

In the absence of a drm_bridge_init() or such initialization function,
document the new mandatory alloc function on the first DRM bridge core
function that is called after allocation, i.e. drm_bridge_add().

Suggested-by: Maxime Ripard <mripard@kernel.org>
Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
Reviewed-by: Maxime Ripard <mripard@kernel.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20250326-drm-bridge-refcount-v9-3-5e0661fe1f84@bootlin.com
Signed-off-by: Louis Chauvet <louis.chauvet@bootlin.com>
This commit is contained in:
Luca Ceresoli
2025-03-26 18:47:37 +01:00
committed by Louis Chauvet
parent 30d1b37d4c
commit b3f13e00a8

View File

@@ -286,6 +286,9 @@ EXPORT_SYMBOL(__devm_drm_bridge_alloc);
* drm_bridge_add - add the given bridge to the global bridge list
*
* @bridge: bridge control structure
*
* The bridge to be added must have been allocated by
* devm_drm_bridge_alloc().
*/
void drm_bridge_add(struct drm_bridge *bridge)
{