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 ] [ … ]

@
排除不需要监视的文件,可以是相对路径,也可以是绝对路径。

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

脚注