]> git.ipfire.org Git - thirdparty/kernel/stable.git/commit
drm/bridge: drm_bridge_get/put(): document NULL pointer behaviour
authorLuca Ceresoli <luca.ceresoli@bootlin.com>
Tue, 24 Mar 2026 09:08:49 +0000 (10:08 +0100)
committerLuca Ceresoli <luca.ceresoli@bootlin.com>
Thu, 9 Apr 2026 14:27:48 +0000 (16:27 +0200)
commitaf29fcbe806ecd10078c406470fecb902b3c0e55
tree20987498c5e543cb700d6f02909fc7db9bc5565f
parent0a7f39ba3ffcb810150d95237ee4e089fa522a93
drm/bridge: drm_bridge_get/put(): document NULL pointer behaviour

drm_bridge_get and drm_bridge_put() do nothing when they are passed a NULL
pointer, and they do so since their initial addition in commit 30d1b37d4c02
("drm/bridge: add support for refcounting").

This allows simpler code in various places when using these
functions. However it's not documented, so it's not clear whether it is
part of the API "contract" or just a current implementation detail that
might change in the future.

There is no visible reason to remove this NULL check, so document it,
making it part of the contract, letting users count on it.

Reviewed-by: Liu Ying <victor.liu@nxp.com>
Reviewed-by: Louis Chauvet <louis.chauvet@bootlin.com>
Link: https://patch.msgid.link/20260324-drm-bridge-alloc-getput-document-null-check-v1-1-fb0877c49d7e@bootlin.com
Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
drivers/gpu/drm/drm_bridge.c