inotify的API接口有哪些_运维文库_资讯中心

发布时间:2026-04-26 22:58:22

阅读量:3

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 
#include 
#include 
#include 
#include 

#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;
}