From: Imre Deak Date: Thu, 19 Feb 2026 18:28:22 +0000 (+0200) Subject: drm/i915/dp_tunnel: Sanitize documentation of intel_dp_tunnel_detect() X-Git-Tag: v7.1-rc1~167^2~24^2~117 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=23a5fd5bec4dc36345213cf909db4b7f6a17c669;p=thirdparty%2Flinux.git drm/i915/dp_tunnel: Sanitize documentation of intel_dp_tunnel_detect() Clarify the documentation of detect_new_tunnel() return values, including the failure case. Reviewed-by: Arun R Murthy Signed-off-by: Imre Deak Link: https://patch.msgid.link/20260219182823.926702-5-imre.deak@intel.com --- diff --git a/drivers/gpu/drm/i915/display/intel_dp_tunnel.c b/drivers/gpu/drm/i915/display/intel_dp_tunnel.c index b3b3c064ac2ae..a0543325fe971 100644 --- a/drivers/gpu/drm/i915/display/intel_dp_tunnel.c +++ b/drivers/gpu/drm/i915/display/intel_dp_tunnel.c @@ -241,9 +241,12 @@ static int detect_new_tunnel(struct intel_dp *intel_dp, struct drm_modeset_acqui * tunnel. If the tunnel's state change requires this - for instance the * tunnel's group ID has changed - the tunnel will be dropped and recreated. * - * Return 0 in case of success - after any tunnel detected and added to - * @intel_dp - 1 in case the BW on an already existing tunnel has changed in a - * way that requires notifying user space. + * Returns: + * - 0 in case of success - after any tunnel detected and added to @intel_dp + * - 1 in case the link BW via the new or an already existing tunnel has changed + * in a way that requires notifying user space + * - Negative error code, if creating a new tunnel or updating the tunnel + * state failed */ int intel_dp_tunnel_detect(struct intel_dp *intel_dp, struct drm_modeset_acquire_ctx *ctx) {