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，添加監控項，讀取事件，并在檢測到文件變化時打印相應的消息。