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.
.\" %%%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
inotify \- monitoring filesystem events
.SH DESCRIPTION
@ -306,6 +306,7 @@ field returned by
Watch was removed explicitly
.RB ( inotify_rm_watch (2))
or automatically (file was deleted, or filesystem was unmounted).
See also BUGS.
.TP
.B IN_ISDIR
Subject of this event is a directory.
@ -449,6 +450,16 @@ In kernels before 2.6.16, the
.I mask
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,
.\" commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
the kernel code that was intended to coalesce successive identical events