incrond(8)						       incron documentation							incrond(8)

NAME

       incrond - inotify cron (incron) daemon

SYNOPSIS

       incrond [ -f file ] [ -n | -k ]

DESCRIPTION

       The  inotify  cron  daemon  (incrond) is a daemon which monitors filesystem events and executes commands defined in system and user tables.
       It's use is generally similar to cron(8).

       incrond can be started from /etc/rc, /etc/rc.local and so on. It daemonizes itself (returns immediately) and doesn't  need  to  be  started
       with & and through nohup(1). It can be run on foreground too.

       incrond uses two categories of tables incrontab(5). System tables are usually located in /etc/incron.d and are maintained outside of incron
       (e.g. by various applications). These tables work on root rights level and thus any file may be watched and commands are executed with root
       privileges.

       User  tables are located in /var/spool/incron by default and have names based on user accounts. These tables use users' access rights, thus
       only files which the user may access are watched. Commands are executed with users' privileges.

       If a table (incrontab) is changed incrond reacts immediately and reloads the table. Currently running child processes  (commands)  are  not
       affected.

       There  are two files determining whether an user is allowed to use incron. These files have very simple syntax - one user name per line. If
       /etc/incron.allow exists the user must be noted there to be allowed to use incron. Otherwise if /etc/incron.deny exists the user  must  not
       be noted there to use incron. If none of these files exists there is no other restriction whether anybody may use incron. Location of these
       files can be changed in the configuration.

       The daemon itself is currently not protected against looping. If a command executed due to an event causes the same event it  leads  to	an
       infinite  loop  unless  a flag mask containing IN_NO_LOOP is specified. Please beware of this and do not allow permission for use incron to
       unreliable users.

       -n (or --foreground) option causes running on foreground. This is useful especially for testing, debugging and optimization.

       -k (or --kill) option terminates a running instance of incrond.

       -f <FILE> (or --config=<FILE>) option specifies another location for the configuration file (/etc/incron.conf is used by default).

       Environment variables: For system tables, the default (the same as for incrond itself) environment variable set is used. The  same  applies
       to root's table. For non-root user tables, the whole environment is cleared and then only these variables are set: LOGNAME, USER, USERNAME,
       SHELL, HOME and PATH. The variables (except PATH) take values from the user database (e.g.  /etc/passwd).  The  PATH  variable  is  set	to
       /usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin.

SEE ALSO

       incrontab(1), incrontab(5), incron.conf(5)

BUGS

       incrond is currently not resistent against looping. Recursive monitoring (whole subtrees) has not been implemented yet.

AUTHOR

       Lukas Jelinek <lukas@aiken.cz> (please report bugs to http://bts.aiken.cz or <bugs@aiken.cz>).

COPYING

       This program is free software. It can be used, redistributed and/or modified under the terms of the GNU General Public License, version 2.

Lukas Jelinek							      0.5.10								incrond(8)