linux-kernel - Re: [PATCH] nstree: fix kernel-doc comments for internal functions

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20251112-ritzen-waldrand-13e6645e0a9c@brauner>
Date: Wed, 12 Nov 2025 12:24:45 +0100
From: Christian Brauner <brauner@...nel.org>
To: jack@...e.cz,
	jlayton@...nel.org,
	Kriish Sharma <kriish.sharma2006@...il.com>
Cc: Christian Brauner <brauner@...nel.org>,
	linux-kernel@...r.kernel.org,
	kernel test robot <lkp@...el.com>
Subject: Re: [PATCH] nstree: fix kernel-doc comments for internal functions

On Tue, 11 Nov 2025 11:25:33 +0000, Kriish Sharma wrote:
> Documentation build reported:
> 
>   Warning: kernel/nstree.c:325 function parameter 'ns_tree' not described in '__ns_tree_adjoined_rcu'
>   Warning: kernel/nstree.c:325 expecting prototype for ns_tree_adjoined_rcu(). Prototype was for __ns_tree_adjoined_rcu() instead
>   Warning: kernel/nstree.c:353 expecting prototype for ns_tree_gen_id(). Prototype was for __ns_tree_gen_id() instead
> 
> The kernel-doc comments for `__ns_tree_adjoined_rcu()` and
> `__ns_tree_gen_id()` had mismatched function names and a missing
> parameter description. This patch updates the function names in the
> kernel-doc headers and adds the missing `@...tree` parameter description
> for `__ns_tree_adjoined_rcu()`.
> 
> [...]

Applied to the namespace-6.19 branch of the vfs/vfs.git tree.
Patches in the namespace-6.19 branch should appear in linux-next soon.

Please report any outstanding bugs that were missed during review in a
new review to the original patch series allowing us to drop it.

It's encouraged to provide Acked-bys and Reviewed-bys even though the
patch has now been applied. If possible patch trailers will be updated.

Note that commit hashes shown below are subject to change due to rebase,
trailer updates or similar. If in doubt, please check the listed branch.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs.git
branch: namespace-6.19

[1/1] nstree: fix kernel-doc comments for internal functions
      https://git.kernel.org/vfs/vfs/c/05518c2e7132