OSDN Git Service

(split) DP: release pages (catch up to 3.50).
[linuxjm/LDP_man-pages.git] / release / man7 / inotify.7
index 16a9280..8027791 100644 (file)
@@ -1,8 +1,7 @@
 .\" t
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\"*******************************************************************
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH INOTIFY 7 2012\-04\-26 Linux "Linux Programmer's Manual"
+.TH INOTIFY 7 2013\-02\-25 Linux "Linux Programmer's Manual"
 .SH 名前
 inotify \- ファイルシステムイベントを監視する
 .SH 説明
@@ -82,11 +82,10 @@ struct inotify_event {
 
 \fImask\fP には発生したイベント (下記参照) を記述するためのビットが含まれる。
 
-\fIcookie\fP は関連するイベントを関連づけるための一意な整数である。
-現在のところ、この値は rename イベントに対してのみ使われており、
-結果のペアである \fBIN_MOVE_FROM\fP と \fBIN_MOVE_TO\fP イベントを
-アプリケーションで関連づけることができる。
-他のイベント種別の場合には、 \fIcookie\fP は 0 に設定する。
+\fIcookie\fP is a unique integer that connects related events.  Currently this
+is only used for rename events, and allows the resulting pair of
+\fBIN_MOVED_FROM\fP and \fBIN_MOVED_TO\fP events to be connected by the
+application.  For all other event types, \fIcookie\fP is set to 0.
 
 \fIname\fP フィールドは監視しているディレクトリ内のファイルに対して イベントが返される場合のためにだけ存在する。
 監視するディレクトリからのファイルの相対パス名を表す。 このパス名は NULL で終端され、 その後の読み込みで適切なアドレス境界に調整するために、
@@ -105,7 +104,6 @@ struct inotify_event {
     sizeof(struct inotify_event) + NAME_MAX + 1
 
 を指定すれば、少なくとも 1 イベントで読み出しを行うには十分である。
-
 .SS "inotify イベント"
 \fBinotify_add_watch\fP(2)  の \fImask\fP 引き数と、inotify ファイル構造体を \fBread\fP(2)
 したときに返される \fIinotify_event\fP 構造体の \fImask\fP フィールドは、ともに inotify イベントを識別するための
@@ -256,8 +254,10 @@ inotify によるディレクトリの監視は再帰的に行われない: あ
 サブディレクトリを監視する場合、 監視対象を追加で作成しなければならない。
 大きなディレクトリツリーの場合には、この作業にかなり時間がかかることがある。
 
-inotify API では inotify イベントのきっかけとなったユーザやプロセスに関する
-情報が提供されない。
+The inotify API provides no information about the user or process that
+triggered the inotify event.  In particular, there is no easy way for a
+process that is monitoring events via inotify to distinguish events that it
+triggers itself from those that are triggered by other processes.
 
 イベントキューは溢れる場合があることに注意すること。この場合にはイベントは
 失われてしまう。堅牢性が必要なアプリケーションでは、イベントが失われる可能性
@@ -280,9 +280,10 @@ inotify API では影響が受けるファイルをファイル名で特定す
 をチェックするようになっていた。
 .SH 関連項目
 \fBinotify_add_watch\fP(2), \fBinotify_init\fP(2), \fBinotify_init1\fP(2),
-\fBinotify_rm_watch\fP(2), \fBread\fP(2), \fBstat\fP(2),
-\fIDocumentation/filesystems/inotify.txt\fP.
+\fBinotify_rm_watch\fP(2), \fBread\fP(2), \fBstat\fP(2)
+
+\fIDocumentation/filesystems/inotify.txt\fP in the Linux kernel source tree
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。