[Bug 277238] kqueue(2), kevent(2) manpages are confusing and/or underspecified

From: <bugzilla-noreply_at_freebsd.org>
Date: Fri, 23 Feb 2024 12:41:09 UTC

unitrunker <unitrunker@gmail.com> changed:

           What    |Removed                     |Added
                 CC|                            |unitrunker@gmail.com

--- Comment #1 from unitrunker <unitrunker@gmail.com> ---
As I see it, the way forward is to break this up into smaller pieces and submit
a patch for each one.

I suspect each type likely deserves a separate document - which can be linked
from the main kqueue / kevent mandoc page.

Attaching bits of sample code illustrating observed behavior is extemely
helpful to the review process.

Along these lines, I'd like to add my two cents on documenting how to watch
files and directories (VNODEs). For example, the read and write events on a
directory don't tell you what changed, only that - in the case of a write -
something changed. The best I can determine is you need to take a snapshot of
the directory and, upon receiving a write event, re-read the directory and
compare to see what changed.

It would be nice if the read and write events gave us some sort of identity as
a clue to what changed. Maybe place the top inode of the directory entry than
changed into the ext[] data, for example.

You are receiving this mail because:
You are on the CC list for the bug.