inotify 安装使用
环境信息
- Centos 7
安装
使用系统软件包管理器安装
yum install -y inotify-tools
安装后包含2个命令:
inotifywait
,inotifywatch
,较为常用的命令是inotifywait
编译安装
此处安装版本3.22.6.0
[1]wget https://github.com/inotify-tools/inotify-tools/archive/refs/tags/3.22.6.0.tar.gz
tar -xf 3.22.6.0.tar.gz
cd inotify-tools-3.22.6.0/
yum install -y dh-autoreconf
./autogen.sh && ./configure --prefix=/usr/local/inotify-tools-3.22.6.0 && make && su -c 'make install'
inotifywait 参数说明
语法:
inotifywait [-hcmrq] [-e modify,access…] [-t ] [–format ] [–timefmt ] [ … ]
常用选项参数说明,可查看 man inotifywait
或 inotifywait -h
阅读帮助文档:
选项 | 说明 | 示例 |
---|---|---|
--fromfile |
从文件读取需要监视的文件或排除的文件,一个文件一行,排除的文件以 @ 开头。 |
|
-m, --monitor |
接收到一个事情而不退出,无限期地执行。默认的行为是接收到一个事情后立即退出。 | |
-d,--daemon |
跟 –-monitor 一样,除了是在后台运行,需要指定 -–outfile 把事情输出到一个文件。也意味着使用了 --syslog |
|
-o, --outfile |
输出事情到一个文件而不是标准输出。 | |
-s, --syslog |
输出错误信息到系统日志 | |
-r, --recursive |
监视一个目录下的所有子目录。 | |
-q, --quiet |
指定一次,不会输出详细信息,指定二次,除了致命错误,不会输出任何信息。 | |
--exclude |
正则匹配需要排除的文件,大小写敏感 | |
--excludei |
正则匹配需要排除的文件,忽略大小写。 | |
-t, --timeout |
设置超时时间,如果为 0,则无限期地执行下去。 | |
-e, --event |
指定监视的事件。 | |
-c, --csv |
输出 csv 格式。 | |
--timefmt |
指定时间格式,用于 –-format 选项中的 %T 格式。 |
|
--format |
指定输出格式。 - %w 表示发生事件的目录- %f 表示发生事件的文件 - %e 表示发生的事件 - %Xe 事件以 X 分隔- %T 使用由 --timefmt 定义的时间格式 |
可监听事件列表
事件 | 说明 | 示例 |
---|---|---|
access |
文件读取 | |
modify |
文件更改。 | |
attrib |
文件属性更改,如权限,时间戳等。 | |
close_write |
以可写模式打开的文件被关闭,不代表此文件一定已经写入数据。 | |
close_nowrite |
以只读模式打开的文件被关闭。 | |
close |
文件被关闭,不管它是如何打开的。 | |
open |
文件打开。 | |
moved_to |
一个文件或目录移动到监听的目录,即使是在同一目录内移动,此事件也触发。 | |
moved_from |
一个文件或目录移出监听的目录,即使是在同一目录内移动,此事件也触发。 | |
move |
包括 moved_to 和 moved_from |
|
move_self |
文件或目录被移除,之后不再监听此文件或目录。 | |
create |
文件或目录创建 | |
delete |
文件或目录删除 | |
delete_self |
文件或目录移除,之后不再监听此文件或目录 | |
unmount |
文件系统取消挂载,之后不再监听此文件系统。 |
使用示例
inotifywait -m -r -e modify /source/ | while read dir action filename |
常见错误
inotify 监听文件 modify 一段时间后监控不到文件的变化
使用 inotifywait
监听文件内容的变化,开始时正常,过几分钟后,文件发生了变化,inotifywait
未监控到任何事件,亦未退出或中断。
inotify 的支持,依赖于,以下内核参数
fs.inotify.max_queued_events
- 默认值 16384。inotify 的事件队列大小。超出后会报Event queue overflow
fs.inotify.max_user_watches
- 默认值 8192。指定了当前文件系统允许的最大监控数量。fs.inotify.max_user_instances
- 默认值 128。单个用户可以创建的 inotify 实例的最大数量。当遇到inotify_init: Too many open files
报错,需要修改此值。
inotify 无法监控文件或者目录的变动时,很可能是以上内核参数的限制导致。
本示例通过修改 sysctl fs.inotify.max_queued_events=1000000
后,inotify 功能正常。