# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2012-04-23 07:52+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: build/C/man7/inotify.7:26 #, no-wrap msgid "INOTIFY" msgstr "" #. type: TH #: build/C/man7/inotify.7:26 #, no-wrap msgid "2011-12-07" msgstr "" #. type: TH #: build/C/man7/inotify.7:26 build/C/man2/inotify_add_watch.2:29 build/C/man2/inotify_init.2:29 build/C/man2/inotify_rm_watch.2:28 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: build/C/man7/inotify.7:26 build/C/man2/inotify_add_watch.2:29 build/C/man2/inotify_init.2:29 build/C/man2/inotify_rm_watch.2:28 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: build/C/man7/inotify.7:27 build/C/man2/inotify_add_watch.2:30 build/C/man2/inotify_init.2:30 build/C/man2/inotify_rm_watch.2:29 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:29 msgid "inotify - monitoring file system events" msgstr "" #. type: SH #: build/C/man7/inotify.7:29 build/C/man2/inotify_add_watch.2:36 build/C/man2/inotify_init.2:39 build/C/man2/inotify_rm_watch.2:37 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:37 msgid "" "The I API provides a mechanism for monitoring file system events. " "Inotify can be used to monitor individual files, or to monitor directories. " "When a directory is monitored, inotify will return events for the directory " "itself, and for files inside the directory." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:47 msgid "" "The following system calls are used with this API: B(2) (or " "B(2)), B(2), B(2), " "B(2), and B(2)." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:56 msgid "" "B(2) creates an inotify instance and returns a file " "descriptor referring to the inotify instance. The more recent " "B(2) is like B(2), but provides some extra " "functionality." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:69 msgid "" "B(2) manipulates the \"watch list\" associated with an " "inotify instance. Each item (\"watch\") in the watch list specifies the " "pathname of a file or directory, along with some set of events that the " "kernel should monitor for the file referred to by that pathname. " "B(2) either creates a new watch item, or modifies an " "existing watch. Each watch has a unique \"watch descriptor\", an integer " "returned by B(2) when the watch is created." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:72 msgid "B(2) removes an item from an inotify watch list." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:78 msgid "" "When all file descriptors referring to an inotify instance have been closed, " "the underlying object and its resources are freed for reuse by the kernel; " "all associated watches are automatically freed." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:91 msgid "" "To determine what events have occurred, an application B(2)s from the " "inotify file descriptor. If no events have so far occurred, then, assuming " "a blocking file descriptor, B(2) will block until at least one event " "occurs (unless interrupted by a signal, in which case the call fails with " "the error B; see B(7))." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:95 msgid "" "Each successful B(2) returns a buffer containing one or more of the " "following structures:" msgstr "" #. FIXME . The type of the 'wd' field should probably be "int32_t". #. I submitted a patch to fix this. See the LKML thread #. "[patch] Fix type errors in inotify interfaces", 18 Nov 2008 #. Glibc bug filed: http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040 #. type: Plain text #: build/C/man7/inotify.7:110 #, no-wrap msgid "" "struct inotify_event {\n" " int wd; /* Watch descriptor */\n" " uint32_t mask; /* Mask of events */\n" " uint32_t cookie; /* Unique cookie associating related\n" " events (for rename(2)) */\n" " uint32_t len; /* Size of I field */\n" " char name[]; /* Optional null-terminated name */\n" "};\n" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:117 msgid "" "I identifies the watch for which this event occurs. It is one of the " "watch descriptors returned by a previous call to B(2)." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:120 msgid "I contains bits that describe the event that occurred (see below)." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:132 msgid "" "I is a unique integer that connects related events. Currently this " "is only used for rename events, and allows the resulting pair of " "B and B events to be connected by the " "application. For all other event types, I is set to 0." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:141 msgid "" "The I field is only present when an event is returned for a file " "inside a watched directory; it identifies the file pathname relative to the " "watched directory. This pathname is null-terminated, and may include " "further null bytes to align subsequent reads to a suitable address boundary." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:151 msgid "" "The I field counts all of the bytes in I, including the null " "bytes; the length of each I structure is thus " "I." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:161 msgid "" "The behavior when the buffer given to B(2) is too small to return " "information about the next event depends on the kernel version: in kernels " "before 2.6.21, B(2) returns 0; since kernel 2.6.21, B(2) fails " "with the error B." msgstr "" #. type: SS #: build/C/man7/inotify.7:161 #, no-wrap msgid "inotify events" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:181 msgid "" "The B(2) I argument and the I field of the " "I structure returned when B(2)ing an inotify file " "descriptor are both bit masks identifying inotify events. The following " "bits can be specified in I when calling B(2) and " "may be returned in the I field returned by B(2):" msgstr "" #. type: TP #: build/C/man7/inotify.7:184 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:187 msgid "File was accessed (read) (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:187 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:191 msgid "" "Metadata changed, e.g., permissions, timestamps, extended attributes, link " "count (since Linux 2.6.25), UID, GID, etc. (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:191 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:194 msgid "File opened for writing was closed (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:194 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:197 msgid "File not opened for writing was closed (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:197 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:200 msgid "File/directory created in watched directory (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:200 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:203 msgid "File/directory deleted from watched directory (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:203 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:206 msgid "Watched file/directory was itself deleted." msgstr "" #. type: TP #: build/C/man7/inotify.7:206 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:209 msgid "File was modified (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:209 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:212 msgid "Watched file/directory was itself moved." msgstr "" #. type: TP #: build/C/man7/inotify.7:212 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:215 msgid "File moved out of watched directory (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:215 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:218 msgid "File moved into watched directory (*)." msgstr "" #. type: TP #: build/C/man7/inotify.7:218 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:221 msgid "File was opened (*)." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:231 msgid "" "When monitoring a directory, the events marked with an asterisk (*) above " "can occur for files in the directory, in which case the I field in the " "returned I structure identifies the name of the file within " "the directory." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:239 msgid "" "The B macro is defined as a bit mask of all of the above " "events. This macro can be used as the I argument when calling " "B(2)." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:248 msgid "" "Two additional convenience macros are B, which equates to " "IN_MOVED_FROM|IN_MOVED_TO, and B, which equates to " "IN_CLOSE_WRITE|IN_CLOSE_NOWRITE." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:253 msgid "" "The following further bits can be specified in I when calling " "B(2):" msgstr "" #. type: TP #: build/C/man7/inotify.7:256 #, no-wrap msgid "B (since Linux 2.6.15)" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:259 msgid "Don't dereference I if it is a symbolic link." msgstr "" #. type: TP #: build/C/man7/inotify.7:259 #, no-wrap msgid "B (since Linux 2.6.36)" msgstr "" #. commit 8c1934c8d70b22ca8333b216aec6c7d09fdbd6a6 #. type: Plain text #: build/C/man7/inotify.7:275 msgid "" "By default, when watching events on the children of a directory, events are " "generated for children even after they have been unlinked from the " "directory. This can result in large numbers of uninteresting events for " "some applications (e.g., if watching I, in which many applications " "create temporary files whose names are immediately unlinked). Specifying " "B changes the default behavior, so that events are not " "generated for children after they have been unlinked from the watched " "directory." msgstr "" #. type: TP #: build/C/man7/inotify.7:275 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:279 msgid "" "Add (OR) events to watch mask for this pathname if it already exists " "(instead of replacing mask)." msgstr "" #. type: TP #: build/C/man7/inotify.7:279 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:283 msgid "Monitor I for one event, then remove from watch list." msgstr "" #. type: TP #: build/C/man7/inotify.7:283 #, no-wrap msgid "B (since Linux 2.6.15)" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:286 msgid "Only watch I if it is a directory." msgstr "" #. type: Plain text #: build/C/man7/inotify.7:293 msgid "The following bits may be set in the I field returned by B(2):" msgstr "" #. type: TP #: build/C/man7/inotify.7:296 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:300 msgid "" "Watch was removed explicitly (B(2)) or automatically " "(file was deleted, or file system was unmounted)." msgstr "" #. type: TP #: build/C/man7/inotify.7:300 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:303 msgid "Subject of this event is a directory." msgstr "" #. type: TP #: build/C/man7/inotify.7:303 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:306 msgid "Event queue overflowed (I is -1 for this event)." msgstr "" #. type: TP #: build/C/man7/inotify.7:306 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:309 msgid "File system containing watched object was unmounted." msgstr "" #. type: SS #: build/C/man7/inotify.7:311 #, no-wrap msgid "/proc interfaces" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:314 msgid "" "The following interfaces can be used to limit the amount of kernel memory " "consumed by inotify:" msgstr "" #. type: TP #: build/C/man7/inotify.7:314 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:323 msgid "" "The value in this file is used when an application calls B(2) " "to set an upper limit on the number of events that can be queued to the " "corresponding inotify instance. Events in excess of this limit are dropped, " "but an B event is always generated." msgstr "" #. type: TP #: build/C/man7/inotify.7:323 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:327 msgid "" "This specifies an upper limit on the number of inotify instances that can be " "created per real user ID." msgstr "" #. type: TP #: build/C/man7/inotify.7:327 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:331 msgid "" "This specifies an upper limit on the number of watches that can be created " "per real user ID." msgstr "" #. type: SH #: build/C/man7/inotify.7:331 build/C/man2/inotify_add_watch.2:115 build/C/man2/inotify_init.2:91 build/C/man2/inotify_rm_watch.2:67 #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:339 msgid "" "Inotify was merged into the 2.6.13 Linux kernel. The required library " "interfaces were added to glibc in version 2.4. (B, " "B, and B were only added in version 2.5.)" msgstr "" #. type: SH #: build/C/man7/inotify.7:339 build/C/man2/inotify_add_watch.2:117 build/C/man2/inotify_init.2:96 build/C/man2/inotify_rm_watch.2:69 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:341 msgid "The inotify API is Linux-specific." msgstr "" #. type: SH #: build/C/man7/inotify.7:341 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: build/C/man7/inotify.7:348 msgid "" "Inotify file descriptors can be monitored using B