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>
1-1/+1 2011-06-15mm/memory_hotplug.c: fix building of node hotplug zonelistKAMEZAWA Hiroyuki1-0/+6 2011-05-25mm: remove dependency on CONFIG_FLATMEM from online_page()Daniel Kiper1-4/+0 2011-05-25mem-hotplug: call isolate_lru_page with elevated refcountKonstantin Khlebnikov1-1/+3 2011-05-25mm, mem-hotplug: recalculate lowmem_reserve when memory hotplug occursKOSAKI Motohiro1-4/+5 2011-05-25mm, mem-hotplug: fix section mismatch. setup_per_zone_inactive_ratio() should...KOSAKI Motohiro1-2/+2 2011-04-14mm: optimize pfn calculation in online_page()Daniel Kiper1-1/+1 2011-03-31Fix common misspellingsLucas De Marchi1-1/+1 2011-01-15Merge branch 'slub/hotplug' into slab/urgentPekka Enberg1-0/+4 2011-01-13thp: remove PG_buddyAndrea Arcangeli1-6/+8 2011-01-13mm: migration: cleanup migrate_pages API by matching types for offlining and ...Mel Gorman1-1/+1 2011-01-13mm: migration: allow migration to operate asynchronously and avoid synchronou...Mel Gorman1-1/+2 2011-01-11memory hotplug: one more lock on memory hotplugKAMEZAWA Hiroyuki1-0/+4 2010-12-02mem-hotplug: introduce {un}lock_memory_hotplug()KOSAKI Motohiro1-7/+24 2010-10-26mm: do_migrate_range: reduce list_empty() checkBob Liu1-12/+9 2010-10-26mm: do_migrate_range: exit loop if not_managed is trueBob Liu1-4/+6 2010-10-26mm/memory_hotplug.c: make scan_lru_pages() staticAndrew Morton1-1/+1 2010-10-26memory hotplug: unify is_removable and offline detection codeKAMEZAWA Hiroyuki1-15/+2 2010-10-26mm: compaction: fix COMPACTPAGEFAILED countingMinchan Kim1-0/+2 2010-10-26mm: fix return value of scan_lru_pages in memory unplugKAMEZAWA Hiroyuki1-1/+1 2010-10-19memory_hotplug: drop spurious calls to flush_scheduled_work()Tejun Heo1-2/+0 2010-09-09memory hotplug: fix next block calculation in is_removableKAMEZAWA Hiroyuki1-8/+8 2010-05-25mem-hotplug: fix potential race while building zonelist for new populated zoneHaicheng Li1-8/+3 2010-05-25mem-hotplug: avoid multiple zones sharing same boot strapping boot_pagesetHaicheng Li1-5/+13 2010-05-25cpu/mem hotplug: enable CPUs online before local memory onlineminskey guo1-0/+23 2010-03-12mm: introduce dump_page() and print symbolic flag namesWu Fengguang1-3/+3 2010-03-06memory-hotplug: create /sys/firmware/memmap entry for new memoryakpm@linux-foundation.org1-0/+4 2009-12-15mm: fix section mismatch in memory_hotplug.cRakib Mullick1-1/+3 2009-12-15mm: memory_hotplug: make offline_pages() staticAndrew Morton1-1/+1 2009-12-15ksm: memory hotremove migration onlyHugh Dickins1-1/+1 2009-12-15mm: clear node in N_HIGH_MEMORY and stop kswapd when all memory is offlinedDavid Rientjes1-0/+4 2009-12-15mm: move inc_zone_page_state(NR_ISOLATED) to just isolated placeKOSAKI Motohiro1-0/+4 2009-11-17mm: allow memory hotplug and hibernation in the same kernelAndi Kleen1-4/+17 2009-11-17mm/memory_hotplug: fix section mismatchHidetoshi Seto1-1/+2 2009-09-23walk system ram rangeKAMEZAWA Hiroyuki1-3/+3 2009-09-22memory hotplug: fix updating of num_physpages for hot plugged memoryJan Beulich1-2/+4 2009-09-22memory hotplug: update zone pcp at memory onlineShaohua Li1-0/+1 2009-06-16page-allocator: reset wmark_min and inactive ratio of zone when hotplug happensMinchan Kim1-0/+4 2009-06-16page-allocator: clean up functions related to pages_minMinchan Kim1-1/+1