From nobody Mon Feb 9 10:38:52 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 648A0C77B7A for ; Wed, 24 May 2023 10:32:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229893AbjEXKcx (ORCPT ); Wed, 24 May 2023 06:32:53 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51840 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229521AbjEXKcu (ORCPT ); Wed, 24 May 2023 06:32:50 -0400 Received: from mailgw.kylinos.cn (mailgw.kylinos.cn [124.126.103.232]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9A2B998 for ; Wed, 24 May 2023 03:32:48 -0700 (PDT) X-UUID: 902cfb92b315469abe58eec95e6a8660-20230524 X-CID-O-RULE: Release_Ham X-CID-RULE: Release_Ham X-CID-O-INFO: VERSION:1.1.22,REQID:9e56b5b9-9528-4ab5-8a67-9f47867fe627,IP:5,U RL:0,TC:0,Content:0,EDM:0,RT:0,SF:-15,FILE:0,BULK:0,RULE:Release_Ham,ACTIO N:release,TS:-10 X-CID-INFO: VERSION:1.1.22,REQID:9e56b5b9-9528-4ab5-8a67-9f47867fe627,IP:5,URL :0,TC:0,Content:0,EDM:0,RT:0,SF:-15,FILE:0,BULK:0,RULE:Release_Ham,ACTION: release,TS:-10 X-CID-META: VersionHash:120426c,CLOUDID:b15ddc6c-2f20-4998-991c-3b78627e4938,B ulkID:23052418324559N28CF5,BulkQuantity:0,Recheck:0,SF:19|44|24|17|102,TC: nil,Content:0,EDM:-3,IP:-2,URL:0,File:nil,Bulk:nil,QS:nil,BEC:nil,COL:0,OS I:0,OSA:0,AV:0 X-CID-BVR: 0,NGT X-CID-BAS: 0,NGT,0,_ X-UUID: 902cfb92b315469abe58eec95e6a8660-20230524 X-User: pengfuyuan@kylinos.cn Received: from localhost.localdomain [(116.128.244.169)] by mailgw (envelope-from ) (Generic MTA) with ESMTP id 634748836; Wed, 24 May 2023 18:32:44 +0800 From: pengfuyuan To: David Airlie Cc: Daniel Vetter , Sumit Semwal , christian.koenig@amd.com, John Harrison , Daniele Ceraolo Spurio , Andrzej Hajda , Alan Previn , Matthew Brost , intel-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, Jani Nikula , Joonas Lahtinen , Rodrigo Vivi , pengfuyuan , k2ci Subject: [PATCH] drm/i915/gt: fix kernel-doc trivial warnings Date: Wed, 24 May 2023 18:32:42 +0800 Message-Id: <20230524103242.1486266-1-pengfuyuan@kylinos.cn> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The test robot reports some make warnings. Fix those warnings: drivers/gpu/drm/i915/gt/intel_gtt.h:499: warning: Function parameter or= member 'vm' not described in 'i915_vm_resv_put' drivers/gpu/drm/i915/gt/intel_context.h:108: warning: Function paramete= r or member 'ce' not described in 'intel_context_lock_pinned' drivers/gpu/drm/i915/gt/intel_context.h:123: warning: Function paramete= r or member 'ce' not described in 'intel_context_is_pinned' drivers/gpu/drm/i915/gt/intel_context.h:142: warning: Function paramete= r or member 'ce' not described in 'intel_context_unlock_pinned drivers/gpu/drm/i915/gt/intel_engine_types.h:293: warning: Function par= ameter or member 'preempt_hang' not described in 'intel_engine_execlists' Reported-by: k2ci Signed-off-by: pengfuyuan --- drivers/gpu/drm/i915/gt/intel_context.h | 6 +++--- drivers/gpu/drm/i915/gt/intel_engine_types.h | 3 +++ drivers/gpu/drm/i915/gt/intel_gtt.h | 2 +- 3 files changed, 7 insertions(+), 4 deletions(-) diff --git a/drivers/gpu/drm/i915/gt/intel_context.h b/drivers/gpu/drm/i915= /gt/intel_context.h index 48f888c3da08..6b5eae7b88bc 100644 --- a/drivers/gpu/drm/i915/gt/intel_context.h +++ b/drivers/gpu/drm/i915/gt/intel_context.h @@ -97,7 +97,7 @@ void intel_context_bind_parent_child(struct intel_context= *parent, =20 /** * intel_context_lock_pinned - Stablises the 'pinned' status of the HW con= text - * @ce - the context + * @ce: the context * * Acquire a lock on the pinned status of the HW context, such that the co= ntext * can neither be bound to the GPU or unbound whilst the lock is held, i.e. @@ -111,7 +111,7 @@ static inline int intel_context_lock_pinned(struct inte= l_context *ce) =20 /** * intel_context_is_pinned - Reports the 'pinned' status - * @ce - the context + * @ce: the context * * While in use by the GPU, the context, along with its ring and page * tables is pinned into memory and the GTT. @@ -133,7 +133,7 @@ static inline void intel_context_cancel_request(struct = intel_context *ce, =20 /** * intel_context_unlock_pinned - Releases the earlier locking of 'pinned' = status - * @ce - the context + * @ce: the context * * Releases the lock earlier acquired by intel_context_unlock_pinned(). */ diff --git a/drivers/gpu/drm/i915/gt/intel_engine_types.h b/drivers/gpu/drm= /i915/gt/intel_engine_types.h index 960291f88fd6..1fc1fc882097 100644 --- a/drivers/gpu/drm/i915/gt/intel_engine_types.h +++ b/drivers/gpu/drm/i915/gt/intel_engine_types.h @@ -289,6 +289,9 @@ struct intel_engine_execlists { */ u8 csb_head; =20 + /** + * @preempt_hang: preempt hang state for self-tests. + */ I915_SELFTEST_DECLARE(struct st_preempt_hang preempt_hang;) }; =20 diff --git a/drivers/gpu/drm/i915/gt/intel_gtt.h b/drivers/gpu/drm/i915/gt/= intel_gtt.h index 69ce55f517f5..a9aa72a8c59c 100644 --- a/drivers/gpu/drm/i915/gt/intel_gtt.h +++ b/drivers/gpu/drm/i915/gt/intel_gtt.h @@ -493,7 +493,7 @@ static inline void i915_vm_put(struct i915_address_spac= e *vm) =20 /** * i915_vm_resv_put - Release a reference on the vm's reservation lock - * @resv: Pointer to a reservation lock obtained from i915_vm_resv_get() + * @vm: Pointer to a reservation lock obtained from i915_vm_resv_release() */ static inline void i915_vm_resv_put(struct i915_address_space *vm) { --=20 2.25.1 No virus found Checked by Hillstone Network AntiVirus