Man pages for the fanotify API: merging of events

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Michael,

could , please, help me to get the following fixed:

On 24.03.2014 22:23, Michael Kerrisk (man-pages) wrote:
The pages say nothing about merging of events. Merging can happen
for non-permission events, but not for permission events.
Something needs to be said about this, probably in fanotify(7)
If you are unsure of what I mean, just add the following in
fanotify(7)

.\" FIXME Document merging of events
At least there was: "The bitmask in *mask* signals which events
have occured for a single file system object. More than one of the
following flags can be set at once in the bitmask."

But this of cause does not describe that consecutive events might have been merged (=> Needs to be fixed in man page).

In the current coding permission events are not merged with other
events.

This feature did not exist in the kernel until two months ago, while the API is much older.

See patch
https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=13116dfd13c8c9d60ea04ece13419af2de8e2e37

What I am unsure about is, whether the fanotify manpage should make any assumption that this feature will hold true for future kernel releases.

To me not merging permission events with other events seems rather to be a fix for some coding internal problem not something that typically would go into the specification.

What is your opinion?

Best regards

Heinrich Schuchardt
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux