1incrond(8) incron documentation incrond(8)
2
3
4
6 incrond - inotify cron (incron) daemon
7
8
10 incrond [ -f file ] [ -n | -k ]
11
13 The inotify cron daemon (incrond) is a daemon which monitors filesystem
14 events and executes commands defined in system and user tables. It's
15 use is generally similar to cron(8).
16
17 incrond can be started from /etc/rc, /etc/rc.local and so on. It daemo‐
18 nizes itself (returns immediately) and doesn't need to be started with
19 & and through nohup(1). It can be run on foreground too.
20
21 incrond uses two categories of tables incrontab(5). System tables are
22 usually located in /etc/incron.d and are maintained outside of incron
23 (e.g. by various applications). These tables work on root rights level
24 and thus any file may be watched and commands are executed with root
25 privileges.
26
27 User tables are located in /var/spool/incron by default and have names
28 based on user accounts. These tables use users' access rights, thus
29 only files which the user may access are watched. Commands are executed
30 with users' privileges.
31
32 If a table (incrontab) is changed incrond reacts immediately and
33 reloads the table. Currently running child processes (commands) are not
34 affected.
35
36 There are two files determining whether an user is allowed to use
37 incron. These files have very simple syntax - one user name per line.
38 If /etc/incron.allow exists the user must be noted there to be allowed
39 to use incron. Otherwise if /etc/incron.deny exists the user must not
40 be noted there to use incron. If none of these files exists there is no
41 other restriction whether anybody may use incron. Location of these
42 files can be changed in the configuration.
43
44 The daemon itself is currently not protected against looping. If a com‐
45 mand executed due to an event causes the same event it leads to an
46 infinite loop unless a flag mask containing loopable=true is specified.
47 Please beware of this and do not allow permission for use incron to
48 unreliable users.
49
50
51 -n (or --foreground) option causes running on foreground. This is use‐
52 ful especially for testing, debugging and optimization.
53
54 -k (or --kill) option terminates a running instance of incrond.
55
56 -f <FILE> (or --config=<FILE>) option specifies another location for
57 the configuration file (/etc/incron.conf is used by default).
58
59 Environment variables: For system tables, the default (the same as for
60 incrond itself) environment variable set is used. The same applies to
61 root's table. For non-root user tables, the whole environment is
62 cleared and then only these variables are set: LOGNAME, USER, USERNAME,
63 SHELL, HOME and PATH. The variables (except PATH) take values from the
64 user database (e.g. /etc/passwd). The PATH variable is set to
65 /usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin.
66
68 incrontab(1), incrontab(5), incron.conf(5)
69
71 incrond is currently not resistent against looping.
72
74 Andreas Altair Redmer <altair.ibn.la.ahad.sy@gmail.com> (please report
75 bugs to https://github.com/ar-/incron/issues ). Lukas Jelinek
76 <lukas@aiken.cz>.
77
79 This program is free software. It can be used, redistributed and/or
80 modified under the terms of the GNU General Public License, version 2.
81
82
83
84Lukas Jelinek 0.5.12 incrond(8)