]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
eventpoll: add missing kernel-doc for @ctx function parameters
authorRandy Dunlap <rdunlap@infradead.org>
Tue, 19 May 2026 04:23:14 +0000 (21:23 -0700)
committerChristian Brauner <brauner@kernel.org>
Fri, 22 May 2026 12:32:06 +0000 (14:32 +0200)
Add the missing kernel-doc comments to prevent kernel-doc build
warnings while building the documentation.

WARNING: fs/eventpoll.c:1684 function parameter 'ctx' not described in 'reverse_path_check'
WARNING: fs/eventpoll.c:2349 function parameter 'ctx' not described in 'ep_loop_check_proc'

Fixes: e09c77d94003 ("eventpoll: hoist CTL_ADD scratch state into struct ep_ctl_ctx")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://patch.msgid.link/20260519042314.124041-1-rdunlap@infradead.org
Signed-off-by: Christian Brauner (Amutable) <brauner@kernel.org>
fs/eventpoll.c

index a569e98d4a9964622f663c38139f0fe8010456c7..baa97d0edade11521621e268619b26e6abb7e544 100644 (file)
@@ -1677,6 +1677,7 @@ static int reverse_path_check_proc(struct ep_ctl_ctx *ctx,
  *                      anchoring files with newly proposed links; make
  *                      sure those links don't push any path-length bucket
  *                      over its limit in path_limits[].
+ * @ctx: Per-do_epoll_ctl() scratch for the loop / path checks.
  *
  * Return: %zero if the proposed links don't create too many paths,
  *         %-1 otherwise.
@@ -2339,6 +2340,7 @@ static int ep_poll(struct eventpoll *ep, struct epoll_event __user *events,
  *                      epoll file does not create closed loops, and
  *                      determine the depth of the subtree starting at @ep
  *
+ * @ctx: Per-do_epoll_ctl() scratch for the loop / path checks.
  * @ep: the &struct eventpoll to be currently checked.
  * @depth: Current depth of the path being checked.
  *