Hello, I would like to report a documentation bug in the kqueue(2) manual page regarding the HISTORY section. [Current Text] The HISTORY section currently states: "The kqueuex() system call and kevent1() function first appeared in FreeBSD 14.0." [Problem] According to the SYNOPSIS section, the function introduced for compatibility with NetBSD is `kqueue1(int flags)`, not `kevent1()`. The reference to `kevent1()` appears to be a typo. Additionally, to maintain consistency with the previous sentence ("The kqueue() and kevent() system calls..."), it would be more natural to group them as "system calls". [Suggested Fix] Please replace the incorrect text with the following: "The kqueuex() and kqueue1() system calls first appeared in FreeBSD 14.0." Thank you.
Hi Hodong! Thank you for the report! I submitted a patch that fixed this: https://reviews.freebsd.org/D54858. > Additionally, to maintain consistency with the previous sentence > ("The kqueue() and kevent() system calls..."), it would be more > natural to group them as "system calls". Due to my vague understanding, kqueue1() is not a system call - it's not listed in the lib/libsys/syscalls.map. So I believe, we should keep refering to kqueue1() as function, not system call.
A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=4efe75af0869dd71a26685c432e5284d71bf4dc8 commit 4efe75af0869dd71a26685c432e5284d71bf4dc8 Author: Artem Bunichev <tembun@bk.ru> AuthorDate: 2026-01-25 15:39:48 +0000 Commit: Mark Johnston <markj@FreeBSD.org> CommitDate: 2026-01-25 22:41:24 +0000 kqueue.2: Fix reference to unexisting kevent1() kqueue1() was meant. While here, make the wording in the AUTHORS section more clear. PR: 291908 Fixes: 9b1585384d53 ("kqueue.2: Editorial pass") Reviewed by: kib, dab MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D54858 lib/libsys/kqueue.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
A commit in branch stable/15 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=389762add05c201ad2941ac50ba31c89ded62356 commit 389762add05c201ad2941ac50ba31c89ded62356 Author: Artem Bunichev <tembun@bk.ru> AuthorDate: 2026-01-25 15:39:48 +0000 Commit: Mark Johnston <markj@FreeBSD.org> CommitDate: 2026-02-09 18:03:41 +0000 kqueue.2: Fix reference to unexisting kevent1() kqueue1() was meant. While here, make the wording in the AUTHORS section more clear. PR: 291908 Fixes: 9b1585384d53 ("kqueue.2: Editorial pass") Reviewed by: kib, dab MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D54858 (cherry picked from commit 4efe75af0869dd71a26685c432e5284d71bf4dc8) lib/libsys/kqueue.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)