From nobody Thu Apr 9 15:46:39 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 C450C494A1E for ; Fri, 6 Mar 2026 22:10:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772835037; cv=none; b=Ps+vL9cVXox1F9pE5iQBIbLdXLGgLwNh0h3uJOxyX0yBPqMZT2e60La7FmGQ5x8PMyQS9vBeiYRhSJYw9NpkaD1fab0R5OZMmE7EwP5GXpPEHlxIWYIo62+6TtUtQ5cjSod4nhJeTiCi6F4IEZFUlLy6NIQXMF88glmcnl4wA5s= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772835037; c=relaxed/simple; bh=y4FA5NzBHPnCx1qw6lnnQMm/C26H9Ca9/IS3KHbpNjA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=g7K+/uNkgI6ZjfZl1EN879ZXhN2AAKMxaQcMvhqC5wDjwPW256rYz0Cu+lWS6Y11+MLnLqVayEGfXYMdFKqZVuDe5ImNOqmJkqROcE15NyPduIcs6WBYPFmTjE+ZwboNtOQhxMo4BOAnV2Z5647e6tneaAin0qlH3ut3EpGf8L4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=RxRa5ZLo; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="RxRa5ZLo" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-ID:Content-Description:In-Reply-To:References; bh=IY6amIQzvvXdfqN8dUCxafj8BNXVCSxt3+ZxyduQ72M=; b=RxRa5ZLorg/wNxC0eVkLcfkwfW arzR11LHcg6cua03crk8AbyAeJfqAVOTYBmTGMsyD1FcONV3APZhxl6gKWs3kLbXm0U7cfwdHn6tW a3liHLVCdelwjqIUavAbQvCU4n+vrcOWRZZpGSgc6KdAHxuo3VMCiDRYod6gITdMpiTjJllXaou8n b8pPw6SSyozZGGUDzKmRNJKa57LBFN7N36aHOBhGVGfrr1fEBoV7I/fNNqx8paMYnf3dlYiZiYMib HpRXVCwj3gXEJJf/I9rSkt5jW7TAd+9Op71ZtkDJyhaSCGa47Wv0bNvfk4gIbqQjkwJcEvN/oSRpB ZQKT/YCQ==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vydNT-00000004ZHT-0Lkk; Fri, 06 Mar 2026 22:10:35 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , =?UTF-8?q?Ville=20Syrj=C3=A4l=C3=A4?= , Jani Nikula , intel-gfx@lists.freedesktop.org, intel-xe@lists.freedesktop.org, dri-devel@lists.freedesktop.org Subject: [PATCH v2] iopoll: fix function parameter names in read_poll_timeout_atomic() Date: Fri, 6 Mar 2026 14:10:32 -0800 Message-ID: <20260306221033.2357305-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Correct the function parameter names to avoid kernel-doc warnings and to emphasize this function is atomic (non-sleeping). Warning: include/linux/iopoll.h:169 function parameter 'sleep_us' not described in 'read_poll_timeout_atomic' Warning: ../include/linux/iopoll.h:169 function parameter 'sleep_before_read' not described in 'read_poll_timeout_atomic' Fixes: 9df8043a546d ("iopoll: Generalize read_poll_timeout() into poll_time= out_us()") Signed-off-by: Randy Dunlap Reviewed-by: Jani Nikula --- v2: change the function parameter names, not the kernel-doc comments (Jani) include/linux/iopoll.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) --- linux-next-20260304.orig/include/linux/iopoll.h +++ linux-next-20260304/include/linux/iopoll.h @@ -159,7 +159,7 @@ * * This macro does not rely on timekeeping. Hence it is safe to call even= when * timekeeping is suspended, at the expense of an underestimation of wall = clock - * time, which is rather minimal with a non-zero delay_us. + * time, which is rather minimal with a non-zero @delay_us. * * When available, you'll probably want to use one of the specialized * macros defined below rather than this macro directly. @@ -167,9 +167,9 @@ * Returns: 0 on success and -ETIMEDOUT upon a timeout. In either * case, the last read value at @args is stored in @val. */ -#define read_poll_timeout_atomic(op, val, cond, sleep_us, timeout_us, \ - sleep_before_read, args...) \ - poll_timeout_us_atomic((val) =3D op(args), cond, sleep_us, timeout_us, sl= eep_before_read) +#define read_poll_timeout_atomic(op, val, cond, delay_us, timeout_us, \ + delay_before_read, args...) \ + poll_timeout_us_atomic((val) =3D op(args), cond, delay_us, timeout_us, de= lay_before_read) =20 /** * readx_poll_timeout - Periodically poll an address until a condition is = met or a timeout occurs --- Cc: Ville Syrj=C3=A4l=C3=A4 Cc: Jani Nikula Cc: intel-gfx@lists.freedesktop.org Cc: intel-xe@lists.freedesktop.org Cc: dri-devel@lists.freedesktop.org