Skip to content

Commit cc7d6c6

Browse files
KRIISHSHARMAbrauner
authored andcommitted
nstree: fix kernel-doc comments for internal functions
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 `@ns_tree` parameter description for `__ns_tree_adjoined_rcu()`. Fixes: 885fc8a ("nstree: make iterator generic") Reported-by: kernel test robot <lkp@intel.com> Closes: https://lore.kernel.org/oe-kbuild-all/202511061542.0LO7xKs8-lkp@intel.com Signed-off-by: Kriish Sharma <kriish.sharma2006@gmail.com> Link: https://patch.msgid.link/20251111112533.2254432-1-kriish.sharma2006@gmail.com Signed-off-by: Christian Brauner <brauner@kernel.org>
1 parent cefd55b commit cc7d6c6

1 file changed

Lines changed: 3 additions & 2 deletions

File tree

kernel/nstree.c

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -353,9 +353,10 @@ struct ns_common *ns_tree_lookup_rcu(u64 ns_id, int ns_type)
353353
}
354354

355355
/**
356-
* ns_tree_adjoined_rcu - find the next/previous namespace in the same
356+
* __ns_tree_adjoined_rcu - find the next/previous namespace in the same
357357
* tree
358358
* @ns: namespace to start from
359+
* @ns_tree: namespace tree to search in
359360
* @previous: if true find the previous namespace, otherwise the next
360361
*
361362
* Find the next or previous namespace in the same tree as @ns. If
@@ -379,7 +380,7 @@ struct ns_common *__ns_tree_adjoined_rcu(struct ns_common *ns,
379380
}
380381

381382
/**
382-
* ns_tree_gen_id - generate a new namespace id
383+
* __ns_tree_gen_id - generate a new namespace id
383384
* @ns: namespace to generate id for
384385
* @id: if non-zero, this is the initial namespace and this is a fixed id
385386
*

0 commit comments

Comments
 (0)