From nobody Sat Jul 25 03:47:37 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 A80DC3AEF3A for ; Sun, 19 Jul 2026 17:55:02 +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=1784483707; cv=none; b=UfRMnTdxuCWVT1Wll3ErnMaiA4EC0eR2u+j9TXFcOervPUIZkIi1scp1iFOwrD7cgyru1KBLMvCGd8dhmlIjAK2Rjdb3o9V4lzKhF6AcyzB+M8CVdxzupbdrDRb4gev098Dh3nAKbHtYk/5gDo3RIWm80aVkeEITrS0ENMp8QOE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784483707; c=relaxed/simple; bh=jBHXh+rn3+3cPCK41I0PWtV1eSh08t/LCroJr93x47g=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=gN5g6x7jSp5+RrZm7pqyI2Bb3p1JP+L3vYpRCD8urVAa9LN2lco/CCZ8P+dKgdN9qOGjwFesAsPvln0WnQVW5jxVsslyjsnywkXygOqc1d/Jf3HNrAOA1HwMh0aAYulDCb6Y5Drcz8VKeuCKsN9sUE5hpfiaVA0yCN0Rt0csG/o= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=pass smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=v7ou255w; 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=pass 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="v7ou255w" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=0UACY0iXXl3h/ZmMNVR7DhuNNsEKzB/ECRwPNC4VsqM=; b=v7ou255w9b5BsJyr8HAu7dDNu1 3P5690SxH86fM4CK77VbuB7xMRDJ5rxAHdawgQ1BAYPBQa3Mhffv0PzTob1RegCjvF3UaCxVIGBxv nQlvTpg2Ox2hXIpofsoCEem9uaOwiFIfPe0bYR7JztyVz1LRqCWq1NGb70GvpNSacfd2pXjc4Dwth +Z0CTysvAizzzlWNG7UbSn8fQoKPVKjT2q2JRJEig+vU8Fr4OeWF+f2an7kOyPKhurKlYn+0U0nvM Uuxcm8tsQ8+ds9iQvGgJjB7lr9WR2wFh/tuSpcrLqAiajsUZARrBHj5aXkIPGF4HVyaW6Wr47w/F9 SPpL48FQ==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.99.1 #2 (Red Hat Linux)) id 1wlVjB-00000005EsQ-1kpz; Sun, 19 Jul 2026 17:55:01 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , x86@kernel.org, "H. Peter Anvin" Subject: [PATCH] x86/lib: checksum_64.h: eliminate all kernel-doc warnings Date: Sun, 19 Jul 2026 10:55:00 -0700 Message-ID: <20260719175500.2636351-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.55.0 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 Content-Type: text/plain; charset="utf-8" - correct missing function parameter names - add missing function return value sections - use the correct function name in comments to avoid these warnings (samples): Warning: arch/x86/include/asm/checksum_64.h:23 No description found for return value of 'csum_fold' Warning: arch/x86/include/asm/checksum_64.h:46 function parameter 'iph' not described in 'ip_fast_csum' Warning: arch/x86/include/asm/checksum_64.h:46 function parameter 'ihl' not described in 'ip_fast_csum' Warning: arch/x86/include/asm/checksum_64.h:46 No description found for return value of 'ip_fast_csum' Warning: arch/x86/include/asm/checksum_64.h:89 expecting prototype for csum_tcpup_nofold(). Prototype was for csum_tcpudp_nofold() instead Warning: arch/x86/include/asm/checksum_64.h:115 expecting prototype for csum_tcpup_magic(). Prototype was for csum_tcpudp_magic() instead Warning: arch/x86/include/asm/checksum_64.h:119 No description found for return value of 'csum_tcpudp_magic' Warning: arch/x86/include/asm/checksum_64.h:129 No description found for return value of 'csum_partial' Warning: ./arch/x86/include/asm/checksum_64.h:175 function parameter '_saddr' not described in 'csum_ipv6_magic' Warning: ./arch/x86/include/asm/checksum_64.h:175 function parameter '_daddr' not described in 'csum_ipv6_magic' Warning: ./arch/x86/include/asm/checksum_64.h:175 Excess function parameter 'saddr' description in 'csum_ipv6_magic' Warning: ./arch/x86/include/asm/checksum_64.h:175 Excess function parameter 'daddr' description in 'csum_ipv6_magic' Signed-off-by: Randy Dunlap --- Cc: Thomas Gleixner Cc: Ingo Molnar Cc: Borislav Petkov Cc: Dave Hansen Cc: x86@kernel.org Cc: "H. Peter Anvin" arch/x86/include/asm/checksum_64.h | 29 +++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) --- linux-next-20260717.orig/arch/x86/include/asm/checksum_64.h +++ linux-next-20260717/arch/x86/include/asm/checksum_64.h @@ -14,11 +14,13 @@ =20 /** * csum_fold - Fold and invert a 32bit checksum. - * sum: 32bit unfolded sum + * @sum: 32bit unfolded sum * * Fold a 32bit running checksum to 16bit and invert it. This is usually * the last step before putting a checksum into a packet. * Make sure not to mix with 64bit checksums. + * + * Returns: new checksum value */ static inline __sum16 csum_fold(__wsum sum) { @@ -40,8 +42,10 @@ static inline __sum16 csum_fold(__wsum s =20 /** * ip_fast_csum - Compute the IPv4 header checksum efficiently. - * iph: ipv4 header - * ihl: length of header / 4 + * @iph: ipv4 header + * @ihl: length of header / 4 + * + * Returns: header checksum */ static inline __sum16 ip_fast_csum(const void *iph, unsigned int ihl) { @@ -74,14 +78,14 @@ static inline __sum16 ip_fast_csum(const } =20 /** - * csum_tcpup_nofold - Compute an IPv4 pseudo header checksum. + * csum_tcpudp_nofold - Compute an IPv4 pseudo header checksum. * @saddr: source address * @daddr: destination address * @len: length of packet * @proto: ip protocol of packet * @sum: initial sum to be added in (32bit unfolded) * - * Returns the pseudo header checksum the input data. Result is + * Returns: the pseudo header checksum the input data. Result is * 32bit unfolded. */ static inline __wsum @@ -100,14 +104,14 @@ csum_tcpudp_nofold(__be32 saddr, __be32 =20 =20 /** - * csum_tcpup_magic - Compute an IPv4 pseudo header checksum. + * csum_tcpudp_magic - Compute an IPv4 pseudo header checksum. * @saddr: source address * @daddr: destination address * @len: length of packet * @proto: ip protocol of packet * @sum: initial sum to be added in (32bit unfolded) * - * Returns the 16bit pseudo header checksum the input data already + * Returns: the 16bit pseudo header checksum the input data already * complemented and ready to be filled in. */ static inline __sum16 csum_tcpudp_magic(__be32 saddr, __be32 daddr, @@ -123,7 +127,7 @@ static inline __sum16 csum_tcpudp_magic( * @len: length of buffer. * @sum: initial sum to be added in (32bit unfolded) * - * Returns the 32bit unfolded internet checksum of the buffer. + * Returns: the 32bit unfolded internet checksum of the buffer. * Before filling it in it needs to be csum_fold()'ed. * buff should be aligned to a 64bit boundary if possible. */ @@ -141,7 +145,7 @@ extern __wsum csum_partial_copy_nocheck( * @buff: buffer address. * @len: length of buffer. * - * Returns the 16bit folded/inverted checksum of the passed buffer. + * Returns: the 16bit folded/inverted checksum of the passed buffer. * Ready to fill in. */ extern __sum16 ip_compute_csum(const void *buff, int len); @@ -159,15 +163,16 @@ static inline unsigned add32_with_carry( =20 /** * csum_ipv6_magic - Compute checksum of an IPv6 pseudo header. - * @saddr: source address - * @daddr: destination address + * @_saddr: source address + * @_daddr: destination address * @len: length of packet * @proto: protocol of packet * @sum: initial sum (32bit unfolded) to be added in * * Computes an IPv6 pseudo header checksum. This sum is added the checksum * into UDP/TCP packets and contains some link layer information. - * Returns the unfolded 32bit checksum. + * + * Returns: the unfolded 32bit checksum. */ =20 static inline __sum16 csum_ipv6_magic(