FANOTIFY_INIT(2) Linux Programmer's Manual FANOTIFY_INIT(2)NAMEfanotify_init - initialize a fanotify group
SYNOPSIS
int fanotify_init(unsigned int flags, unsigned int event_f_flags,
int priority);
DESCRIPTIONfanotify_init () initializes a new fanotify instance and returns a file
descriptor associated with the new fanotify event queue. The calling
process must possess the CAP_SYS_ADMIN capability to invoke this system
call.
The following values can be OR'd into the flags field:
FAN_NONBLOCK
Set the O_NONBLOCK file status flag on the new open file
description. Using this flag saves extra calls to fcntl(2) to
achieve the same result.
FAN_CLOEXEC
Set the close-on-exec ( FD_CLOEXEC ) flag on the new file
descriptor. See the description of the O_CLOEXEC flag in
open(2) for reasons why this may be useful.
FAN_CLASS_NOTIF
Unused.
FAN_CLASS_CONTENT
Unused.
FAN_CLASS_PRE_CONTENT
Unused.
FAN_UNLIMITED_QUEUE
Set the size of the fanotify event queue to unlimited.
FAN_UNLIMITED_MARKS
Set the number of the fanotify data mark maintained by the fan‐
otify group to unlimited.
The event_f_flags argument is unused and must be set to 0.
The priority argument is unused and must be set to 0.
RETURN VALUE
On success, this system call return a new file descriptor. On error, -1
is returned, and errno is set to indicate the error.
ERRORS
EINVAL An invalid value was specified in the flags argument.
EINVAL A non-zero valid was passed in the event_f_flags or the priority
arguments.
EMFILE The system limit on the total number of file descriptors has
been reached.
ENOMEM Insufficient kernel memory is available.
EPERM The calling process does not possess the CAP_SYS_ADMIN capabil‐
ity.
CONFORMING TO
These system calls are Linux-specific.
SEE ALSOfanotify_mark(2)Linux 2011-09-08 FANOTIFY_INIT(2)