Subversion Repositories public

Rev

Rev 73 | Rev 77 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 73 Rev 75
Line 1... Line 1...
1
.TH "incrontab" "1" "0.5.2" "Lukas Jelinek" "incron documentation"
1
.TH "incrontab" "1" "0.5.3" "Lukas Jelinek" "incron documentation"
2
.SH "NAME"
2
.SH "NAME"
3
incrontab \- table manipulator for inotify cron (incron)
3
incrontab \- table manipulator for inotify cron (incron)
4
.SH "SYNOPSIS"
4
.SH "SYNOPSIS"
5
\fBincrontab\fR [\fB\-u\fR \fIuser\fR] [\fB\-f\fR \fIconfig\fR] \fIfile\fR
5
\fBincrontab\fR [\fB\-u\fR \fIuser\fR] [\fB\-f\fR \fIconfig\fR] \fIfile\fR
6
6
Line 10... Line 10...
10
10
11
Each user (including system users even they haven't home directories) has an incron table which can't be manipulated directly (only root can effectively change these tables and is NOT recommended to do so).
11
Each user (including system users even they haven't home directories) has an incron table which can't be manipulated directly (only root can effectively change these tables and is NOT recommended to do so).
12
12
13
All informational messages of this program are printed to the standard error output (stderr).
13
All informational messages of this program are printed to the standard error output (stderr).
14
14
15
If \fI/etc/incron.allow\fR exists only users listed here may use incron. Otherwise if \fI/etc/incron.deny\fR exists only users NOT listed here may use incron. If none of these files exists everyone is allowed to use incron. (\fBImportant note:\fR This behavior is insecure and will be probably changed to be compatible with the style used by ISC Cron.) Location of this files can be changed in the configuration.
15
If \fI/etc/incron.allow\fR exists only users listed here may use incron. Otherwise if \fI/etc/incron.deny\fR exists only users NOT listed here may use incron. If none of these files exists everyone is allowed to use incron. (\fBImportant note:\fR This behavior is insecure and will be probably changed to be compatible with the style used by ISC Cron.) Location of these files can be changed in the configuration.
16
16
17
The first form of this command imports a file, validates it and stores to the table. "\-" can be used for loading from the standard input.
17
The first form of this command imports a file, validates it and stores to the table. "\-" can be used for loading from the standard input.
18
18
19
19
20
20
Line 26... Line 26...
26
26
27
\fB\-e\fR (or \fB\-\-edit\fR) option causes executing an editor for editting the user table (see below for the information about editor selection). You can edit your incron table now. If the table is changed it stores the modified version.
27
\fB\-e\fR (or \fB\-\-edit\fR) option causes executing an editor for editting the user table (see below for the information about editor selection). You can edit your incron table now. If the table is changed it stores the modified version.
28
28
29
\fB\-t\fR (or \fB\-\-types\fR) option causes the list of supported event types (delimited by commas) is printed to the standard output. This feature is intended for front\-end applications to find out which event types was compiled in.
29
\fB\-t\fR (or \fB\-\-types\fR) option causes the list of supported event types (delimited by commas) is printed to the standard output. This feature is intended for front\-end applications to find out which event types was compiled in.
30
30
-
 
31
\fB\-d\fR (or \fB\-\-reload\fR) option causes reloading the current table by \fIincrond\fR(8). It is done through "touching" the table (writing into it without modifying it). This feature is intended e.g. for creating watches on newly created files (with already existing rules) or for rearming IN_ONESHOT watches.
-
 
32
31
\fB\-f <FILE>\fR (or \fB\-\-config=<FILE>\fR) option specifies another location for the configuration file (/etc/incron.conf is used by default). This feature requires root privileges.
33
\fB\-f <FILE>\fR (or \fB\-\-config=<FILE>\fR) option specifies another location for the configuration file (/etc/incron.conf is used by default). This feature requires root privileges.
32
34
33
There is a few complex algorithm how to determine which editor will be user for editting. If any of the following rule succeeds the appropriate editor is used:
35
There is a few complex algorithm how to determine which editor will be user for editting. If any of the following rule succeeds the appropriate editor is used:
34
36
35
1. EDITOR environment variable
37
1. EDITOR environment variable
Line 42... Line 44...
42
44
43
5. hard\-wired editor (\fIvim\fR by default)
45
5. hard\-wired editor (\fIvim\fR by default)
44
46
45
It's not recommended to use graphical editors (such as gVim, KEdit etc.) due to possible problems with connecting to the X server.
47
It's not recommended to use graphical editors (such as gVim, KEdit etc.) due to possible problems with connecting to the X server.
46
.SH "SEE ALSO"
48
.SH "SEE ALSO"
47
incrond(8), incrontab(5)
49
incrond(8), incrontab(5), incron.conf(5)
48
.SH "AUTHOR"
50
.SH "AUTHOR"
49
Lukas Jelinek <lukas@aiken.cz>
51
Lukas Jelinek <lukas@aiken.cz>
50
.SH "COPYING"
52
.SH "COPYING"
51
This program is free software. It can be used, redistributed and/or modified under the terms of the GNU General Public License, version 2.
53
This program is free software. It can be used, redistributed and/or modified under the terms of the GNU General Public License, version 2.