From: Randy Dunlap Date: Tue, 19 May 2026 04:23:14 +0000 (-0700) Subject: eventpoll: add missing kernel-doc for @ctx function parameters X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=70a03a385de2b8f0fa54dbc70bdc3ed176853d1c;p=thirdparty%2Fkernel%2Flinux.git eventpoll: add missing kernel-doc for @ctx function parameters 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 Link: https://patch.msgid.link/20260519042314.124041-1-rdunlap@infradead.org Signed-off-by: Christian Brauner (Amutable) --- diff --git a/fs/eventpoll.c b/fs/eventpoll.c index a569e98d4a99..baa97d0edade 100644 --- a/fs/eventpoll.c +++ b/fs/eventpoll.c @@ -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. *