inotify.7: BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped

A silent change as a result of the fanotify work in kernel 2.6.36.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-03-28 14:55:35 +01:00
parent d54837e835
commit 7b5151b7f0
1 changed files with 12 additions and 1 deletions

View File

@ -23,7 +23,7 @@
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END .\" %%%LICENSE_END
.\" .\"
.TH INOTIFY 7 2014-03-25 "Linux" "Linux Programmer's Manual" .TH INOTIFY 7 2014-03-28 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
inotify \- monitoring filesystem events inotify \- monitoring filesystem events
.SH DESCRIPTION .SH DESCRIPTION
@ -306,6 +306,7 @@ field returned by
Watch was removed explicitly Watch was removed explicitly
.RB ( inotify_rm_watch (2)) .RB ( inotify_rm_watch (2))
or automatically (file was deleted, or filesystem was unmounted). or automatically (file was deleted, or filesystem was unmounted).
See also BUGS.
.TP .TP
.B IN_ISDIR .B IN_ISDIR
Subject of this event is a directory. Subject of this event is a directory.
@ -449,6 +450,16 @@ In kernels before 2.6.16, the
.I mask .I mask
flag does not work. flag does not work.
As originally designed and implemented, the
.B IN_ONESHOT
flag did not cause an
.B IN_IGNORED
event to be generated when the watch was dropped after one event.
However, as an unintended effect of other changes,
since Linux 2.6.36, an
.B IN_IGNORED
event is generated in this case.
Before kernel 2.6.25, Before kernel 2.6.25,
.\" commit 1c17d18e3775485bf1e0ce79575eb637a94494a2 .\" commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
the kernel code that was intended to coalesce successive identical events the kernel code that was intended to coalesce successive identical events