.\" all rights reserved.
.\" Translated 2006-08-15, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.39
.\"
-.TH INOTIFY_ADD_WATCH 2 2014\-03\-28 Linux "Linux Programmer's Manual"
+.TH INOTIFY_ADD_WATCH 2 2014\-07\-08 Linux "Linux Programmer's Manual"
.SH 名前
inotify_add_watch \- 初期化済み inotify インスタンスに監視対象を追加する
.SH 書式
.SH 説明
\fBinotify_add_watch\fP() は、 \fIpathname\fP で指定された位置にあるファイルを監視する監視アイテム (watch)
の新規追加、 または既存の監視アイテムの変更を行う。 呼び出し元は、監視対象のファイルに対する読み出し許可を 持っていなければならない。 \fIfd\fP
-引き数は、変更を行う監視対象リスト (watch list) を持つ inotify インスタンスを参照するファイルディスクリプタである。
+å¼\95ã\81\8dæ\95°ã\81¯ã\80\81å¤\89æ\9b´ã\82\92è¡\8cã\81\86ç\9b£è¦\96対象ã\83ªã\82¹ã\83\88 (watch list) ã\82\92æ\8c\81ã\81¤ inotify ã\82¤ã\83³ã\82¹ã\82¿ã\83³ã\82¹ã\82\92å\8f\82ç\85§ã\81\99ã\82\8bã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81§ã\81\82ã\82\8bã\80\82
\fIpathname\fP のどのイベントを監視するかは、引き数のビットマスク \fImask\fP で指定する。 \fImask\fP
に設定できるビットの説明については \fBinotify\fP(7) を参照のこと。
-\fBinotify_add_watch\fP() の呼び出しが成功すると、変更対象の inotify インスタンスで \fIpathname\fP
-に対応付けられる一意な監視対象ディスクリプタ (watch descriptor) を返す。 \fIpathname\fP がその inotify
-インスタンスに追加されていなければ、 監視対象ディスクリプタが新規に割り当てられる。 \fIpathname\fP
-がすでに監視対象になっていれば、既存の監視アイテムに対する ディスクリプタが返される。
+\fBinotify_add_watch\fP() の呼び出しが成功すると、 \fIpathname\fP に対応するファイルシステムオブジェクトに対する、
+一意な監視対象ディスクリプター (watch descriptor) を、 対象の inotify インスタンスに対して返す。
+そのファイルシステムオブジェクトが対象の inotify インスタンスによって以前に監視されていない場合には、
+監視対象ディスクリプターは新規に割り当てられる。 ファイルシステムオブジェクトが (おそらく同じオブジェクトに対する異なるリンク経由で)
+すでに監視されている場合には、 既存の監視に対するディスクリプターが返される。
-ã\81\93ã\82\8c以é\99\8dã\81« inotify ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\81\8bã\82\89 \fBread\fP(2) ã\82\92è¡\8cã\81\86ã\81¨ã\80\81ç\9b£è¦\96対象ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿が返される。 これらの
+ã\81\93ã\82\8c以é\99\8dã\81« inotify ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81\8bã\82\89 \fBread\fP(2) ã\82\92è¡\8cã\81\86ã\81¨ã\80\81ç\9b£è¦\96対象ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼が返される。 これらの
\fBread\fP() を行うと、ファイルシステムイベントを示す \fIinotify_event\fP 構造体が読み出される (\fBinotify\fP(7)
-参照)。この構造体内の監視対象ディスクリプタにより、 どのオブジェクトでそのイベントが発生したかを特定できる。
+å\8f\82ç\85§)ã\80\82ã\81\93ã\81®æ§\8bé\80 ä½\93å\86\85ã\81®ç\9b£è¦\96対象ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81«ã\82\88ã\82\8aã\80\81 ã\81©ã\81®ã\82ªã\83\96ã\82¸ã\82§ã\82¯ã\83\88ã\81§ã\81\9dã\81®ã\82¤ã\83\99ã\83³ã\83\88ã\81\8cç\99ºç\94\9fã\81\97ã\81\9fã\81\8bã\82\92ç\89¹å®\9aã\81§ã\81\8dã\82\8bã\80\82
.SH 返り値
-成功すると、 \fBinotify_add_watch\fP() は非負の監視対象ディスクリプタを返す。 エラーの場合、\-1 を返し、 \fIerrno\fP
+æ\88\90å\8a\9fã\81\99ã\82\8bã\81¨ã\80\81 \fBinotify_add_watch\fP() ã\81¯é\9d\9eè² ã\81®ç\9b£è¦\96対象ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\82\92è¿\94ã\81\99ã\80\82 ã\82¨ã\83©ã\83¼ã\81®å ´å\90\88ã\80\81\-1 ã\82\92è¿\94ã\81\97ã\80\81 \fIerrno\fP
を適切に設定する。
.SH エラー
.TP
指定されたファイルに対する読み出しアクセスが許可されていない。
.TP
\fBEBADF\fP
-指定されたファイルディスクリプタが有効ではない。
+æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81\8cæ\9c\89å\8a¹ã\81§ã\81¯ã\81ªã\81\84ã\80\82
.TP
\fBEFAULT\fP
\fIpathname\fP が指すアドレスがプロセスがアクセスできるアドレス空間外である。
.TP
\fBEINVAL\fP
-指定されたイベントマスクに有効なイベントが含まれていない。 もしくは \fIfd\fP が inotify ファイルディスクリプタではない。
+æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\82¤ã\83\99ã\83³ã\83\88ã\83\9eã\82¹ã\82¯ã\81«æ\9c\89å\8a¹ã\81ªã\82¤ã\83\99ã\83³ã\83\88ã\81\8cå\90«ã\81¾ã\82\8cã\81¦ã\81\84ã\81ªã\81\84ã\80\82 ã\82\82ã\81\97ã\81\8fã\81¯ \fIfd\fP ã\81\8c inotify ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81§ã\81¯ã\81ªã\81\84ã\80\82
.TP
\fBENAMETOOLONG\fP
\fIpathname\fP が長過ぎる。
リンク切れのシンボリックリンクである。
.TP
\fBENOMEM\fP
-カーネルメモリが十分になかった。
+ã\82«ã\83¼ã\83\8dã\83«ã\83¡ã\83¢ã\83ªã\83¼ã\81\8cå\8d\81å\88\86ã\81«ã\81ªã\81\8bã\81£ã\81\9fã\80\82
.TP
\fBENOSPC\fP
-inotify 監視対象の総数がユーザが追加できる上限に達していた。 もしくは、必要な資源の割り当てにカーネルが失敗した。
+inotify ç\9b£è¦\96対象ã\81®ç·\8fæ\95°ã\81\8cã\83¦ã\83¼ã\82¶ã\83¼ã\81\8c追å\8a ã\81§ã\81\8dã\82\8bä¸\8aé\99\90ã\81«é\81\94ã\81\97ã\81¦ã\81\84ã\81\9fã\80\82 ã\82\82ã\81\97ã\81\8fã\81¯ã\80\81å¿\85è¦\81ã\81ªè³\87æº\90ã\81®å\89²ã\82\8aå½\93ã\81¦ã\81«ã\82«ã\83¼ã\83\8dã\83«ã\81\8c失æ\95\97ã\81\97ã\81\9fã\80\82
.SH バージョン
inotify は Linux カーネル 2.6.13 に組み込まれた。
.SH 準拠
.SH 関連項目
\fBinotify_init\fP(2), \fBinotify_rm_watch\fP(2), \fBinotify\fP(7)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
