Linux inotify API使用指南

Linux的inotify API允许应用程序监控文件系统事件，如文件的创建、删除、修改和移动等。这对于构建文件同步工具、备份程序或任何需要对文件变化做出响应的应用程序非常有用。

以下是使用inotify API的基本步骤：

1. 包含头文件： 在你的C程序中，你需要包含sys/inotify.h头文件来使用inotify的功能。

2. 创建inotify实例： 使用inotify_init()函数创建一个新的inotify实例。这个函数返回一个文件描述符，你将用它来添加监控和读取事件。

   int fd = inotify_init();
   if (fd < 0) {
       // 错误处理
   }
   

3. 添加监控： 使用inotify_add_watch()函数来添加对特定文件或目录的监控。你需要提供inotify实例的文件描述符、要监控的文件或目录的路径，以及你想要监控的事件类型。

   int wd = inotify_add_watch(fd, "/path/to/file_or_directory", IN_MODIFY | IN_CREATE | IN_DELETE);
   if (wd < 0) {
       // 错误处理
   }
   

   这里IN_MODIFY、IN_CREATE和IN_DELETE是事件掩码，表示你想要监控修改、创建和删除事件。你可以根据需要组合多个事件。

4. 读取事件： 使用read()函数从inotify实例的文件描述符读取事件。事件数据会被填充到inotify_event结构体中。

   char buffer[4096];
   ssize_t length = read(fd, buffer, sizeof(buffer));
   if (length < 0) {
       // 错误处理
   }
   
   // 解析buffer中的事件
   

   inotify_event结构体定义如下：

   struct inotify_event {
       int      wd;             /* watch descriptor */
       uint32_t mask;           /* mask of events */
       uint32_t cookie;         /* unique cookie associating related events (for rename(2)) */
       uint32_t len;            /* size of name field */
       char     name[];         /* optional null-terminated name */
   };
   

   mask字段包含了发生的事件类型，name字段包含了发生事件的文件或目录的名称。

5. 移除监控： 当你不再需要监控某个文件或目录时，可以使用inotify_rm_watch()函数来移除监控。

   int ret = inotify_rm_watch(fd, wd);
   if (ret < 0) {
       // 错误处理
   }
   

6. 关闭inotify实例： 当你的应用程序结束时，应该使用close()函数来关闭inotify实例的文件描述符。

   close(fd);
   

这是一个简单的使用inotify API的例子。在实际应用中，你可能需要处理多个监控项，解析复杂的事件数据，并且优雅地处理各种可能的错误情况。此外，inotify API还有更多的功能和选项，比如设置监控的最大文件数、使用IN_ONLYDIR标志来只监控目录等。你可以查阅Linux man pages (man 7 inotify) 来获取更多详细信息和高级用法。