Man Linux: Main Page and Category List

NAME

       iwatch  -  a  realtime  filesystem  monitor  /  monitor  any changes in
       directories/files specified

SYNOPSIS

       iwatch [options]

DESCRIPTION

       This manual page documents briefly the iwatch  command.   iWatch  is  a
       realtime  filesystem  monitoring  program. It’s a simple perl script to
       monitor  changes  in  specific   directories/files   and   send   email
       notification  immediately.  It  reads the dir/file list from xml config
       file and needs inotify support in kernel (Linux Kernel >= 2.6.13).

OPTIONS

       Usage for daemon mode of iWatch:

       iwatch [-d] [-f <config file>] [-v] [-p <pid file>]

       In the daemon mode iWatch has the following options:

       -d     Execute the application as daemon. iWatch will run in  foregroud
              without this option.

       -f <configfile.xml>
              Specify    alternative    configuration    file.    Default   is
              /etc/iwatch/iwatch.xml.

       -p <pidfile>
              Specify an alternate pid file (default: /var/run/iwatch.pid)

       -v     Be verbose.

       Usage for command line mode of iWatch:

       iwatch [-c command]  [-e  event[,event[,..]]]  [-h|--help]  [-m  <email
       address>]  [-r] [-s <on|off>] [-t <filter string>] [-v] [--version] [-x
       exception] [-X <regex string as exception>] <target>

       In the command line mode iWatch has the following options:

       -c <command>
              You can specify a command to be executed if an event occurs. For
              details    about    the   string   format   take   a   look   at
              /usr/share/doc/iwatch/README.gz.

       -C <charset>
              Specify the charset (default is utf-8).

       -e <event[,event[,..]]>
              Events list. For details about possible events take  a  look  at
              /usr/share/doc/iwatch/README.gz.

       -h, --help
              Print help message.

       -m <emailaddress>
              Contact  point’s email address. Without this option, iwatch will
              not send any email notification (obviously).

       -r     Recursivity of the watched directory.

       -s on|off
              Enable  or  disable  reports   to   the   syslog   (default   is
              off/disabled).

       -t <filter>
              Filter  string (regex) to compare with the filename or directory
              name.

       -x <exception file or directory>
              Specify the file or directory which should not be watched.

       -X <regex string as exception>
              Specify a regex string as exception.

USAGE EXAMPLES

       % iwatch /tmp
              Monitor changes in /tmp directory with default events.

       % iwatch -r -e access,create -m root@localhost -x /etc/mail /etc
              Monitor  only  access  and  create  events  in  /etc   directory
              recursively   with   /etc/mail   as  exception  and  send  email
              notification to cahya@localhost.

       % iwatch -r -c (w;ps -ef)|mail -s%f was changedroot@localhost /bin
              Monitor /bin directory recursively and execute the command.

       % iwatch -r -X.svn~/projects
              Monitor ~/projects directory recursively, but exclude  any  .svn
              directories inside. This can’t be done with a normal ’-x’ option
              since ’-x’ can only exclude the defined path.

AUTHOR

       iwatch was written by Cahya Wirawan <cahya@gmx.at>.

       This manual page was written by Michael  Prokop  <mika@debian.org>  for
       the Debian project (but may be used by others).