salt.beacons.inotify¶

Watch files and translate the changes into salt events

depends:	pyinotify Python module >= 0.9.5
Caution:	Using generic mask options like open, access, ignored, and closed_nowrite with reactors can easily cause the reactor to loop on itself.

salt.beacons.inotify.beacon(config)¶

Watch the configured files

Example Config

beacons:
  inotify:
    /path/to/file/or/dir:
      mask:
        - open
        - create
        - close_write
      recurse: True
      auto_add: True

The mask list can contain the following events (the default mask is create, delete, and modify):

access File accessed
attrib File metadata changed
close_nowrite Unwritable file closed
close_write Writable file closed
create File created in watched directory
delete File deleted from watched directory
delete_self Watched file or directory deleted
modify File modified
moved_from File moved out of watched directory
moved_to File moved into watched directory
move_self Watched file moved
open File opened

The mask can also contain the following options:

dont_follow Don't dereference symbolic links
excl_unlink Omit events for children after they have been unlinked
oneshot Remove watch after one event
onlydir Operate only if name is directory

recurse:: Recursively watch files in the directory
auto_add:: Automatically start watching files that are created in the watched directory