From nobody Sat Apr 4 01:37:39 2026 Received: from smtpbgeu2.qq.com (smtpbgeu2.qq.com [18.194.254.142]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 643EE369985 for ; Sat, 21 Mar 2026 10:58:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=18.194.254.142 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774090695; cv=none; b=FtSIfObOqlUppTzMKOO3Yyn1WRj/8MrG6y1xaVACpptjaRIwZ/1D6uv3QmbUjg6rHVmrsPIUxt0bePshoPrtfc7mN1uLkyMlRt6FS6mRy3h4ZGuTwGSJxwxT82PYa5RbKRkwUIJ+Ci0/nEOhvyN7tRXlByrgNwU53UdX5g9HXk0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774090695; c=relaxed/simple; bh=3D8Wv38TGHdzbkmjn3kMB52xw3SUClk1JUxzRvV/Vi4=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=aYsyW+rqMWtQUmBaiihcV/35l4FjAlK0wy7FxmUrqIcUlsfrT3xM4Uz9sot+Tch7WU7kHoHUUhj3Kd7+hQeYW7LBXXuAVMS7LcTb71w6FQsk8RBfPYe9XkjWq/q/RqY1lx8iWeX9UiqiUiOUFBlrauf+ekckjMnwlgNOqgQDMqE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=smail.nju.edu.cn; spf=pass smtp.mailfrom=smail.nju.edu.cn; dkim=pass (1024-bit key) header.d=smail.nju.edu.cn header.i=@smail.nju.edu.cn header.b=ZNQc5j3K; arc=none smtp.client-ip=18.194.254.142 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=smail.nju.edu.cn Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=smail.nju.edu.cn Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=smail.nju.edu.cn header.i=@smail.nju.edu.cn header.b="ZNQc5j3K" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=smail.nju.edu.cn; s=iohv2404; t=1774090669; bh=kDysuZ/sz32qVE18mBLkk7WL702+dG/9fna8ZhLYBpU=; h=From:To:Subject:Date:Message-Id:MIME-Version; b=ZNQc5j3KeHxqJ7F1LWi1OXhxX2XCGq35yFIhCPBN9f9s8whT5tftgVxKytv2h7wFO 5mg2KvIe91hbxaEkm/pcarmnm5Q6CHp3ZEe6ZPRddSsyX7skG6RC0mKi/XHvhKjpiE GtilxEQP1klXrKPh7dzj7fT5u3DZZBd45/3bJbdc= X-QQ-mid: zesmtpsz9t1774090656ta6086d6a X-QQ-Originating-IP: LVy3dnYOiA9pf1Xme6SfgEJkFwBB0Hbmkt7OsA+5xis= Received: from localhost.localdomain ( [116.172.93.199]) by bizesmtp.qq.com (ESMTP) with id ; Sat, 21 Mar 2026 18:57:33 +0800 (CST) X-QQ-SSF: 0000000000000000000000000000000 X-QQ-GoodBg: 1 X-BIZMAIL-ID: 12091318665540782229 EX-QQ-RecipientCnt: 14 From: Kexin Sun To: jani.nikula@linux.intel.com, joonas.lahtinen@linux.intel.com, rodrigo.vivi@intel.com, tursulin@ursulin.net, airlied@gmail.com, simona@ffwll.ch, intel-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Cc: julia.lawall@inria.fr, xutong.ma@inria.fr, kexinsun@smail.nju.edu.cn, yunbolyu@smu.edu.sg, ratnadiraw@smu.edu.sg Subject: [PATCH] drm/i915: fix outdated i915_vma_get_fence() references in kdoc Date: Sat, 21 Mar 2026 18:57:33 +0800 Message-Id: <20260321105733.6391-1-kexinsun@smail.nju.edu.cn> X-Mailer: git-send-email 2.25.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-QQ-SENDSIZE: 520 Feedback-ID: zesmtpsz:smail.nju.edu.cn:qybglogicsvrgz:qybglogicsvrgz5b-0 X-QQ-XMAILINFO: MzzzmwASFMuIbNrH6nGP5EHA8OP+1Y6RXVZqM4kDt44FnbuXnq63VJyV AEEYyRQR04s9fx4+DFYPgYMiWTrvCevK+np6agDjgDGtXyDRDKHRAmYWwzDtdeRj/tJa07C b+u74cP8SM7FpS7I+Gs1XLPCQcSmUBFAOn4TJyaT4UfLnQ6E6426Bj1jqBE1oaB0MeFsUNQ rydDFt8HiK9zILmmNXKq8Jdgf59TJzg9w/eYHPCOnC+7a6zsRm1uWFoMY27hIM837OtDi4U fREhk84NJuIdjYuFJjiaj5SV3gON/g5J305dgvZGeRfOdzr5tjsVMh4XpbGcZd0cfogbw1W WPCm3FoNRQ0iIuoz/aY4+Hc5nkSMLAWJFnQP5HrDI6H1Y8+iG/gk2jMFTYX09X+zXiM1q4o jheUHE1Z0q4yky0oS+mrKbNE9K637lU0l+sBKydIv5Q1+wnglFnlSXRt5ghsbrU9pqmYWRj d6PylRACHvCv8eY1HCbojDOnYsyaTGLc/1eY9RHQnLxNwZKTV5K6VnBlvdxtKzdwsKEhLfP aKE86qiik5OpmQlMXe+a5LiGLBb8J+EofeeUf8iHvgPBlo5jnBO1t7PkSUAN4GQwDUOS66P 9yTzjsr7SgNoafiSyH3c8qOnslHKAlC08glOYeev6QUxvmAl20r9tBKouPoZ26k3eCAxkjZ BITzfNhtveqTPcWLJTSZecaK90zamMsQfeNANv1hRlc+QrAVQVLO5tX0dNMNuPz9rsr9gvy ePhhy8aT8pdo5QbWUGm6R9NOli3pdOk9a2ECvuWTUXwp7U1VPKxTVCw/E6ki3zfoq8z7EzP 6tszSd2MktnvqPks4aCK20jHD2N8XIOMLsU2W4bO2kW0M/cUxjI/OpDU1IoNCwJAHE01Sme OymOKgZ8XK8Eaiq4o97icc1hPKz0K7TJDBw/90Xaw3aL4iVZG4SB2a5VPLbtXJQKiNYtCc/ 9DPp+KPaRRXJh75cvdKoLqtYypK5a5J9WusT73OQRg8gWhOkCIjmby3mHJC5IYYNTnATh44 zOHzzAPGtzvaa7DW6LLWtstPm7izYhsxi4GlBaGPggKMyMevKHIAducyrnBUfQgt7ycYJNj Cwy0osaZ5VlGOppDOhuiNaDuxp1HhPIBA== X-QQ-XMRINFO: MPJ6Tf5t3I/ylTmHUqvI8+Wpn+Gzalws3A== X-QQ-RECHKSPAM: 0 Content-Type: text/plain; charset="utf-8" The function i915_vma_get_fence() was merged into i915_vma_pin_fence() by commit 3bd4073524fa ("drm/i915: Consolidate get_fence with pin_fence"). Remove the stale sentence that tells callers to synchronize fencing state by calling i915_vma_get_fence() first, and fix the Returns description: i915_vma_pin_fence() returns int (0 on success, negative error code on failure), not bool as the old i915_vma_get_fence() did. Assisted-by: unnamed:deepseek-v3.2 coccinelle Signed-off-by: Kexin Sun --- drivers/gpu/drm/i915/i915_vma.h | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/drivers/gpu/drm/i915/i915_vma.h b/drivers/gpu/drm/i915/i915_vm= a.h index 8054047840aa..14ad66f8b398 100644 --- a/drivers/gpu/drm/i915/i915_vma.h +++ b/drivers/gpu/drm/i915/i915_vma.h @@ -369,14 +369,13 @@ void i915_vma_unpin_iomap(struct i915_vma *vma); * @vma: vma to pin fencing for * * This pins the fencing state (whether tiled or untiled) to make sure the - * vma (and its object) is ready to be used as a scanout target. Fencing - * status must be synchronize first by calling i915_vma_get_fence(): + * vma (and its object) is ready to be used as a scanout target. * * The resulting fence pin reference must be released again with * i915_vma_unpin_fence(). * * Returns: - * True if the vma has a fence, false otherwise. + * 0 on success, negative error code on failure. */ int __must_check i915_vma_pin_fence(struct i915_vma *vma); void i915_vma_revoke_fence(struct i915_vma *vma); --=20 2.25.1