POWfs Files

General Information
===================

POWfs (Process On Write filesystem) is an extension to the FUSE core
that allows the user to execute user-defined commands immediately after a 
file is written to disk.

You can download the source code releases from

  http://sourceforge.net/projects/powfs/

or alternatively you can use Subversion to get the very latest development
version:

  svn checkout https://powfs.svn.sourceforge.net/svnroot/powfs/trunk


Dependencies
============

FUSE core libraries and headers are needed.

Installation
============

./configure
make
make install

You may also need to add '/usr/local/lib' to '/etc/ld.so.conf' and/or
run ldconfig.

For more details see the file 'INSTALL'

How To Use
==========

 - Create a .powfs file in your home directory

 - Edit the file to set up handlers for each real directory you like

The format required for a handler is /folder/name/=/handler/program

For example an entry of:

/tmp/=/home/username/bin/script.sh

would execute /home/username/bin/script.sh immediately after each file is
written to the /tmp/ directory.  It will pass the program a single argument 
of the real path to the full filename.

Lets say that /home/username/bin/script.sh had the following data
#!/bin/sh
mail -s "Updated file" root@localhost $1

With the configuration above, here is an example run.
cd src
./powfs mountpoint
touch mountpoint/tmp/blah

This would send an email to root saying that the file /tmp/blah has been
modified.  Keep in mind that the mountpoint is simply a virtual mirror of
the root filesystem.  This means that files must be modified through
"mountpoint" to trigger the handler.

Possible Uses
=============

 - Be alerted immediately after anything in the /etc folder is modified
 - Process raw data files in realtime immediately after receipt.
 - Write files locally and move them to an archived network share when the 
     file is closed.
 - Be notified by email each time a file is finished uploading to your FTP 
     directory.
 - Verify that an automated report is complete immediately after it finishes
 - Automatically upload a new revision of a file to a remote computer each 
     time the file is saved.

Reporting bugs
==============

Please send bug reports to the <powfs-devel@lists.sourceforge.net>
mailing list.

The list is open, you need not be subscribed to post.