Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

iwatch(1) [debian man page]

IWATCH(1)						      General Commands Manual							 IWATCH(1)

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 changed' root@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).

																	 IWATCH(1)

Check Out this Related Man Page

HALEVT(1)						      General Commands Manual							 HALEVT(1)

NAME

       halevt - Generic handler for HAL events

SYNOPSIS

       halevt [options]

DESCRIPTION

       Halevt is a daemon that executes arbitrary commands when a device with certain properties is added to the system and when device properties
       change, using HAL.  Unless a configuration file is given on the command line with the -c option, configuration files are  searched  for	in
       $HOME/.halevt, /etc/halevt, and /usr/share/halevt (in that order). All the files ending with .xml found in these directories are considered
       to be configuration files. If a file with the same name has already been found in a previous directory, it is ignored. Default  for  halevt
       is to run as a daemon in the background.

       Halevt  may also be run in another mode, called the reporting mode, turned on by the -i option. In that case no config file is read, Halevt
       stays in the foreground and report all the HAL events.

OPTIONS

       -c file
	      Use configuration file file.

       -d     Give debugging informations and stay in the foreground.

       -f     Stay in the foreground.

       -g group
	      Run as group group, if started by the root user. Default is to run as halevt.

       -h     Help message and options summary.

       -i     Run in reporting mode. No configuration file is read, and halevt stays in the foreground, reporting all the HAL events.

       -p pidfile
	      Use pid file pidfile to store the daemon pid, instead of the default.  Default is /var/run/halevt.pid if run as root  user,  and	no
	      pid file if run as a user. - means no pidfile.

       -u user
	      Run as user user, if started by the root user. Default is to run as halevt.

SEE ALSO

       lshal(1), hald(8)

VERSION

       This is Halevt version 0.1.6.2.

AUTHOR

       Main author is Patrice Dumas pertusus at free dot fr.

AVAILABILITY

       The latest version of this program can be found at:
	     http://www.nongnu.org/halevt/

COPYRIGHT

       Copyright (C) 2007-2008	Patrice Dumas <pertusus at free dot fr>,
	      2005 Novell, Inc.

       There  is  NO  warranty.   You  may  redistribute  this software under the terms of the GNU General Public License; either version 2 of the
       License, or (at your option) any later version.	For more information about these matters, see the file named COPYING.

																	 HALEVT(1)
Man Page