#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:53+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man2/fanotify_init.2:24 #, no-wrap msgid "FANOTIFY_INIT" msgstr "" #. type: TH #: man-pages/man2/fanotify_init.2:24 #, no-wrap msgid "2014-05-18" msgstr "" #. type: TH #: man-pages/man2/fanotify_init.2:24 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man2/fanotify_init.2:24 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:25 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:27 msgid "fanotify_init - create and initialize fanotify group" msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:27 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:29 msgid "B<#include Efcntl.hE>" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:31 msgid "B<#include Esys/fanotify.hE>" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:33 msgid "" "BIB<, unsigned int " ">IB<);>" msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:33 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:36 msgid "For an overview of the fanotify API, see B(7)." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:40 msgid "" "B() initializes a new fanotify group and returns a file " "descriptor for the event queue associated with the group." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:51 msgid "" "The file descriptor is used in calls to B(2) to specify the " "files, directories, and mounts for which fanotify events shall be created. " "These events are received by reading from the file descriptor. Some events " "are only informative, indicating that a file has been accessed. Other " "events can be used to determine whether another application is permitted to " "access a file or directory. Permission to access filesystem objects is " "granted by writing to the file descriptor." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:54 msgid "" "Multiple programs may be using the fanotify interface at the same time to " "monitor the same files." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:58 msgid "" "In the current implementation, the number of fanotify groups per user is " "limited to 128. This limit cannot be overridden." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:67 msgid "" "Calling B() requires the B capability. This " "constraint might be relaxed in future versions of the API. Therefore, " "certain additional capability checks have been implemented as indicated " "below." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:73 msgid "" "The I argument contains a multi-bit field defining the notification " "class of the listening application and further single bit fields specifying " "the behavior of the file descriptor." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:77 msgid "" "If multiple listeners for permission events exist, the notification class is " "used to establish the sequence in which the listeners receive the events." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:80 msgid "" "Only one of the following notification classes may be specified in I:" msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:80 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:88 msgid "" "This value allows the receipt of events notifying that a file has been " "accessed and events for permission decisions if a file may be accessed. It " "is intended for event listeners that need to access files before they " "contain their final data. This notification class might be used by " "hierarchical storage managers, for example." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:88 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:96 msgid "" "This value allows the receipt of events notifying that a file has been " "accessed and events for permission decisions if a file may be accessed. It " "is intended for event listeners that need to access files when they already " "contain their final content. This notification class might be used by " "malware detection programs, for example." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:96 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:103 msgid "" "This is the default value. It does not need to be specified. This value " "only allows the receipt of events notifying that a file has been accessed. " "Permission decisions before the file is accessed are not possible." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:111 msgid "" "Listeners with different notification classes will receive events in the " "order B, B, B. " "The order of notification for listeners in the same notification class is " "undefined." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:114 msgid "The following bits can additionally be set in I:" msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:114 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:123 msgid "" "Set the close-on-exec flag (B) on the new file descriptor. See " "the description of the B flag in B(2)." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:123 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:133 msgid "" "Enable the nonblocking flag (B) for the file descriptor. " "Reading from the file descriptor will not block. Instead, if no data is " "available, B(2) will fail with the error B." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:133 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:139 msgid "" "Remove the limit of 16384 events for the event queue. Use of this flag " "requires the B capability." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:139 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:145 msgid "" "Remove the limit of 8192 marks. Use of this flag requires the " "B capability." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:158 msgid "" "The I argument defines the file status flags that will be set " "on the open file descriptions that are created for fanotify events. For " "details of these flags, see the description of the I values in " "B(2). I includes a multi-bit field for the access mode." " This field can take the following values:" msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:158 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:161 msgid "This value allows only read access." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:161 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:164 msgid "This value allows only write access." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:164 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:167 msgid "This value allows read and write access." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:171 msgid "" "Additional bits can be set in I. The most useful values are:" msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:171 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:178 msgid "" "Enable support for files exceeding 2 GB. Failing to set this flag will " "result in an B error when trying to open a large file which is " "monitored by an fanotify group on a 32-bit system." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:178 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:186 msgid "" "Enable the close-on-exec flag for the file descriptor. See the description " "of the B flag in B(2) for reasons why this may be useful." msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:199 msgid "" "The following are also allowable: B, B, B, " "B, and B. Specifying any other flag in I " "yields the error B (but see BUGS)." msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:199 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:206 msgid "" "On success, B() returns a new file descriptor. On error, -1 " "is returned, and I is set to indicate the error." msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:206 #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:207 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:216 msgid "" "An invalid value was passed in I or I. " "B defines all allowable bits for I." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:216 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:219 msgid "The number of fanotify groups for this user exceeds 128." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:219 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:222 msgid "The allocation of memory for the notification group failed." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:222 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:228 msgid "" "This kernel does not implement B(). The fanotify API is " "available only if the kernel was configured with B." msgstr "" #. type: TP #: man-pages/man2/fanotify_init.2:228 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:233 msgid "" "The operation is not permitted because the caller lacks the B " "capability." msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:233 #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:237 msgid "" "B() was introduced in version 2.6.36 of the Linux kernel and " "enabled in version 2.6.37." msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:237 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:239 msgid "This system call is Linux-specific." msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:239 #, no-wrap msgid "BUGS" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:242 msgid "As of Linux 3.15, the following bug exists:" msgstr "" #. type: IP #: man-pages/man2/fanotify_init.2:242 #, no-wrap msgid "*" msgstr "" #. FIXME: Patch accepted to mm tree. #. type: Plain text #: man-pages/man2/fanotify_init.2:252 msgid "" "The I argument is not checked for invalid flags. Flags that " "are intended only for internal use, such as B, can be set, and " "will consequently be set for the file descriptors returned when reading from " "the fanotify file descriptor." msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:252 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:255 msgid "B(2), B(7)" msgstr "" #. type: SH #: man-pages/man2/fanotify_init.2:255 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man2/fanotify_init.2:263 msgid "" "This page is part of release 3.70 of the Linux I 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 ""