INOTIFY_ADD_WATCH

名前

書式

int inotify_add_watch(int fd, const char *pathname, uint32_t mask);  

説明

inotify_add_watch() の呼び出しが成功すると、 pathname に対応するファイルシステムオブジェクト (inode) に対する、 一意な監視対象ディスクリプター (watch descriptor) を、 対象の inotify インスタンスに対して返す。 そのファイルシステムオブジェクトが対象の inotify インスタンスによって以前に監視されていない場合には、 監視対象ディスクリプターは新規に割り当てられる。 ファイルシステムオブジェクトが (おそらく同じオブジェクトに対する異なるリンク経由で) すでに監視されている場合には、 既存の監視に対するディスクリプターが返される。

これ以降に inotify ファイルディスクリプターから read(2) を行うと、監視対象ディスクリプターが返される。 これらの read() を行うと、ファイルシステムイベントを示す inotify_event 構造体が読み出される (inotify(7) 参照)。この構造体内の監視対象ディスクリプターにより、 どのオブジェクトでそのイベントが発生したかを特定できる。  

返り値

エラー

EACCES

指定されたファイルに対する読み出しアクセスが許可されていない。

EBADF

指定されたファイルディスクリプターが有効ではない。

EEXIST

mask contains IN_MASK_CREATE and pathname refers to a file already being watched by the same fd.

EFAULT

pathname が指すアドレスがプロセスがアクセスできるアドレス空間外である。

EINVAL

The given event mask contains no valid events; or mask contains both IN_MASK_ADD and IN_MASK_CREATE; or fd is not an inotify file descriptor.

ENAMETOOLONG

pathname が長過ぎる。

ENOENT

pathname のディレクトリ部分の構成要素が、存在しないか、 リンク切れのシンボリックリンクである。

ENOMEM

カーネルメモリーが十分になかった。

ENOSPC

inotify 監視対象の総数がユーザーが追加できる上限に達していた。 もしくは、必要な資源の割り当てにカーネルが失敗した。

ENOTDIR

mask contains IN_ONLYDIR and pathname is not a directory.

バージョン

準拠

例

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

関連するコマンド・関数

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

例

関連項目

この文書について