Subversion Repositories public

Rev

Rev 65 | Rev 69 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 65 Rev 67
Line 1... Line 1...
1
.TH "incrond" "8" "0.3.5" "Lukas Jelinek" "incron documentation"
1
.TH "incrond" "8" "0.4.0" "Lukas Jelinek" "incron documentation"
2
.SH "NAME"
2
.SH "NAME"
3
incrond \- inotify cron (incron) daemon
3
incrond \- inotify cron (incron) daemon
4
4
5
.SH "SYNOPSIS"
5
.SH "SYNOPSIS"
6
\fBincrond\fR
6
\fBincrond\fR [ \fB\-n\fR | \fB\-k\fR ]
7
.SH "DESCRIPTION"
7
.SH "DESCRIPTION"
8
The inotify cron daemon (\fIincrond\fR) is a daemon which monitors filesystem events and executes commands defined in user tables. It's use is generally similar to \fIcron\fR(8).
8
The inotify cron daemon (\fIincrond\fR) is a daemon which monitors filesystem events and executes commands defined in system and user tables. It's use is generally similar to \fIcron\fR(8).
9
9
10
\fIincrond\fR 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 \fInohup\fR(1). Running on foreground is currently not possible but it will be implemented in the future.
10
\fIincrond\fR 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 \fInohup\fR(1). It can be run on foreground too.
11
11
12
\fIincrond\fR searches /var/spool/incron for \fIincrontab\fR(5) files named after user accounts. If a table (incrontab) is changed \fIincrond\fR reacts immediately and reloads the table. Currently running subprocesses (commands) are not affected.
12
\fIincrond\fR uses two categories of tables \fIincrontab\fR(5). System tables are 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.
-
 
13
-
 
14
User tables are located in /var/spool/incron 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.
-
 
15
-
 
16
If a table (incrontab) is changed \fIincrond\fR reacts immediately and reloads the table. Currently running child processes (commands) are not affected.
13
17
14
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.
18
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.
15
19
16
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.
20
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.
-
 
21
-
 
22
-
 
23
\fB\-n\fR (or \fB\-\-foreground\fR) option causes running on foreground. This is useful especially for testing, debugging and optimization.
-
 
24
-
 
25
\fB\-k\fR (or \fB\-\-kill\fR) option terminates all running instances of \fBincrond\fR. It takes effect only on instances of the same executable (using the same file).
17
.SH "SEE ALSO"
26
.SH "SEE ALSO"
18
incrontab(1), incrontab(5)
27
incrontab(1), incrontab(5)
19
.SH "BUGS"
28
.SH "BUGS"
20
incrond is currently not resistent against looping.
29
incrond is currently not resistent against looping. Recursive monitoring (whole subtrees) has not been implemented yet.
21
.SH "AUTHOR"
30
.SH "AUTHOR"
22
Lukas Jelinek <lukas@aiken.cz>
31
Lukas Jelinek <lukas@aiken.cz>
23
.SH "COPYING"
32
.SH "COPYING"
24
This program is free software. It can be used, redistributed and/or modified under the terms of the GNU General Public License, version 2.
33
This program is free software. It can be used, redistributed and/or modified under the terms of the GNU General Public License, version 2.