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 inotifywaitinotifywait -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_tomoved_from
move_self 文件或目录被移除,之后不再监听此文件或目录。
create 文件或目录创建
delete 文件或目录删除
delete_self 文件或目录移除,之后不再监听此文件或目录
unmount 文件系统取消挂载,之后不再监听此文件系统。

使用示例

inotifywait -m -r -e modify /source/ | while read dir action filename
do
echo ${dir}
echo ${action}
echo ${filename}
rsync -a -u /source/ /dest/
done

常见错误

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 功能正常。

脚注