Debian inotify是否有API接口可用

Debian系统中inotify提供完整的API接口，支持应用程序通过系统调用实时监控文件或目录的变化（如创建、删除、修改等）。这些API属于Linux内核子系统，Debian通过libinotify-dev开发库提供头文件和链接库支持。

一、主要API接口及功能

inotify的核心API是一组系统调用，用于管理监控实例、添加/移除监控项及读取事件，具体如下：

1. inotify_init / inotify_init1

创建一个inotify实例，返回对应的文件描述符（fd）。inotify_init1是扩展版本，支持额外标志（如IN_NONBLOCK实现非阻塞模式）。

2. inotify_add_watch

向inotify实例的“监控列表”中添加一个路径（文件或目录），并指定感兴趣的事件类型（通过mask参数，如IN_CREATE、IN_DELETE、IN_MODIFY）。返回一个唯一的“监控描述符”（wd），用于后续操作。

3. inotify_rm_watch

从inotify实例的监控列表中移除指定监控描述符（wd）的项。当所有关联的文件描述符关闭时，监控会自动释放。

4. read

从inotify文件描述符中读取事件。若设置为阻塞模式，read会等待直到有事件发生；返回的事件数据为struct inotify_event结构体（包含事件类型、文件名等信息）。

5. close

关闭inotify文件描述符，释放相关资源。当所有关联的fd关闭时，内核会自动释放监控列表。

二、Debian中使用inotify API的前提条件

需安装libinotify-dev开发库，提供API的头文件（sys/inotify.h）和链接库：

sudo apt update
sudo apt install libinotify-dev

三、简单示例（C语言）

以下代码演示如何监控指定目录的文件创建、删除、修改事件：

#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 fd, wd, length, i = 0;
    char buffer[BUF_LEN];

    if (argc != 2) {
        printf("Usage: %s <directory>\n", argv[0]);
        exit(EXIT_FAILURE);
    }

    // 初始化inotify实例
    fd = inotify_init();
    if (fd < 0) {
        perror("inotify_init");
        exit(EXIT_FAILURE);
    }

    // 添加监控项（监控目录的创建、删除、修改事件）
    wd = inotify_add_watch(fd, argv[1], IN_CREATE | IN_DELETE | IN_MODIFY);
    if (wd < 0) {
        perror("inotify_add_watch");
        exit(EXIT_FAILURE);
    }

    printf("Monitoring directory: %s\n", argv[1]);

    // 循环读取事件
    while (1) {
        length = read(fd, buffer, BUF_LEN);
        if (length < 0) {
            perror("read");
            exit(EXIT_FAILURE);
        }

        // 解析事件
        while (i < length) {
            struct inotify_event *event = (struct inotify_event *)&buffer[i];
            if (event->len) {
                if (event->mask & IN_CREATE)
                    printf("Created: %s\n", event->name);
                else if (event->mask & IN_DELETE)
                    printf("Deleted: %s\n", event->name);
                else if (event->mask & IN_MODIFY)
                    printf("Modified: %s\n", event->name);
            }
            i += EVENT_SIZE + event->len;
        }
        i = 0;
    }

    // 清理资源
    inotify_rm_watch(fd, wd);
    close(fd);
    return 0;
}

编译并运行：

gcc -o inotify_example inotify_example.c -linotify
./inotify_example /path/to/directory

四、注意事项

• 监控数量限制：默认最大监控数量为/proc/sys/fs/inotify/max_user_watches（可通过echo 65536 | sudo tee /proc/sys/fs/inotify/max_user_watches临时调整）。
• 性能优化：避免监控过多文件（如超过10万个），可通过--exclude参数排除无关路径。
• 事件合并：inotify可能合并连续事件（如多次修改），需根据业务逻辑处理事件顺序。