inotify的API接口有哪几种

inotify 是 Linux 内核提供的一种文件系统事件监控机制，它允许应用程序实时监控文件系统对象（如文件、目录）的变化，包括创建、删除、修改等操作。inotify 提供了几个主要的 API 接口，以下是一些常用的：

1. inotify_init()

• 功能：初始化一个 inotify 实例。
• 参数：无。
• 返回值：返回一个文件描述符，用于后续的 inotify 操作。

2. inotify_add_watch()

• 功能：添加一个监控项。
• 参数：
  • fd：由 inotify_init() 返回的文件描述符。
  • path：要监控的文件或目录的路径。
  • mask：指定要监控的事件类型，可以是多个事件的组合。
• 返回值：返回一个监控描述符（watch descriptor），用于后续的操作。

3. read()

• 功能：从 inotify 文件描述符中读取事件。
• 参数：
  • fd：inotify 文件描述符。
  • buf：用于存储事件的缓冲区。
  • len：缓冲区的长度。
• 返回值：返回读取的事件数量，如果发生错误则返回 -1。

4. inotify_rm_watch()

• 功能：移除一个监控项。
• 参数：
  • fd：inotify 文件描述符。
  • wd：要移除的监控描述符。
• 返回值：成功返回 0，失败返回 -1。

5. close()

• 功能：关闭 inotify 文件描述符。
• 参数：
  • fd：要关闭的 inotify 文件描述符。
• 返回值：成功返回 0，失败返回 -1。

事件掩码（mask）

inotify 使用事件掩码来指定要监控的事件类型。常见的事件类型包括：

• IN_ACCESS：文件被访问。
• IN_MODIFY：文件被修改。
• IN_ATTRIB：文件属性被修改。
• IN_CLOSE_WRITE：文件被写入后关闭。
• IN_CLOSE_NOWRITE：文件在没有写入的情况下关闭。
• IN_OPEN：文件被打开。
• IN_MOVED_FROM：文件从一个目录移动到另一个目录。
• IN_MOVED_TO：文件被移动到一个目录。
• IN_CREATE：文件或目录被创建。
• IN_DELETE：文件或目录被删除。
• IN_DELETE_SELF：监控的文件或目录本身被删除。
• IN_MOVE_SELF：监控的文件或目录本身被移动。

示例代码

以下是一个简单的示例代码，演示如何使用 inotify 监控一个目录：

#include <stdio.h>#include <stdlib.h>#include <string.h>#include <sys/inotify.h>#include <unistd.h>#define EVENT_SIZE( sizeof (struct inotify_event) )#define BUF_LEN ( 1024 * ( EVENT_SIZE + 16 ) )int main(int argc, char **argv) {int length, i = 0;int fd;int wd;char buffer[BUF_LEN];// 初始化 inotifyfd = inotify_init();if (fd < 0) {perror("inotify_init");return 1;}// 添加监控项wd = inotify_add_watch(fd, "/path/to/directory", IN_MODIFY | IN_CREATE | IN_DELETE);if (wd < 0) {perror("inotify_add_watch");close(fd);return 1;}// 读取事件while (1) {length = read(fd, buffer, BUF_LEN);if (length < 0) {perror("read");break;}while (i < length) {struct inotify_event *event = (struct inotify_event *) &buffer[i];if (event->len) {if (event->mask & IN_CREATE) {printf("File %s was created.n", event->name);} else if (event->mask & IN_DELETE) {printf("File %s was deleted.n", event->name);} else if (event->mask & IN_MODIFY) {printf("File %s was modified.n", event->name);}}i += EVENT_SIZE + event->len;}i = 0;}// 移除监控项并关闭文件描述符inotify_rm_watch(fd, wd);close(fd);return 0;}

这个示例代码展示了如何初始化 inotify，添加监控项，读取事件，并在检测到文件变化时打印相应的消息。