summaryrefslogtreecommitdiff
path: root/inotail.1
blob: 21cf3a7489ddce16bdfe6d27329c4de7d085a8d5 (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
'\" t
.\" ** The above line should force tbl to be a preprocessor **
.\" Man page for inotail
.\"
.\" Copyright (c) 2006-2009 Tobias Klauser <tklauser@distanz.ch>
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file COPYING that comes with
.\" inotail.

.pc
.TH INOTAIL 1 "2009-01-25" "" "Inotify enhanced tail"
.SH NAME
inotail \- A fast and lightweight version of tail using inotify
.SH SYNOPSIS
.B inotail
[OPTION]... [FILE]...
.SH DESCRIPTION
.B 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. \fINote:\fR inotail will not work
on systems running a kernel without inotify. To enable inotify, please set
CONFIG_INOTIFY=y in your Linux kernel configuration and recompile it.
.PP
Currently inotail is not fully compatible to neither POSIX or GNU tail but might
be in the future.
.SH OPTIONS
.TP
.B \-c \fIN\fR, \fB\-\-bytes\fR=\fIN
output the last N bytes. If the first character of N is a '+', begin printing
with the Nth character from the start of each file.
.TP
.B \-f\fR, \fB\-\-follow
keep the file(s) open and print appended data as the file grows
.TP
.B \-n \fIN\fR, \fB\-\-lines\fR=\fIN
output the last N lines (default: 10) If the first character of N is a '+',
begin printing with the Nth line from the start of each file.
.TP
.B \-q\fR, \fB\-\-quiet\fR, \fB\-\-silent
never print headers with file names
.TP
.B \-v\fR, \fB\-\-verbose
alway print headers with file names
.TP
.B \-h\fR, \fB\-\-help
show help and exit
.TP
.B \-V\fR, \fB\-\-version
show inotail version and exit
.SH AUTHOR
.PP
Written by Tobias Klauser
<tklauser@distanz.ch>
.SH SEE ALSO
.PP
.BR tail(1),
.BR head(1),
.BR inotify(7)