summaryrefslogtreecommitdiff
path: root/README
blob: 58a209116e59d4b400ac43afb52cb176bf700936 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 inotail - inotify enhanced tail
o===============================o

inotail is a replacement for the 'tail' program found in the base installation
of every Linux/UNIX system. It makes use of the inotify infrastructure in recent
versions of the Linux kernel to speed up tailing files in the follow mode (the
'-f' option). Standard tail polls the file every second by default while inotail
listens to special events sent by the kernel through the inotify API to
determine whether a file needs to be reread.

inotail is compatible to POSIX and GNU tail. See section "Compatibility &
options" for more information.

Requirements
------------
- Linux kernel 2.6.13 or higher with CONFIG_INOTIFY enabled
- Standard C Library (tested with GNU libc but might work with others too)
- GCC (other compilers might work but are not tested)

Building and installing inotail
-------------------------------
To build inotail type:

	$ make

By default, inotail is installed to /usr/local/bin/, the manpage is installed to
/usr/local/share/man/man1/. To install the inotail files to these locations type:

	$ make install

To change these locations just set the prefix variable. E.g. to install the
inotail binary to /usr/ and the manpage to /usr/share/man/ respectively type:

	$ make prefix=/usr install

Compatibility & options
-----------------------
inotail is fully compatible with current POSIX and GNU tail, though the
obsolescent options present in previous versions of those are not present (e.g.
inotail +/-<num>). The following options are present in inotail for
compatibility reasons (e.g. to use inotail as a tail replacement in scripts) but
do have no effect on inotail besides emiting a warning:

-s N, --sleep-interval=N  inotail does not need a sleep interval because it's
			  relying on inotify.

--max-unchanged-stats=N   inotail watches the containing directory of the file
                          when following by name (--follow=name or -F). Thus it
                          gets notified when a file gets moved or deleted.

--pid=PID                 Watching the writer PID ios not possible, because
                          inotail blocks on the read() call on the inotify fd.
			  In the worst case, the dying process wouldn't cause an
			  inotify event, so inotail would never get back from
			  the read().

These options are neither documented in the manpage nor the in-program help.

License
-------
inotail is licensed under the terms of the GNU General Public License version 2
or later. You can find the full text in the file LICENSE in the source tree of
inotail.

-- Tobias Klauser <tklauser@distanz.ch>