#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: man-pages-l10n VERSION\n"
"POT-Creation-Date: 2014-07-17 17:57+0900\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: man-pages/man7/fanotify.7:25
#, no-wrap
msgid "FANOTIFY"
msgstr ""

#. type: TH
#: man-pages/man7/fanotify.7:25
#, no-wrap
msgid "2014-05-21"
msgstr ""

#. type: TH
#: man-pages/man7/fanotify.7:25
#, no-wrap
msgid "Linux"
msgstr ""

#. type: TH
#: man-pages/man7/fanotify.7:25
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:26
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:28
msgid "fanotify - monitoring filesystem events"
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:28
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:37
msgid ""
"The fanotify API provides notification and interception of filesystem events."
"  Use cases include virus scanning and hierarchical storage management.  "
"Currently, only a limited set of events is supported.  In particular, there "
"is no support for create, delete, and move events.  (See B<inotify>(7)  for "
"details of an API that does notify those events.)"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:44
msgid ""
"Additional capabilities compared to the B<inotify>(7)  API include the "
"ability to monitor all of the objects in a mounted filesystem, the ability "
"to make access permission decisions, and the possibility to read or modify "
"files before access by other applications."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:52
msgid ""
"The following system calls are used with this API: B<fanotify_init>(2), "
"B<fanotify_mark>(2), B<read>(2), B<write>(2), and B<close>(2)."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:52
#, no-wrap
msgid "fanotify_init(), fanotify_mark(), and notification groups"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:57
msgid ""
"The B<fanotify_init>(2)  system call creates and initializes an fanotify "
"notification group and returns a file descriptor referring to it."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:61
msgid ""
"An fanotify notification group is a kernel-internal object that holds a list "
"of files, directories, and mount points for which events shall be created."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:72
msgid ""
"For each entry in an fanotify notification group, two bit masks exist: the "
"I<mark> mask and the I<ignore> mask.  The mark mask defines file activities "
"for which an event shall be created.  The ignore mask defines activities for "
"which no event shall be generated.  Having these two types of masks permits "
"a mount point or directory to be marked for receiving events, while at the "
"same time ignoring events for specific objects under that mount point or "
"directory."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:78
msgid ""
"The B<fanotify_mark>(2)  system call adds a file, directory, or mount to a "
"notification group and specifies which events shall be reported (or "
"ignored), or removes or modifies such an entry."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:91
msgid ""
"A possible usage of the ignore mask is for a file cache.  Events of interest "
"for a file cache are modification of a file and closing of the same.  Hence, "
"the cached directory or mount point is to be marked to receive these events. "
" After receiving the first event informing that a file has been modified, "
"the corresponding cache entry will be invalidated.  No further modification "
"events for this file are of interest until the file is closed.  Hence, the "
"modify event can be added to the ignore mask.  Upon receiving the close "
"event, the modify event can be removed from the ignore mask and the file "
"cache entry can be updated."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:98
msgid ""
"The entries in the fanotify notification groups refer to files and "
"directories via their inode number and to mounts via their mount ID.  If "
"files or directories are renamed or moved, the respective entries survive.  "
"If files or directories are deleted or mounts are unmounted, the "
"corresponding entries are deleted."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:98
#, no-wrap
msgid "The event queue"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:107
msgid ""
"As events occur on the filesystem objects monitored by a notification group, "
"the fanotify system generates events that are collected in a queue.  These "
"events can then be read (using B<read>(2)  or similar)  from the fanotify "
"file descriptor returned by B<fanotify_init>(2)."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:121
msgid ""
"Two types of events are generated: I<notification> events and I<permission> "
"events.  Notification events are merely informative and require no action to "
"be taken by the receiving application except for closing the file descriptor "
"passed in the event (see below).  Permission events are requests to the "
"receiving application to decide whether permission for a file access shall "
"be granted.  For these events, the recipient must write a response which "
"decides whether access is granted or not."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:128
msgid ""
"An event is removed from the event queue of the fanotify group when it has "
"been read.  Permission events that have been read are kept in an internal "
"list of the fanotify group until either a permission decision has been taken "
"by writing to the fanotify file descriptor or the fanotify file descriptor "
"is closed."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:128
#, no-wrap
msgid "Reading fanotify events"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:140
msgid ""
"Calling B<read>(2)  for the file descriptor returned by B<fanotify_init>(2)  "
"blocks (if the flag B<FAN_NONBLOCK> is not specified in the call to "
"B<fanotify_init>(2))  until either a file event occurs or the call is "
"interrupted by a signal (see B<signal>(7))."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:144
msgid ""
"After a successful B<read>(2), the read buffer contains one or more of the "
"following structures:"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:156
#, no-wrap
msgid ""
"struct fanotify_event_metadata {\n"
"    __u32 event_len;\n"
"    __u8 vers;\n"
"    __u8 reserved;\n"
"    __u16 metadata_len;\n"
"    __aligned_u64 mask;\n"
"    __s32 fd;\n"
"    __s32 pid;\n"
"};\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:163
msgid ""
"For performance reasons, it is recommended to use a large buffer size (for "
"example, 4096 bytes), so that multiple events can be retrieved by a single "
"B<read>(2)."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:168
msgid ""
"The return value of B<read>(2)  is the number of bytes placed in the buffer, "
"or -1 in case of an error (but see BUGS)."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:172
msgid "The fields of the I<fanotify_event_metadata> structure are as follows:"
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:172
#, no-wrap
msgid "I<event_len>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:182
msgid ""
"This is the length of the data for the current event and the offset to the "
"next event in the buffer.  In the current implementation, the value of "
"I<event_len> is always B<FAN_EVENT_METADATA_LEN>.  However, the API is "
"designed to allow variable-length structures to be returned in the future."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:182
#, no-wrap
msgid "I<vers>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:191
msgid ""
"This field holds a version number for the structure.  It must be compared to "
"B<FANOTIFY_METADATA_VERSION> to verify that the structures returned at "
"runtime match the structures defined at compile time.  In case of a "
"mismatch, the application should abandon trying to use the fanotify file "
"descriptor."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:191
#, no-wrap
msgid "I<reserved>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:194
msgid "This field is not used."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:194
#, no-wrap
msgid "I<metadata_len>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:200
msgid ""
"This is the length of the structure.  The field was introduced to facilitate "
"the implementation of optional headers per event type.  No such optional "
"headers exist in the current implementation."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:200
#, no-wrap
msgid "I<mask>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:203
msgid "This is a bit mask describing the event (see below)."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:203 man-pages/man7/fanotify.7:360
#, no-wrap
msgid "I<fd>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:211
msgid ""
"This is an open file descriptor for the object being accessed, or "
"B<FAN_NOFD> if a queue overflow occurred.  The file descriptor can be used "
"to access the contents of the monitored file or directory.  The reading "
"application is responsible for closing this file descriptor."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:224
msgid ""
"When calling B<fanotify_init>(2), the caller may specify (via the "
"I<event_f_flags> argument) various file status flags that are to be set on "
"the open file description that corresponds to this file descriptor.  In "
"addition, the (kernel-internal)  B<FMODE_NONOTIFY> file status flag is set "
"on the open file description.  This flag suppresses fanotify event "
"generation.  Hence, when the receiver of the fanotify event accesses the "
"notified file or directory using this file descriptor, no additional events "
"will be created."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:224
#, no-wrap
msgid "I<pid>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:232
msgid ""
"This is the ID of the process that caused the event.  A program listening to "
"fanotify events can compare this PID to the PID returned by B<getpid>(2), to "
"determine whether the event is caused by the listener itself, or is due to a "
"file access by another process."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:242
msgid ""
"The bit mask in I<mask> indicates which events have occurred for a single "
"filesystem object.  Multiple bits may be set in this mask, if more than one "
"event occurred for the monitored filesystem object.  In particular, "
"consecutive events for the same filesystem object and originating from the "
"same process may be merged into a single event, with the exception that two "
"permission events are never merged into one queue entry."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:246
msgid "The bits that may appear in I<mask> are as follows:"
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:246
#, no-wrap
msgid "B<FAN_ACCESS>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:249
msgid "A file or a directory (but see BUGS) was accessed (read)."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:249
#, no-wrap
msgid "B<FAN_OPEN>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:252
msgid "A file or a directory was opened."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:252
#, no-wrap
msgid "B<FAN_MODIFY>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:255
msgid "A file was modified."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:255
#, no-wrap
msgid "B<FAN_CLOSE_WRITE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:262
msgid ""
"A file that was opened for writing (B<O_WRONLY> or B<O_RDWR>)  was closed."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:262
#, no-wrap
msgid "B<FAN_CLOSE_NOWRITE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:267
msgid ""
"A file or directory that was opened read-only (B<O_RDONLY>)  was closed."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:267
#, no-wrap
msgid "B<FAN_Q_OVERFLOW>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:274
msgid ""
"The event queue exceeded the limit of 16384 entries.  This limit can be "
"overridden by specifying the B<FAN_UNLIMITED_QUEUE> flag when calling "
"B<fanotify_init>(2)."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:274
#, no-wrap
msgid "B<FAN_ACCESS_PERM>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:283
msgid ""
"An application wants to read a file or directory, for example using "
"B<read>(2)  or B<readdir>(2).  The reader must write a response (as "
"described below)  that determines whether the permission to access the "
"filesystem object shall be granted."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:283
#, no-wrap
msgid "B<FAN_OPEN_PERM>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:288
msgid ""
"An application wants to open a file or directory.  The reader must write a "
"response that determines whether the permission to open the filesystem "
"object shall be granted."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:290
msgid "To check for any close event, the following bit mask may be used:"
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:290
#, no-wrap
msgid "B<FAN_CLOSE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:294
msgid "A file was closed.  This is a synonym for:"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:296
#, no-wrap
msgid "    FAN_CLOSE_WRITE | FAN_CLOSE_NOWRITE\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:301
msgid ""
"The following macros are provided to iterate over a buffer containing "
"fanotify event metadata returned by a B<read>(2)  from an fanotify file "
"descriptor:"
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:301
#, no-wrap
msgid "B<FAN_EVENT_OK(meta, len)>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:310
msgid ""
"This macro checks the remaining length I<len> of the buffer I<meta> against "
"the length of the metadata structure and the I<event_len> field of the first "
"metadata structure in the buffer."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:310
#, no-wrap
msgid "B<FAN_EVENT_NEXT(meta, len)>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:329
msgid ""
"This macro uses the length indicated in the I<event_len> field of the "
"metadata structure pointed to by I<meta> to calculate the address of the "
"next metadata structure that follows I<meta>.  I<len> is the number of bytes "
"of metadata that currently remain in the buffer.  The macro returns a "
"pointer to the next metadata structure that follows I<meta>, and reduces "
"I<len> by the number of bytes in the the metadata structure that has been "
"skipped over (i.e., it subtracts I<meta-E<gt>event_len> from I<len>)."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:331
msgid "In addition, there is:"
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:331
#, no-wrap
msgid "B<FAN_EVENT_METADATA_LEN>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:337
msgid ""
"This macro returns the size (in bytes) of the structure "
"I<fanotify_event_metadata>.  This is the minimum size (and currently the "
"only size) of any event metadata."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:337
#, no-wrap
msgid "Monitoring an fanotify file descriptor for events"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:344
msgid ""
"When an fanotify event occurs, the fanotify file descriptor indicates as "
"readable when passed to B<epoll>(7), B<poll>(2), or B<select>(2)."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:344
#, no-wrap
msgid "Dealing with permission events"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:349
msgid ""
"For permission events, the application must B<write>(2)  a structure of the "
"following form to the fanotify file descriptor:"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:356
#, no-wrap
msgid "struct fanotify_response {\n"
"    __s32 fd;\n"
"    __u32 response;\n"
"};\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:360
msgid "The fields of this structure are as follows:"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:364
msgid ""
"This is the file descriptor from the structure I<fanotify_event_metadata>."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:364
#, no-wrap
msgid "I<response>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:372
msgid ""
"This field indicates whether or not the permission is to be granted.  Its "
"value must be either B<FAN_ALLOW> to allow the file operation or B<FAN_DENY> "
"to deny the file operation."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:376
msgid ""
"If access is denied, the requesting application call will receive an "
"B<EPERM> error."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:376
#, no-wrap
msgid "Closing the fanotify file descriptor"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:384
msgid ""
"When all file descriptors referring to the fanotify notification group are "
"closed, the fanotify group is released and its resources are freed for reuse "
"by the kernel.  Upon B<close>(2), outstanding permission events will be set "
"to allowed."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:384
#, no-wrap
msgid "/proc/[pid]/fdinfo"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:394
msgid ""
"The file I</proc/[pid]/fdinfo/[fd]> contains information about fanotify "
"marks for file descriptor I<fd> of process I<pid>.  See the kernel source "
"file I<Documentation/filesystems/proc.txt> for details."
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:394
#, no-wrap
msgid "ERRORS"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:399
msgid ""
"In addition to the usual errors for B<read>(2), the following errors can "
"occur when reading from the fanotify file descriptor:"
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:399 man-pages/man7/fanotify.7:433
#, no-wrap
msgid "B<EINVAL>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:402
msgid "The buffer is too small to hold the event."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:402
#, no-wrap
msgid "B<EMFILE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:409
msgid ""
"The per-process limit on the number of open files has been reached.  See the "
"description of B<RLIMIT_NOFILE> in B<getrlimit>(2)."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:409
#, no-wrap
msgid "B<ENFILE>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:416
msgid ""
"The system-wide limit on the number of open files has been reached.  See I</"
"proc/sys/fs/file-max> in B<proc>(5)."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:416
#, no-wrap
msgid "B<ETXTBSY>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:429
msgid ""
"This error is returned by B<read>(2)  if B<O_RDWR> or B<O_WRONLY> was "
"specified in the I<event_f_flags> argument when calling B<fanotify_init>(2)  "
"and an event occurred for a monitored file that is currently being executed."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:433
msgid ""
"In addition to the usual errors for B<write>(2), the following errors can "
"occur when writing to the fanotify file descriptor:"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:439
msgid ""
"Fanotify access permissions are not enabled in the kernel configuration or "
"the value of I<response> in the response structure is not valid."
msgstr ""

#. type: TP
#: man-pages/man7/fanotify.7:439
#, no-wrap
msgid "B<ENOENT>"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:446
msgid ""
"The file descriptor I<fd> in the response structure is not valid.  This may "
"occur when a response for the permission event has already been written."
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:446
#, no-wrap
msgid "VERSIONS"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:450
msgid ""
"The fanotify API was introduced in version 2.6.36 of the Linux kernel and "
"enabled in version 2.6.37.  Fdinfo support was added in version 3.8."
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:450
#, no-wrap
msgid "CONFORMING TO"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:452
msgid "The fanotify API is Linux-specific."
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:452
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:459
msgid ""
"The fanotify API is available only if the kernel was built with the "
"B<CONFIG_FANOTIFY> configuration option enabled.  In addition, fanotify "
"permission handling is available only if the "
"B<CONFIG_FANOTIFY_ACCESS_PERMISSIONS> configuration option is enabled."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:459
#, no-wrap
msgid "Limitations and caveats"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:464
msgid ""
"Fanotify reports only events that a user-space program triggers through the "
"filesystem API.  As a result, it does not catch remote events that occur on "
"network filesystems."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:471
msgid ""
"The fanotify API does not report file accesses and modifications that may "
"occur because of B<mmap>(2), B<msync>(2), and B<munmap>(2)."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:476
msgid ""
"Events for directories are created only if the directory itself is opened, "
"read, and closed.  Adding, removing, or changing children of a marked "
"directory does not create events for the monitored directory itself."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:484
msgid ""
"Fanotify monitoring of directories is not recursive: to monitor "
"subdirectories under a directory, additional marks must be created.  (But "
"note that the fanotify API provides no way of detecting when a subdirectory "
"has been created under a marked directory, which makes recursive monitoring "
"difficult.)  Monitoring mounts offers the capability to monitor a whole "
"directory tree."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:487
msgid "The event queue can overflow.  In this case, events are lost."
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:487
#, no-wrap
msgid "BUGS"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:490
msgid "As of Linux 3.15, the following bugs exist:"
msgstr ""

#. type: IP
#: man-pages/man7/fanotify.7:490 man-pages/man7/fanotify.7:499
#, no-wrap
msgid "*"
msgstr ""

#.  FIXME: A patch was proposed.
#. type: Plain text
#: man-pages/man7/fanotify.7:499
msgid ""
"When an event is generated, no check is made to see whether the user ID of "
"the receiving process has authorization to read or write the file before "
"passing a file descriptor for that file.  This poses a security risk, when "
"the B<CAP_SYS_ADMIN> capability is set for programs executed by unprivileged "
"users."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:509
msgid ""
"If a call to B<read>(2)  processes multiple events from the fanotify queue "
"and an error occurs, the return value will be the total length of the events "
"successfully copied to the user-space buffer before the error occurred.  The "
"return value will not be -1, and I<errno> will not be set.  Thus, the "
"reading application has no way to detect the error."
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:509
#, no-wrap
msgid "EXAMPLE"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:519
msgid ""
"The following program demonstrates the usage of the fanotify API.  It marks "
"the mount point passed as a command-line argument and waits for events of "
"type B<FAN_PERM_OPEN> and B<FAN_CLOSE_WRITE>.  When a permission event "
"occurs, a B<FAN_ALLOW> response is given."
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:529
msgid ""
"The following output was recorded while editing the file I</home/user/temp/"
"notes>.  Before the file was opened, a B<FAN_OPEN_PERM> event occurred.  "
"After the file was closed, a B<FAN_CLOSE_WRITE> event occurred.  Execution "
"of the program ends when the user presses the ENTER key."
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:529
#, no-wrap
msgid "Example output"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:537
#, no-wrap
msgid ""
"# ./fanotify_example /home\n"
"Press enter key to terminate.\n"
"Listening for events.\n"
"FAN_OPEN_PERM: File /home/user/temp/notes\n"
"FAN_CLOSE_WRITE: File /home/user/temp/notes\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:539
#, no-wrap
msgid "Listening for events stopped.\n"
msgstr ""

#. type: SS
#: man-pages/man7/fanotify.7:541
#, no-wrap
msgid "Program source"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:552
#, no-wrap
msgid ""
"#define _GNU_SOURCE     /* Needed to get O_LARGEFILE definition */\n"
"#include E<lt>errno.hE<gt>\n"
"#include E<lt>fcntl.hE<gt>\n"
"#include E<lt>limits.hE<gt>\n"
"#include E<lt>poll.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>sys/fanotify.hE<gt>\n"
"#include E<lt>unistd.hE<gt>\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:554
#, no-wrap
msgid ""
"/* Read all available fanotify events from the file descriptor 'fd' */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:565
#, no-wrap
msgid ""
"static void\n"
"handle_events(int fd)\n"
"{\n"
"    const struct fanotify_event_metadata *metadata;\n"
"    struct fanotify_event_metadata buf[200];\n"
"    ssize_t len;\n"
"    char path[PATH_MAX];\n"
"    ssize_t path_len;\n"
"    char procfd_path[PATH_MAX];\n"
"    struct fanotify_response response;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:567
#, no-wrap
msgid "    /* Loop while events can be read from fanotify file descriptor */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:569
#, no-wrap
msgid "    for(;;) {\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:571
#, no-wrap
msgid "        /* Read some events */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:577
#, no-wrap
msgid ""
"        len = read(fd, (void *) &buf, sizeof(buf));\n"
"        if (len == -1 && errno != EAGAIN) {\n"
"            perror(\"read\");\n"
"            exit(EXIT_FAILURE);\n"
"        }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:579
#, no-wrap
msgid "        /* Check if end of available data reached */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:582
#, no-wrap
msgid "        if (len E<lt>= 0)\n"
"            break;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:584
#, no-wrap
msgid "        /* Point to the first event in the buffer */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:586
#, no-wrap
msgid "        metadata = buf;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:588
#, no-wrap
msgid "        /* Loop over all events in the buffer */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:590
#, no-wrap
msgid "        while (FAN_EVENT_OK(metadata, len)) {\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:592
#, no-wrap
msgid ""
"            /* Check that run-time and compile-time structures match */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:598
#, no-wrap
msgid ""
"            if (metadata-E<gt>vers != FANOTIFY_METADATA_VERSION) {\n"
"                fprintf(stderr,\n"
"                        \"Mismatch of fanotify metadata version.\\en\");\n"
"                exit(EXIT_FAILURE);\n"
"            }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:602
#, no-wrap
msgid ""
"            /* metadata-E<gt>fd contains either FAN_NOFD, indicating a\n"
"               queue overflow, or a file descriptor (a nonnegative\n"
"               integer). Here, we simply ignore queue overflow. */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:604
#, no-wrap
msgid "            if (metadata-E<gt>fd E<gt>= 0) {\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:606
#, no-wrap
msgid "                /* Handle open permission event */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:609
#, no-wrap
msgid ""
"                if (metadata-E<gt>mask & FAN_OPEN_PERM) {\n"
"                    printf(\"FAN_OPEN_PERM: \");\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:611
#, no-wrap
msgid "                    /* Allow file to be opened */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:617
#, no-wrap
msgid ""
"                    response.fd = metadata-E<gt>fd;\n"
"                    response.response = FAN_ALLOW;\n"
"                    write(fd, &response,\n"
"                          sizeof(struct fanotify_response));\n"
"                }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:619
#, no-wrap
msgid "                /* Handle closing of writable file event */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:622
#, no-wrap
msgid ""
"                if (metadata-E<gt>mask & FAN_CLOSE_WRITE)\n"
"                    printf(\"FAN_CLOSE_WRITE: \");\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:624
#, no-wrap
msgid ""
"                /* Retrieve and print pathname of the accessed file */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:633
#, no-wrap
msgid ""
"                snprintf(procfd_path, sizeof(procfd_path),\n"
"                         \"/proc/self/fd/%d\", metadata-E<gt>fd);\n"
"                path_len = readlink(procfd_path, path,\n"
"                                    sizeof(path) - 1);\n"
"                if (path_len == -1) {\n"
"                    perror(\"readlink\");\n"
"                    exit(EXIT_FAILURE);\n"
"                }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:636
#, no-wrap
msgid ""
"                path[path_len] = '\\e0';\n"
"                printf(\"File %s\\en\", path);\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:638
#, no-wrap
msgid "                /* Close the file descriptor of the event */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:641
#, no-wrap
msgid "                close(metadata-E<gt>fd);\n"
"            }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:643
#, no-wrap
msgid "            /* Advance to next event */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:648
#, no-wrap
msgid ""
"            metadata = FAN_EVENT_NEXT(metadata, len);\n"
"        }\n"
"    }\n"
"}\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:656
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    char buf;\n"
"    int fd, poll_num;\n"
"    nfds_t nfds;\n"
"    struct pollfd fds[2];\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:658
#, no-wrap
msgid "    /* Check mount point is supplied */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:663
#, no-wrap
msgid ""
"    if (argc != 2) {\n"
"        fprintf(stderr, \"Usage: %s MOUNT\\en\", argv[0]);\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:665
#, no-wrap
msgid "    printf(\"Press enter key to terminate.\\en\");\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:667
#, no-wrap
msgid "    /* Create the file descriptor for accessing the fanotify API */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:674
#, no-wrap
msgid ""
"    fd = fanotify_init(FAN_CLOEXEC | FAN_CLASS_CONTENT | FAN_NONBLOCK,\n"
"                       O_RDONLY | O_LARGEFILE);\n"
"    if (fd == -1) {\n"
"        perror(\"fanotify_init\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:679
#, no-wrap
msgid ""
"    /* Mark the mount for:\n"
"       - permission events before opening files\n"
"       - notification events after closing a write-enabled\n"
"         file descriptor */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:686
#, no-wrap
msgid ""
"    if (fanotify_mark(fd, FAN_MARK_ADD | FAN_MARK_MOUNT,\n"
"                      FAN_OPEN_PERM | FAN_CLOSE_WRITE, -1,\n"
"                      argv[1]) == -1) {\n"
"        perror(\"fanotify_mark\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:688
#, no-wrap
msgid "    /* Prepare for polling */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:690
#, no-wrap
msgid "    nfds = 2;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:692
#, no-wrap
msgid "    /* Console input */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:695
#, no-wrap
msgid "    fds[0].fd = STDIN_FILENO;\n"
"    fds[0].events = POLLIN;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:697
#, no-wrap
msgid "    /* Fanotify input */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:700
#, no-wrap
msgid "    fds[1].fd = fd;\n"
"    fds[1].events = POLLIN;\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:702
#, no-wrap
msgid "    /* This is the loop to wait for incoming events */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:704
#, no-wrap
msgid "    printf(\"Listening for events.\\en\");\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:710
#, no-wrap
msgid ""
"    while (1) {\n"
"        poll_num = poll(fds, nfds, -1);\n"
"        if (poll_num == -1) {\n"
"            if (errno == EINTR)     /* Interrupted by a signal */\n"
"                continue;           /* Restart poll() */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:714
#, no-wrap
msgid ""
"            perror(\"poll\");         /* Unexpected error */\n"
"            exit(EXIT_FAILURE);\n"
"        }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:717
#, no-wrap
msgid ""
"        if (poll_num E<gt> 0) {\n"
"            if (fds[0].revents & POLLIN) {\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:719
#, no-wrap
msgid ""
"                /* Console input is available: empty stdin and quit */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:724
#, no-wrap
msgid ""
"                while (read(STDIN_FILENO, &buf, 1) E<gt> 0 && buf != '\\en')\n"
"                    continue;\n"
"                break;\n"
"            }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:726
#, no-wrap
msgid "            if (fds[1].revents & POLLIN) {\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:728
#, no-wrap
msgid "                /* Fanotify events are available */\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:733
#, no-wrap
msgid "                handle_events(fd);\n"
"            }\n"
"        }\n"
"    }\n"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:737
#, no-wrap
msgid ""
"    printf(\"Listening for events stopped.\\en\");\n"
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:738
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:743
msgid "B<fanotify_init>(2), B<fanotify_mark>(2), B<inotify>(7)"
msgstr ""

#. type: SH
#: man-pages/man7/fanotify.7:743
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: man-pages/man7/fanotify.7:751
msgid ""
"This page is part of release 3.70 of the Linux I<man-pages> project.  A "
"description of the project, information about reporting bugs, and the latest "
"version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/"
"."
msgstr ""