From: Tvrtko Ursulin Date: Mon, 16 Mar 2026 09:38:09 +0000 (+0000) Subject: drm/gem: Improve drm_gem_objects_lookup() kerneldoc X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=78842c1e3b05c1d5b7b32a33ccbfd5fcccc5557d;p=thirdparty%2Flinux.git drm/gem: Improve drm_gem_objects_lookup() kerneldoc Make clear that the returned array has to be free using kvfree(). While at it, fix broken reference to non-existant @objs and allow for more error codes on failure. Signed-off-by: Tvrtko Ursulin Cc: Srinivasan Shanmugam Cc: Sunil Khatri Reviewed-by: Srinivasan Shanmugam Signed-off-by: Tvrtko Ursulin Link: https://lore.kernel.org/r/20260316093809.97267-1-tvrtko.ursulin@igalia.com [tursulin: fixup spelling] --- diff --git a/drivers/gpu/drm/drm_gem.c b/drivers/gpu/drm/drm_gem.c index fdf08cae1c5be..0377a5fd402d0 100644 --- a/drivers/gpu/drm/drm_gem.c +++ b/drivers/gpu/drm/drm_gem.c @@ -821,13 +821,14 @@ err: * Takes an array of userspace handles and returns a newly allocated array of * GEM objects. * - * For a single handle lookup, use drm_gem_object_lookup(). + * After a successful lookup GEM objects need to be released using + * drm_gem_object_put() and the array returned in @objs_out must be freed using + * kvfree(). * - * Returns: - * @objs filled in with GEM object pointers. Returned GEM objects need to be - * released with drm_gem_object_put(). -ENOENT is returned on a lookup - * failure. 0 is returned on success. + * For a single handle lookup, use drm_gem_object_lookup(). * + * Return: + * Zero on success or a negative error code. */ int drm_gem_objects_lookup(struct drm_file *filp, void __user *bo_handles, int count, struct drm_gem_object ***objs_out)