inotify_add_watch() - Unix，Linux 系統呼叫

名稱

inotify_add_watch - 向已初始化的 inotify 例項新增監視

語法

#include <sys/inotify.h>

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

描述

inotify_add_watch() 新增一個新的監視，或修改一個現有的監視，用於在pathname中指定位置的檔案；呼叫者必須對此檔案具有讀取許可權。fd引數是引用要修改其監視列表的 inotify 例項的檔案描述符。要監視pathname的事件在mask位掩碼引數中指定。有關可以在mask中設定的位的描述，請參閱inotify(7)。

成功呼叫inotify_add_watch() 會返回與此 inotify 例項的pathname關聯的唯一監視描述符。如果此 inotify 例項之前未監視pathname，則會新分配監視描述符。如果之前已監視pathname，則會返回現有監視的描述符。

監視描述符由 inotify 檔案描述符的後續read(2)返回。這些讀取獲取指示檔案系統事件的inotify_event結構；返回的監視描述符標識發生事件的物件。

返回值

成功時，inotify_add_watch() 返回一個非負的監視描述符。錯誤時，返回-1，並相應地設定errno。

錯誤

標籤	描述
EACCESS
	不允許讀取給定檔案。
EBADF	給定的檔案描述符無效。
EFAULT	pathname指向程序可訪問地址空間之外。
EINVAL	給定的事件掩碼不包含任何合法事件；或者fd不是 inotify 檔案描述符。
ENOMEM	核心記憶體不足。
ENOSPC	達到 inotify 監視總數的使用者限制，或者核心無法分配所需的資源。

歷史

Inotify 已合併到 2.6.13 Linux 核心中。

符合標準

此係統呼叫是 Linux 特定的。

參見

列印頁面