Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 usu-
     ally located in /usr/local/etc/incron.d and are maintained outside  of  in-
     cron (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 privi-
     leges.

     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	/usr/lo-
     cal/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  re-
     striction	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 loopable=true 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 (/usr/local/etc/incron.conf is used by default).

     Environment variables: For system tables, the default (the same as for  in-
     crond  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/lo-
     cal/bin:/usr/bin:/bin:/usr/X11R6/bin.

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

BUGS
     incrond is currently not resistent against looping.

AUTHOR
     Andreas Altair Redmer <altair.ibn.la.ahad.sy@gmail.com> (please report bugs
     to https://github.com/ar-/incron/issues ).  Lukas Jelinek <lukas@aiken.cz>.

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

Lukas Jelinek			     0.5.12			      incrond(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=incrond&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help