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];

    // 初始化 inotify
    fd = 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，添加监控项，读取事件，并在检测到文件变化时打印相应的消息。