linux-c使用inotify监控文件

在Linux相关项目中，遇到过这样子的需求，要监控某个目录下文件的改动，比如新建，删除等，这时候inotify就派上用场了。

相应头文件是：#include <sys/inotify.h>

inotify相关API

int inotify_init(void)

初始化一个inotify实例，返回值是一个文件描述符，在inotify_add_watch函数中将会用到。

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

由名字可知，增加一个监听，将要监听的文件或者目录添加到inotify中，其中fd是inotify初始化时候返回的文件描述符，pathname是要监听的文件的路径，mask是要监听的事件(事件有多种，比如创建，删除等),其返回值是一个inotify标识，用于判断返回的事件是属于哪一个被监听的文件的，还有移除监听文件的时候通过这个标识指定。

int inotify_rm_watch(int fd,uint32_t wd)

从监听列表中删除一个监听文件/目录，fd是初始化时候返回的文件描述符，wd是监听的文件的标识，由inotify_add_watch函数返回。

int inotify_rm_watch(int fd, int wd)

移除一个文件/目录监控

读取事件
读取事件是调用系统read()函数，其中参数为inotify初始化返回的文件描述符，而读取事件会返回一个inotify_event结构体，如下：

struct inotify_event  
{  
    int wd; /* Watch descriptor. */  
    unit32_t mask; /* Watch mask */  
    unit32_t cookie; /* Cookie to synchronize two events. */  
    unit32_t len; /* Length (including NULLs) of name. */  
    char name[]; /* Name. */  
};  

wd：inotify标识符(就是inotify_add_watch的返回值)
mask：事件的掩码
cookie：文件被修改时才用到
name：就是发生改变的文件/目录的名字
len：就是name的长度

关闭inotify监听
如同文件操作一样，inotify在最后也要调用close()函数关闭监听，参数为初始化时候返回的文件描述符。

事件类型

• IN_ACCESS：文件被访问
• IN_ATTRIB：文件属性改变
• IN_CLOSE_WRITE：关闭打开写的文件
• IN_CLOSE_NOWRITE：关闭不是打开写的文件
• IN_CREATE：用于目录，监控的目录中创建目录或者文件时会发生
• IN_DELETE：用于目录，监控的目录中删除目录或者文件时会发生
• IN_DELETE_SELF：监控的目录或文件自身被删除
• IN_MODIFY：文件被修改，会用到上述结构体中的cookie
• IN_MOVE_SELF：监控的文件或目录自身被移动
• IN_MOVED_FROM：从监控的目录中移出文件
• IN_MOVED_TO：往监控的目录中移入文件
• IN_OPEN：文件/目录被打开
• IN_ALL_EVENTS： 包含上述所有事件，在inotify_add_watch函数中调用

Sample

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <errno.h>
#include <sys/types.h>
#include <sys/inotify.h>

#define EVENT_SIZE  ( sizeof (struct inotify_event) )
#define EVENT_BUF_LEN     ( 1024 * ( EVENT_SIZE + 16 ) )

int main(void)
{
	int length, i = 0;
	int fd;
	int wd;
	char buffer[EVENT_BUF_LEN];

	//inotify初始化
	fd = inotify_init();
	if (fd < 0) 
	{
		perror("inotify_init");
		return -1;
	}

	//监听/mnt和/home目录
	wd = inotify_add_watch(fd, "/mnt", IN_CREATE | IN_DELETE);
    printf("1.wd = %d\n",wd);
	wd = inotify_add_watch(fd, "/home", IN_CREATE | IN_DELETE); 
    printf("2.wd = %d\n",wd);
	
	while(1)
	{
		i = 0;
		length = read(fd, buffer, EVENT_BUF_LEN);
		if (length < 0)
		{
			perror("read");
			continue;
		}

		while (i < length) 
		{
			struct inotify_event *event = (struct inotify_event *) &buffer[i];
			if (event->len) 
			{
				if (event->mask & IN_CREATE) 
				{
					if (event->mask & IN_ISDIR) 
					{
                        printf("New directory wd = %d .\n", event->wd);
						printf("New directory %s created.\n", event->name);
					} 
					else 
					{
                        printf("New file wd = %d .\n", event->wd);
						printf("New file %s created.\n", event->name);
					}
				} 
				else if (event->mask & IN_DELETE) 
				{
					if (event->mask & IN_ISDIR) 
					{
                        printf("Directory wd = %d deleted.\n", event->wd);
						printf("Directory %s deleted.\n", event->name);
					} 
					else 
					{
                        printf("File wd = %d deleted.\n", event->wd);
						printf("File %s deleted.\n", event->name);
					}
				}
			}
			i += EVENT_SIZE + event->len;
		}

	}
	
	inotify_rm_watch(fd, wd);
	close(fd);
	
	return 0;
}

注意在事件发生时候，inotify.event.name的问题，可以参考这篇博文：
https://ixyzero.com/blog/archives/3513.html