描述

Inotify API用于檢測文件系統變化的機制。Inotify可用于檢測單個文件，也可以檢測整個目錄。當檢測的對象是一個目錄的時候，目錄本身和目錄里的內容都會成為檢測的對象。

此種機制的出現的目的是當內核空間發生某種事件之后，可以立即通知到用戶空間。方便用戶做出具體的操作。

Inotify API

• inotify_init(void)

用于創建一個inotify的實例，然后返回inotify事件隊列的文件描述符。 同樣內核也提供了inotify_init1(int flags)接口函數，當flag等于0的時候，該函數等價于inotify_init(void)函數。

• inotify_add_watch(int fd, const char* pathname, uint32_t? mask)

該函數用于添加“watch list”，也就是檢測列表。 可以是一個新的watch，也可以是一個已經存在的watch。其中fd就是inotify_init的返回值，pathname是要檢測目錄或者文件的路徑，mask就是要檢測的事件類型。該函數成功返回的是一個unique的watch描述符。

• inotify_rm_watch(int fd, int wd)

用于從watch list種移除檢測的對象。

?

數據結構

內核使用struct inotify_event代表一個文件事件。當檢測的文件對象發生變化時，使用read系統調用就會返回一個或者多個inotify_event的文件事件對象。

1. struct inotify_event {

2. int wd; /* Watch descriptor */

3. uint32_t mask; /* Mask of events */

4. uint32_t cookie; /* Unique cookie associating related

5. events (for rename(2)) */

6. uint32_t len; /* Size of name field */

7. char name[]; /* Optional null-terminated name */

8. };

.wd:??????? 就是檢測的對象的watch descriptor

.mask:??? 檢測事件的mask

.cookie:? 和rename事件相關。

.len:??????? name字段的長度。

.name:??? 檢測對象的name。

可以看到name字段的長度是0，也就是變長的。因為檢測的對象的name不定，使用變長可以方便記錄檢測對象的name。

?

有關檢測的事件類型分為好幾種，如下：

1. IN_ACCESS File was accessed (read) (*).

2. IN_ATTRIB Metadata changed, e.g., permissions, timestamps, extended

3. attributes, link count (since Linux 2.6.25), UID, GID, etc.(*).

4. IN_CLOSE_WRITE File opened for writing was closed (*).

5. IN_CLOSE_NOWRITE File not opened for writing was closed (*).

6. IN_CREATE File/directory created in watched directory (*).

7. IN_DELETE File/directory deleted from watched directory (*).

8. IN_DELETE_SELF Watched file/directory was itself deleted.

9. IN_MODIFY File was modified (*).

10. IN_MOVE_SELF Watched file/directory was itself moved.

11. IN_MOVED_FROM File moved out of watched directory (*).

12. IN_MOVED_TO File moved into watched directory (*).

13. IN_OPEN File was opened (*).

注釋寫的很清楚，不再一一解釋了。

?

實例分析

1. #include <sys/inotify.h>

2. #include <unistd.h>

3. #include <string.h>

4. #include <stdio.h>

5. ?

6. /*

7. struct inotify_event {

8. int wd; // Watch descriptor

9. uint32_t mask; // Mask of events

10. uint32_t cookie; // Unique cookie associating related events (for rename(2))

11. uint32_t len; // Size of name field

12. char name[]; // Optional null-terminated name

13. };

14. ?

15. */

16. ?

17. int watch_inotify_events(int fd)

18. {

19. char event_buf[512];

20. int ret;

21. int event_pos = 0;

22. int event_size = 0;

23. struct inotify_event *event;

24. ?

25. /*讀事件是否發生，沒有發生就會阻塞*/

26. ret = read(fd, event_buf, sizeof(event_buf));

27. ?

28. /*如果read的返回值，小于inotify_event大小出現錯誤*/

29. if(ret < (int)sizeof(struct inotify_event))

30. {

31. printf("counld not get event!\n");

32. return -1;

33. }

34. ?

35. /*因為read的返回值存在一個或者多個inotify_event對象，需要一個一個取出來處理*/

36. while( ret >= (int)sizeof(struct inotify_event) )

37. {

38. event = (struct inotify_event*)(event_buf + event_pos);

39. if(event->len)

40. {

41. if(event->mask & IN_CREATE)

42. {

43. printf("create file: %s\n",event->name);

44. }

45. else

46. {

47. printf("delete file: %s\n",event->name);

48. }

49. }

50. ?

51. /*event_size就是一個事件的真正大小*/

52. event_size = sizeof(struct inotify_event) + event->len;

53. ret -= event_size;

54. event_pos += event_size;

55. }

56. ?

57. return 0;

58. }

59. ?

60. int main(int argc, char** argv)

61. {

62. int InotifyFd;

63. int ret;

64. ?

65. if (argc != 2)

66. {

67. printf("Usage: %s <dir>\n", argv[0]);

68. return -1;

69. }

70. ?

71. /*inotify初始化*/

72. InotifyFd = inotify_init();

73. if( InotifyFd == -1)

74. {

75. printf("inotify_init error!\n");

76. return -1;

77. }

78. ?

79. /*添加watch對象*/

80. ret = inotify_add_watch(InotifyFd, argv[1], IN_CREATE | IN_DELETE);

81. ?

82. /*處理事件*/

83. watch_inotify_events(InotifyFd);

84. ?

85. /*刪除inotify的watch對象*/

86. if ( inotify_rm_watch(InotifyFd, ret) == -1)

87. {

88. printf("notify_rm_watch error!\n");

89. return -1;

90. }

91. ?

92. /*關閉inotify描述符*/

93. close(InotifyFd);

94. ?

95. return 0;

96. }

?

1. ?編譯代碼

gcc inotify.c -o inotify

2. 在tmp目錄下創建test目錄

mkdir /tmp/test

3. ?檢測/tmp/test目錄，使用inotify機制

./inotify /tmp/test &

4. ?在/tmp/test下創建1.txt文件

1. test$ touch /tmp/test/1.txt

2. create file: 1.txt