diff options
Diffstat (limited to '')
-rw-r--r-- | templates/man2/fanotify_mark.2.pot | 1334 |
1 files changed, 1334 insertions, 0 deletions
diff --git a/templates/man2/fanotify_mark.2.pot b/templates/man2/fanotify_mark.2.pot new file mode 100644 index 00000000..331ddfb0 --- /dev/null +++ b/templates/man2/fanotify_mark.2.pot @@ -0,0 +1,1334 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 16:56+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "fanotify_mark" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"fanotify_mark - add, remove, or modify an fanotify mark on a filesystem " +"object" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<#include E<lt>sys/fanotify.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<int fanotify_mark(int >I<fanotify_fd>B<, unsigned int >I<flags>B<,>\n" +"B< uint64_t >I<mask>B<, int >I<dirfd>B<,>\n" +"B< const char *_Nullable >I<pathname>B<);>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "For an overview of the fanotify API, see B<fanotify>(7)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<fanotify_mark>() adds, removes, or modifies an fanotify mark on a " +"filesystem object. The caller must have read permission on the filesystem " +"object that is to be marked." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<fanotify_fd> argument is a file descriptor returned by " +"B<fanotify_init>(2)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<flags> is a bit mask describing the modification to perform. It must " +"include exactly one of the following values:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_ADD>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The events in I<mask> will be added to the mark mask (or to the ignore " +"mask). I<mask> must be nonempty or the error B<EINVAL> will occur." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_REMOVE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The events in argument I<mask> will be removed from the mark mask (or from " +"the ignore mask). I<mask> must be nonempty or the error B<EINVAL> will " +"occur." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_FLUSH>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Remove either all marks for filesystems, all marks for mounts, or all marks " +"for directories and files from the fanotify group. If I<flags> contains " +"B<FAN_MARK_MOUNT>, all marks for mounts are removed from the group. If " +"I<flags> contains B<FAN_MARK_FILESYSTEM>, all marks for filesystems are " +"removed from the group. Otherwise, all marks for directories and files are " +"removed. No flag other than, and at most one of, the flags " +"B<FAN_MARK_MOUNT> or B<FAN_MARK_FILESYSTEM> can be used in conjunction with " +"B<FAN_MARK_FLUSH>. I<mask> is ignored." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If none of the values above is specified, or more than one is specified, the " +"call fails with the error B<EINVAL>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In addition, zero or more of the following values may be ORed into I<flags>:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_DONT_FOLLOW>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is a symbolic link, mark the link itself, rather than the " +"file to which it refers. (By default, B<fanotify_mark>() dereferences " +"I<pathname> if it is a symbolic link.)" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_ONLYDIR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If the filesystem object to be marked is not a directory, the error " +"B<ENOTDIR> shall be raised." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_MOUNT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Mark the mount specified by I<pathname>. If I<pathname> is not itself a " +"mount point, the mount containing I<pathname> will be marked. All " +"directories, subdirectories, and the contained files of the mount will be " +"monitored. The events which require that filesystem objects are identified " +"by file handles, such as B<FAN_CREATE>, B<FAN_ATTRIB>, B<FAN_MOVE>, and " +"B<FAN_DELETE_SELF>, cannot be provided as a I<mask> when I<flags> contains " +"B<FAN_MARK_MOUNT>. Attempting to do so will result in the error B<EINVAL> " +"being returned. Use of this flag requires the B<CAP_SYS_ADMIN> capability." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_FILESYSTEM> (since Linux 4.20)" +msgstr "" + +#. commit d54f4fba889b205e9cd8239182ca5d27d0ac3bc2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Mark the filesystem specified by I<pathname>. The filesystem containing " +"I<pathname> will be marked. All the contained files and directories of the " +"filesystem from any mount point will be monitored. Use of this flag " +"requires the B<CAP_SYS_ADMIN> capability." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_IGNORED_MASK>" +msgstr "" + +#. commit 497b0c5a7c0688c1b100a9c2e267337f677c198e +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The events in I<mask> shall be added to or removed from the ignore mask. " +"Note that the flags B<FAN_ONDIR>, and B<FAN_EVENT_ON_CHILD> have no effect " +"when provided with this flag. The effect of setting the flags B<FAN_ONDIR>, " +"and B<FAN_EVENT_ON_CHILD> in the mark mask on the events that are set in the " +"ignore mask is undefined and depends on the Linux kernel version. " +"Specifically, prior to Linux 5.9, setting a mark mask on a file and a mark " +"with ignore mask on its parent directory would not result in ignoring events " +"on the file, regardless of the B<FAN_EVENT_ON_CHILD> flag in the parent " +"directory's mark mask. When the ignore mask is updated with the " +"B<FAN_MARK_IGNORED_MASK> flag on a mark that was previously updated with the " +"B<FAN_MARK_IGNORE> flag, the update fails with B<EEXIST> error." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_IGNORE> (since Linux 6.0)" +msgstr "" + +#. commit e252f2ed1c8c6c3884ab5dd34e003ed21f1fe6e0 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This flag has a similar effect as setting the B<FAN_MARK_IGNORED_MASK> " +"flag. The events in I<mask> shall be added to or removed from the ignore " +"mask. Unlike the B<FAN_MARK_IGNORED_MASK> flag, this flag also has the " +"effect that the B<FAN_ONDIR>, and B<FAN_EVENT_ON_CHILD> flags take effect on " +"the ignore mask. Specifically, unless the B<FAN_ONDIR> flag is set with " +"B<FAN_MARK_IGNORE>, events on directories will not be ignored. If the flag " +"B<FAN_EVENT_ON_CHILD> is set with B<FAN_MARK_IGNORE>, events on children " +"will be ignored. For example, a mark on a directory with combination of a " +"mask with B<FAN_CREATE> event and B<FAN_ONDIR> flag and an ignore mask with " +"B<FAN_CREATE> event and without B<FAN_ONDIR> flag, will result in getting " +"only the events for creation of sub-directories. When using the " +"B<FAN_MARK_IGNORE> flag to add to an ignore mask of a mount, filesystem, or " +"directory inode mark, the B<FAN_MARK_IGNORED_SURV_MODIFY> flag must be " +"specified. Failure to do so will results with B<EINVAL> or B<EISDIR> error." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_IGNORED_SURV_MODIFY>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The ignore mask shall survive modify events. If this flag is not set, the " +"ignore mask is cleared when a modify event occurs on the marked object. " +"Omitting this flag is typically used to suppress events (e.g., B<FAN_OPEN>) " +"for a specific file, until that specific file's content has been modified. " +"It is far less useful to suppress events on an entire filesystem, or mount, " +"or on all files inside a directory, until some file's content has been " +"modified. For this reason, the B<FAN_MARK_IGNORE> flag requires the " +"B<FAN_MARK_IGNORED_SURV_MODIFY> flag on a mount, filesystem, or directory " +"inode mark. This flag cannot be removed from a mark once set. When the " +"ignore mask is updated without this flag on a mark that was previously " +"updated with the B<FAN_MARK_IGNORE> and B<FAN_MARK_IGNORED_SURV_MODIFY> " +"flags, the update fails with B<EEXIST> error." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_IGNORE_SURV>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This is a synonym for (B<FAN_MARK_IGNORE>|B<FAN_MARK_IGNORED_SURV_MODIFY>)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MARK_EVICTABLE> (since Linux 5.19)" +msgstr "" + +#. commit 5f9d3bd520261fd7a850818c71809fd580e0f30c +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"When an inode mark is created with this flag, the inode object will not be " +"pinned to the inode cache, therefore, allowing the inode object to be " +"evicted from the inode cache when the memory pressure on the system is " +"high. The eviction of the inode object results in the evictable mark also " +"being lost. When the mask of an evictable inode mark is updated without " +"using the B<FAN_MARK_EVICATBLE> flag, the marked inode is pinned to inode " +"cache and the mark is no longer evictable. When the mask of a non-evictable " +"inode mark is updated with the B<FAN_MARK_EVICTABLE> flag, the inode mark " +"remains non-evictable and the update fails with B<EEXIST> error. Mounts and " +"filesystems are not evictable objects, therefore, an attempt to create a " +"mount mark or a filesystem mark with the B<FAN_MARK_EVICTABLE> flag, will " +"result in the error B<EINVAL>. For example, inode marks can be used in " +"combination with mount marks to reduce the amount of events from " +"noninteresting paths. The event listener reads events, checks if the path " +"reported in the event is of interest, and if it is not, the listener sets a " +"mark with an ignore mask on the directory. Evictable inode marks allow " +"using this method for a large number of directories without the concern of " +"pinning all inodes and exhausting the system's memory." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<mask> defines which events shall be listened for (or which shall be " +"ignored). It is a bit mask composed of the following values:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_ACCESS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a file or directory (but see BUGS) is accessed (read)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MODIFY>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Create an event when a file is modified (write)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_CLOSE_WRITE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Create an event when a writable file is closed." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_CLOSE_NOWRITE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Create an event when a read-only file or directory is closed." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_OPEN>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Create an event when a file or directory is opened." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_OPEN_EXEC> (since Linux 5.0)" +msgstr "" + +#. commit 9b076f1c0f4869b838a1b7aa0edb5664d47ec8aa +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a file is opened with the intent to be executed. See " +"NOTES for additional details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_ATTRIB> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when the metadata for a file or directory has changed. An " +"fanotify group that identifies filesystem objects by file handles is " +"required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_CREATE> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a file or directory has been created in a marked parent " +"directory. An fanotify group that identifies filesystem objects by file " +"handles is required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_DELETE> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a file or directory has been deleted in a marked parent " +"directory. An fanotify group that identifies filesystem objects by file " +"handles is required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_DELETE_SELF> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a marked file or directory itself is deleted. An " +"fanotify group that identifies filesystem objects by file handles is " +"required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_FS_ERROR> (since Linux 5.16)" +msgstr "" + +#. commit 9709bd548f11a092d124698118013f66e1740f9b +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a filesystem error leading to inconsistent filesystem " +"metadata is detected. An additional information record of type " +"B<FAN_EVENT_INFO_TYPE_ERROR> is returned for each event in the read buffer. " +"An fanotify group that identifies filesystem objects by file handles is " +"required." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Events of such type are dependent on support from the underlying " +"filesystem. At the time of writing, only the B<ext4> filesystem reports " +"B<FAN_FS_ERROR> events." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "See B<fanotify>(7) for additional details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MOVED_FROM> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a file or directory has been moved from a marked parent " +"directory. An fanotify group that identifies filesystem objects by file " +"handles is required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MOVED_TO> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a file or directory has been moved to a marked parent " +"directory. An fanotify group that identifies filesystem objects by file " +"handles is required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_RENAME> (since Linux 5.17)" +msgstr "" + +#. commit 8cc3b1ccd930fe6971e1527f0c4f1bdc8cb56026 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This event contains the same information provided by events " +"B<FAN_MOVED_FROM> and B<FAN_MOVED_TO>, however is represented by a single " +"event with up to two information records. An fanotify group that identifies " +"filesystem objects by file handles is required. If the filesystem object to " +"be marked is not a directory, the error B<ENOTDIR> shall be raised." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MOVE_SELF> (since Linux 5.1)" +msgstr "" + +#. commit 235328d1fa4251c6dcb32351219bb553a58838d2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a marked file or directory itself has been moved. An " +"fanotify group that identifies filesystem objects by file handles is " +"required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_OPEN_PERM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a permission to open a file or directory is requested. " +"An fanotify file descriptor created with B<FAN_CLASS_PRE_CONTENT> or " +"B<FAN_CLASS_CONTENT> is required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_OPEN_EXEC_PERM> (since Linux 5.0)" +msgstr "" + +#. commit 66917a3130f218dcef9eeab4fd11a71cd00cd7c9 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a permission to open a file for execution is " +"requested. An fanotify file descriptor created with " +"B<FAN_CLASS_PRE_CONTENT> or B<FAN_CLASS_CONTENT> is required. See NOTES for " +"additional details." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_ACCESS_PERM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create an event when a permission to read a file or directory is requested. " +"An fanotify file descriptor created with B<FAN_CLASS_PRE_CONTENT> or " +"B<FAN_CLASS_CONTENT> is required." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_ONDIR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Create events for directories\\[em]for example, when B<opendir>(3), " +"B<readdir>(3) (but see BUGS), and B<closedir>(3) are called. Without this " +"flag, events are created only for files. In the context of directory entry " +"events, such as B<FAN_CREATE>, B<FAN_DELETE>, B<FAN_MOVED_FROM>, and " +"B<FAN_MOVED_TO>, specifying the flag B<FAN_ONDIR> is required in order to " +"create events when subdirectory entries are modified (i.e., B<mkdir>(2)/ " +"B<rmdir>(2))." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_EVENT_ON_CHILD>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Events for the immediate children of marked directories shall be created. " +"The flag has no effect when marking mounts and filesystems. Note that " +"events are not generated for children of the subdirectories of marked " +"directories. More specifically, the directory entry modification events " +"B<FAN_CREATE>, B<FAN_DELETE>, B<FAN_MOVED_FROM>, and B<FAN_MOVED_TO> are not " +"generated for any entry modifications performed inside subdirectories of " +"marked directories. Note that the events B<FAN_DELETE_SELF> and " +"B<FAN_MOVE_SELF> are not generated for children of marked directories. To " +"monitor complete directory trees it is necessary to mark the relevant mount " +"or filesystem." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The following composed values are defined:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_CLOSE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "A file is closed (B<FAN_CLOSE_WRITE>|B<FAN_CLOSE_NOWRITE>)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<FAN_MOVE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "A file or directory has been moved (B<FAN_MOVED_FROM>|B<FAN_MOVED_TO>)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object to be marked is determined by the file descriptor " +"I<dirfd> and the pathname specified in I<pathname>:" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "\\[bu]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is NULL, I<dirfd> defines the filesystem object to be marked." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is NULL, and I<dirfd> takes the special value B<AT_FDCWD>, " +"the current working directory is to be marked." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is absolute, it defines the filesystem object to be marked, " +"and I<dirfd> is ignored." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is relative, and I<dirfd> does not have the value " +"B<AT_FDCWD>, then the filesystem object to be marked is determined by " +"interpreting I<pathname> relative the directory referred to by I<dirfd>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is relative, and I<dirfd> has the value B<AT_FDCWD>, then the " +"filesystem object to be marked is determined by interpreting I<pathname> " +"relative to the current working directory. (See B<openat>(2) for an " +"explanation of why the I<dirfd> argument is useful.)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RETURN VALUE" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On success, B<fanotify_mark>() returns 0. On error, -1 is returned, and " +"I<errno> is set to indicate the error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EBADF>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "An invalid file descriptor was passed in I<fanotify_fd>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<pathname> is relative but I<dirfd> is neither B<AT_FDCWD> nor a valid file " +"descriptor." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EEXIST>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object indicated by I<dirfd> and I<pathname> has a mark that " +"was updated without the B<FAN_MARK_EVICTABLE> flag, and the user attempted " +"to update the mark with B<FAN_MARK_EVICTABLE> flag." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object indicated by I<dirfd> and I<pathname> has a mark that " +"was updated with the B<FAN_MARK_IGNORE> flag, and the user attempted to " +"update the mark with B<FAN_MARK_IGNORED_MASK> flag." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object indicated by I<dirfd> and I<pathname> has a mark that " +"was updated with the B<FAN_MARK_IGNORE> and B<FAN_MARK_IGNORED_SURV_MODIFY> " +"flags, and the user attempted to update the mark only with " +"B<FAN_MARK_IGNORE> flag." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"An invalid value was passed in I<flags> or I<mask>, or I<fanotify_fd> was " +"not an fanotify file descriptor." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The fanotify file descriptor was opened with B<FAN_CLASS_NOTIF> or the " +"fanotify group identifies filesystem objects by file handles and mask " +"contains a flag for permission events (B<FAN_OPEN_PERM> or " +"B<FAN_ACCESS_PERM>)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The group was initialized without B<FAN_REPORT_FID> but one or more event " +"types specified in the I<mask> require it." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<flags> contains B<FAN_MARK_IGNORE>, and either B<FAN_MARK_MOUNT> or " +"B<FAN_MARK_FILESYSTEM>, but does not contain B<FAN_MARK_IGNORED_SURV_MODIFY>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EISDIR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<flags> contains B<FAN_MARK_IGNORE>, but does not contain " +"B<FAN_MARK_IGNORED_SURV_MODIFY>, and I<dirfd> and I<pathname> specify a " +"directory." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENODEV>" +msgstr "" + +#. commit 59cda49ecf6c9a32fae4942420701b6e087204f6 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object indicated by I<dirfd> and I<pathname> is not " +"associated with a filesystem that supports I<fsid> (e.g., B<fuse>(4)). " +"B<tmpfs>(5) did not support I<fsid> prior to Linux 5.13. This error can be " +"returned only with an fanotify group that identifies filesystem objects by " +"file handles." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOENT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object indicated by I<dirfd> and I<pathname> does not exist. " +"This error also occurs when trying to remove a mark from an object which is " +"not marked." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOMEM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The necessary memory could not be allocated." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOSPC>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The number of marks for this user exceeds the limit and the " +"B<FAN_UNLIMITED_MARKS> flag was not specified when the fanotify file " +"descriptor was created with B<fanotify_init>(2). See B<fanotify>(7) for " +"details about this limit." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOSYS>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This kernel does not implement B<fanotify_mark>(). The fanotify API is " +"available only if the kernel was configured with B<CONFIG_FANOTIFY>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOTDIR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<flags> contains B<FAN_MARK_ONLYDIR>, and I<dirfd> and I<pathname> do not " +"specify a directory." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<mask> contains B<FAN_RENAME>, and I<dirfd> and I<pathname> do not specify " +"a directory." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<flags> contains B<FAN_MARK_IGNORE>, or the fanotify group was initialized " +"with flag B<FAN_REPORT_TARGET_FID>, and I<mask> contains directory entry " +"modification events (e.g., B<FAN_CREATE>, B<FAN_DELETE>), or directory event " +"flags (e.g., B<FAN_ONDIR>, B<FAN_EVENT_ON_CHILD>), and I<dirfd> and " +"I<pathname> do not specify a directory." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EOPNOTSUPP>" +msgstr "" + +#. commit 96b2b072ee62be8ae68c8ecf14854c4d0505a8f8 +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +msgid "" +"The object indicated by I<pathname> is associated with a filesystem that " +"does not support the encoding of file handles. This error can be returned " +"only with an fanotify group that identifies filesystem objects by file " +"handles. Calling B<name_to_handle_at>(2) with the flag B<AT_HANDLE_FID> " +"(since Linux 6.5) can be used as a test to check if a filesystem supports " +"reporting events with file handles." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EPERM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The operation is not permitted because the caller lacks a required " +"capability." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EXDEV>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The filesystem object indicated by I<pathname> resides within a filesystem " +"subvolume (e.g., B<btrfs>(5)) which uses a different I<fsid> than its root " +"superblock. This error can be returned only with an fanotify group that " +"identifies filesystem objects by file handles." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "STANDARDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "Linux." +msgstr "" + +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "HISTORY" +msgstr "" + +#. was introduced in Linux 2.6.36 and enabled in Linux 2.6.37. +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "Linux 2.6.37." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "FAN_OPEN_EXEC and FAN_OPEN_EXEC_PERM" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"When using either B<FAN_OPEN_EXEC> or B<FAN_OPEN_EXEC_PERM> within the " +"I<mask>, events of these types will be returned only when the direct " +"execution of a program occurs. More specifically, this means that events of " +"these types will be generated for files that are opened using B<execve>(2), " +"B<execveat>(2), or B<uselib>(2). Events of these types will not be raised " +"in the situation where an interpreter is passed (or reads) a file for " +"interpretation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Additionally, if a mark has also been placed on the Linux dynamic linker, a " +"user should also expect to receive an event for it when an ELF object has " +"been successfully opened using B<execve>(2) or B<execveat>(2)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"For example, if the following ELF binary were to be invoked and a " +"B<FAN_OPEN_EXEC> mark has been placed on /:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "$ /bin/echo foo\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The listening application in this case would receive B<FAN_OPEN_EXEC> events " +"for both the ELF binary and interpreter, respectively:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"/bin/echo\n" +"/lib64/ld-linux-x86-64.so.2\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BUGS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The following bugs were present in before Linux 3.16:" +msgstr "" + +#. Fixed by commit 0a8dd2db579f7a0ac7033d6b857c3d5dbaa77563 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<flags> contains B<FAN_MARK_FLUSH>, I<dirfd>, and I<pathname> must " +"specify a valid filesystem object, even though this object is not used." +msgstr "" + +#. Fixed by commit d4c7cf6cffb1bc711a833b5e304ba5bcfe76398b +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<readdir>(2) does not generate a B<FAN_ACCESS> event." +msgstr "" + +#. Fixed by commit cc299a98eb13a9853675a9cbb90b30b4011e1406 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If B<fanotify_mark>() is called with B<FAN_MARK_FLUSH>, I<flags> is not " +"checked for invalid values." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<fanotify_init>(2), B<fanotify>(7)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2023-02-05" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The object indicated by I<pathname> is associated with a filesystem that " +"does not support the encoding of file handles. This error can be returned " +"only with an fanotify group that identifies filesystem objects by file " +"handles." +msgstr "" + +#. type: SH +#: debian-bookworm +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"B<fanotify_mark>() was introduced in Linux 2.6.36 and enabled in Linux " +"2.6.37." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "This system call is Linux-specific." +msgstr "" + +#. type: TH +#: debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |