1incrontab(1) incron documentation incrontab(1)
2
3
4
6 incrontab - table manipulator for inotify cron (incron)
7
9 incrontab [-u user] [-f config] file
10
11 incrontab [-u user] [-f config] [-l | -r | -e | -t | -d]
12
14 incrontab is a table manipulator for the inotify cron (incron) system.
15 It creates, removes, modifies and lists user tables (incrontab(5)).
16
17 Each user (including even system users without home directories) has an
18 incron table which can't be manipulated directly (only root can effec‐
19 tively change these tables and is NOT recommended to do so).
20
21 All informational messages of this program are printed to the standard
22 error output (stderr).
23
24 If /etc/incron.allow exists only users listed here may use incron. Oth‐
25 erwise if /etc/incron.deny exists only users NOT listed here may use
26 incron. If none of these files exists everyone is allowed to use
27 incron. (Important note: This behavior is insecure and will be probably
28 changed to be compatible with the style used by ISC Cron.) Location of
29 these files can be changed in the configuration.
30
31 The first form of this command imports a file, validates it and stores
32 to the table. "-" can be used for loading from the standard input.
33
34
35
36 -u (or --user) option overrides the current (real) user to the given
37 one. This option is intended for manipulation with system users' tables
38 (such as apache, postfix, daemon etc.). It can be used only if the cur‐
39 rent user has root's effective rights.
40
41 -l (or --list) option causes the current table is printed to the stan‐
42 dard output.
43
44 -r (or --remove) option causes the current table (if any) is perma‐
45 nently remove without any warning or confirmation. Use with caution!
46
47 -e (or --edit) option causes executing an editor for editing the user
48 table (see below for the information about editor selection). You can
49 edit your incron table now. If the table is changed it stores the modi‐
50 fied version.
51
52 -t (or --types) option causes the list of supported event types (delim‐
53 ited by commas) is printed to the standard output. This feature is
54 intended for front-end applications to find out which event types was
55 compiled in.
56
57 -d (or --reload) option causes reloading the current table by
58 incrond(8). It is done through "touching" the table (writing into it
59 without modifying it). This feature is intended e.g. for creating
60 watches on newly created files (with already existing rules) or for
61 rearming IN_ONESHOT watches.
62
63 -f <FILE> (or --config=<FILE>) option specifies another location for
64 the configuration file (/etc/incron.conf is used by default). This fea‐
65 ture requires root privileges.
66
67 There is a few complex algorithm how to determine which editor will be
68 user for editing. If any of the following rule succeeds the appropriate
69 editor is used:
70
71 1. EDITOR environment variable
72
73 2. VISUAL environment variable
74
75 3. configuration value
76
77 4. etc/alternatives/editor
78
79 5. hard-wired editor (vim by default)
80
81 It's not recommended to use graphical editors (such as gVim, KEdit
82 etc.) due to possible problems with connecting to the X server.
83
85 incrond(8), incrontab(5), incron.conf(5)
86
88 Andreas Altair Redmer <altair.ibn.la.ahad.sy@gmail.com> (please report
89 bugs to https://github.com/ar-/incron/issues ). Lukas Jelinek
90 <lukas@aiken.cz> .
91
93 This program is free software. It can be used, redistributed and/or
94 modified under the terms of the GNU General Public License, version 2.
95
96
97
98Lukas Jelinek 0.5.12 incrontab(1)