git: fa6fe034a73c - main - inotify.2: Add some entries to the BUGS section

The branch main has been updated by markj:

URL: https://cgit.FreeBSD.org/src/commit/?id=fa6fe034a73c8b17320d1e68767ad2aa99eaa8bf

commit fa6fe034a73c8b17320d1e68767ad2aa99eaa8bf
Author:     Mark Johnston <markj@FreeBSD.org>
AuthorDate: 2026-10-07 14:36:46 +0000
Commit:     Mark Johnston <markj@FreeBSD.org>
CommitDate: 2026-10-07 14:55:57 +0000

    inotify.2: Add some entries to the BUGS section
    
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
---
 lib/libsys/inotify.2 | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/lib/libsys/inotify.2 b/lib/libsys/inotify.2
index 0728c65af975..f0844452f488 100644
--- a/lib/libsys/inotify.2
+++ b/lib/libsys/inotify.2
@@ -3,7 +3,7 @@
 .\"
 .\" Copyright (c) 2025 Klara, Inc.
 .\"
-.Dd May 19, 2025
+.Dd October 7, 2026
 .Dt INOTIFY 2
 .Os
 .Sh NAME
@@ -377,3 +377,27 @@ Thus, the
 implementation behaves as though
 .Dv IN_EXCL_UNLINK
 is always set.
+.Pp
+Some inotify events rely on the kernel's name cache in order to determine
+the name of the file being accessed.
+Some filesystems do not use the name cache, for instance
+.Xr devfs 4 ,
+and
+.Xr tmpfs 4
+mounts with the
+.Dv nonc
+option set.
+inotify may not reliably deliver events for files on such filesystems.
+.Pp
+inotify does not deliver events for
+.Xr devfs 4
+files so as to avoid leaking potentially sensitive timing information.
+For instance,
+.Dv IN_ACCESS
+events on
+.Pa /dev/input
+could be used to determine information about keyboard input from a different
+user.
+A watch on a
+.Xr devfs 4
+file or directory may be created, but will not deliver any events.