executes commands upon file system events (using inotify)
Go to file
Albert S. 64b55f3bfd added encryptor.sh example 2016-02-06 18:33:33 +01:00
examples added encryptor.sh example 2016-02-06 18:33:33 +01:00
Makefile replace gcc with in makefile 2014-03-05 18:18:56 +01:00
README updated README 2016-01-02 14:23:43 +01:00
TODO Added TODO 2014-12-20 20:12:01 +01:00
adhocify.c usage text: document -e 2016-01-02 14:23:20 +01:00

README

What is adhocify?
=================
adhocify uses inotify to watch for file system events. 
Once an event occurs it can execute a script.
The path of the file and the event will be passed to that script. 

Requirements
============
adhocify only runs on Linux. You need a kernel and libc with inotify support.

Examples:
=========
./adhocify -w /tmp/ /home/core/myscript.sh
------------------------------------------
Watches for IN_CLOSE_WRITE events in /tmp/, launches script /home/core/myscript.sh

/adhocify -w /tmp/ /home/core/myscript.sh {}
------------------------------------------
Same as above, but also passes the file an event occured on to that script. (argv[1]).


./adhocify -w /tmp/ /bin/echo the file {} was written to
---------------------------------------------------------
Running
echo "Test" > /tmp/test

Will print in the shell adhocify was launched in:
the file /tmp/test was written to

./adhocify -w /tmp/ -w /var/run /home/core/myscript.sh
------------------------------------------------------
Same as above, but also watches /var/run

./adhocify /home/core/myscript.sh
---------------------------------
Watches for IN_CLOSE_WRITE events in the current directory, launches script 
/home/core/myscript.

./adhocify -m IN_OPEN -w /tmp /home/core/myscript.sh
----------------------------------------------------
Watches for IN_OPEN events in /tmp/, launches script /home/core/myscript.sh

./adhocify -w /tmp -i *.txt /home/core/myscript.sh
--------------------------------------------------
Watches for IN_CLOSE_WRITE events in /tmp/ but will not pass *.txt files to the script

Further options
===============
-e, --exit-with-child: Instructs adhocify to exit once the script does. You can also specify an exit code, e. g. -e 1, to only exit when the script returns with an error. Default exit code is 0.