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 特定的。

参见

打印页面