Linux下使用inotify监控文件动作

Linux下使用inotify监控文件动作

发表于 2011年07月01日 | 分类:  C/C++ |  发表评论

在日常应用中，常常会遇到以下场景，监控文件夹A，若文件夹中的B文件发生变化，则执行C命令。Linux下可以通过inotify完成该功能。
自从Linux kernel 2.6.13起，inotify以作为内核的一部份，同时需要glibc 2.4以上版本。

1. 相关函数

inotify_init() - 创建一个inotify实例
inotify_add_watch(int fd, const char *pathname, uint32_t mask) - 加入文件或目录到inotify进行监测
inotify_rm_watch(int fd, int wd) - 移除一个watcher

2. 相关结构

         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 */
           };

3. Mask

适用于 inotify_add_watch mask 与 read 返回的inotify_event中mask

IN_ACCESS	文件被访问
IN_ATTRIB	文件属性发生变化
IN_CLOSE_WRITE	以write方式打开文件并关闭
IN_CLOSE_NOWRITE	以非write方式打开文件并关闭
IN_CREATE	文件或目录被创建
IN_DELETE	文件或目录被删除（被监测的文件夹A中B文件被删除）
IN_DELETE_SELF	被监测的文件或目录被删除（被监测的文件夹A被删除）
IN_MODIFY	文件被修改
IN_MOVE_SELF	被监测的文件或目录移动
IN_MOVED_FROM	文件移出被监测的目录
IN_MOVED_TO	文件移入被监测的目录
IN_OPEN	文件被打开
上述flag的集合
IN_ALL_EVENTS	以上所有flag的集合
IN_MOVE	IN_MOVED_TO|IN_MOVED_FROM
IN_CLOSE	IN_CLOSE_WRITE|IN_CLOSE_NOWRITE
不常用的flag
IN_DONT_FOLLOW	不follow符号链接 (since 2.6.15)
IN_EXCL_UNLINK	当文件从监测目中unlink后，则不再报告该文件的相关event，比如监控/tmp使用 (since 2.6.36)
IN_MASK_ADD	追打MASK到被监测的pathname
IN_ONESHOT	只监测一次
IN_ONLYDIR	只监测目录

仅由read返回

IN_IGNORED	inotify_rm_watch，文件被删除或者文件系统被umount
IN_ISDIR	发生事件的是一个目录
IN_Q_OVERFLOW	Event队列溢出
IN_UNMOUNT	文件系统unmount

4. 例子

用途：监测指定文件或目录（或不指定则为当前目录）的一切动作。
使用：inotify [文件或目录]

view plain copy to clipboard print ?

1. #include <unistd.h>  
2. #include <sys/inotify.h>  
3. #include <stdio.h>  
4. #include <error.h>  
5. #include <errno.h>  
6. #include <string.h>  
7.   
8. #define ERROR(text) error(1, errno, "%s", text)  
9.   
10. struct EventMask {  
11.     int        flag;  
12.     const char *name;  
13.   
14. };  
15.   
16. int freadsome(void *dest, size_t remain, FILE *file)  
17. {  
18.     char *offset = (char*)dest;  
19.     while (remain) {  
20.         int n = fread(offset, 1, remain, file);  
21.         if (n==0) {  
22.             return -1;  
23.         }  
24.   
25.         remain -= n;  
26.         offset += n;  
27.     }  
28.     return 0;  
29. }  
30.   
31. int main(int argc, char *argv[])  
32. {  
33.     const char *target;  
34.     if (argc == 1) {  
35.         target = ".";  
36.     } else {  
37.         target = argv[1];  
38.     }  
39.   
40.     EventMask event_masks[] = {  
41.            {IN_ACCESS        , "IN_ACCESS"}        ,    
42.            {IN_ATTRIB        , "IN_ATTRIB"}        ,    
43.            {IN_CLOSE_WRITE   , "IN_CLOSE_WRITE"}   ,    
44.            {IN_CLOSE_NOWRITE , "IN_CLOSE_NOWRITE"} ,    
45.            {IN_CREATE        , "IN_CREATE"}        ,    
46.            {IN_DELETE        , "IN_DELETE"}        ,    
47.            {IN_DELETE_SELF   , "IN_DELETE_SELF"}   ,    
48.            {IN_MODIFY        , "IN_MODIFY"}        ,    
49.            {IN_MOVE_SELF     , "IN_MOVE_SELF"}     ,    
50.            {IN_MOVED_FROM    , "IN_MOVED_FROM"}    ,    
51.            {IN_MOVED_TO      , "IN_MOVED_TO"}      ,    
52.            {IN_OPEN          , "IN_OPEN"}          ,    
53.   
54.            {IN_DONT_FOLLOW   , "IN_DONT_FOLLOW"}   ,    
55.            {IN_EXCL_UNLINK   , "IN_EXCL_UNLINK"}   ,    
56.            {IN_MASK_ADD      , "IN_MASK_ADD"}      ,    
57.            {IN_ONESHOT       , "IN_ONESHOT"}       ,    
58.            {IN_ONLYDIR       , "IN_ONLYDIR"}       ,    
59.   
60.            {IN_IGNORED       , "IN_IGNORED"}       ,    
61.            {IN_ISDIR         , "IN_ISDIR"}         ,    
62.            {IN_Q_OVERFLOW    , "IN_Q_OVERFLOW"}    ,    
63.            {IN_UNMOUNT       , "IN_UNMOUNT"}       ,    
64.     };  
65.   
66.     int monitor = inotify_init();  
67.     if ( -1 == monitor ) {  
68.         ERROR("monitor");  
69.     }  
70.   
71.     int watcher = inotify_add_watch(monitor, target, IN_ALL_EVENTS);  
72.     if ( -1 == watcher  ) {  
73.         ERROR("inotify_add_watch");  
74.     }  
75.   
76.     FILE *monitor_file = fdopen(monitor, "r");  
77.     char last_name[1024];  
78.     char name[1024];  
79.   
80.     /* event:inotify_event -> name:char[event.len] */  
81.     while (true) {  
82.         inotify_event event;  
83.         if ( -1 == freadsome(&event, sizeof(event), monitor_file) ) {  
84.             ERROR("freadsome");  
85.         }  
86.         if (event.len) {  
87.             freadsome(name, event.len, monitor_file);  
88.         } else {  
89.             sprintf(name, "FD: %d\n", event.wd);  
90.         }  
91.   
92.         if (strcmp(name, last_name) != 0) {  
93.             puts(name);  
94.             strcpy(last_name, name);  
95.         }  
96.   
97.         /* 显示event的mask的含义 */  
98.         for (int i=0; i<sizeof(event_masks)/sizeof(EventMask); ++i) {  
99.             if (event.mask & event_masks[i].flag) {  
100.                 printf("\t%s\n", event_masks[i].name);  
101.             }  
102.         }  
103.     }  
104.     return 0;  
105. }  

运行结果： vim 中 对监测目录中的 inotify.cc 进行保存

4913
	IN_CREATE
	IN_OPEN
	IN_ATTRIB
	IN_CLOSE_WRITE
	IN_DELETE
inotify.cc
	IN_MOVED_FROM
inotify.cc~
	IN_MOVED_TO
inotify.cc
	IN_CREATE
	IN_OPEN
	IN_MODIFY
	IN_CLOSE_WRITE
	IN_ATTRIB
inotify.cc~
	IN_DELETE