'\" t
.\" ** The above line should force tbl to be a preprocessor **
.\" Man page for inotail
.\"
.\" Copyright (c) 2006 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 "2006-08-13" "" "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\fR
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, \fB\-\-follow
keep the file(s) open and print appended data as the file grows
.TP
.B \-n \fIN\fR, \fB\-\-lines\fR=\fIN\fR
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 \-v, \fB\-\-verbose
print headers with file names
.TP
.B \-h, \fB\-\-help
show help and exit
.TP
.B \-V, \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 inotify(7)
 href='/cgit.cgi/linux/net-next.git/diff/?id=7329a655875a2f4bd6984fe8a7e00a6981e802f3'>diff</a></td><td class='form'><form class='right' method='get' action='/cgit.cgi/linux/net-next.git/log/'>
<input type='hidden' name='id' value='7329a655875a2f4bd6984fe8a7e00a6981e802f3'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='content'><div class='cgit-panel'><b>diff options</b><form method='get'><input type='hidden' name='id' value='7329a655875a2f4bd6984fe8a7e00a6981e802f3'/><table><tr><td colspan='2'/></tr><tr><td class='label'>context:</td><td class='ctrl'><select name='context' onchange='this.form.submit();'><option value='1'>1</option><option value='2'>2</option><option value='3' selected='selected'>3</option><option value='4'>4</option><option value='5'>5</option><option value='6'>6</option><option value='7'>7</option><option value='8'>8</option><option value='9'>9</option><option value='10'>10</option><option value='15'>15</option><option value='20'>20</option><option value='25'>25</option><option value='30'>30</option><option value='35'>35</option><option value='40'>40</option></select></td></tr><tr><td class='label'>space:</td><td class='ctrl'><select name='ignorews' onchange='this.form.submit();'><option value='0' selected='selected'>include</option><option value='1'>ignore</option></select></td></tr><tr><td class='label'>mode:</td><td class='ctrl'><select name='dt' onchange='this.form.submit();'><option value='0' selected='selected'>unified</option><option value='1'>ssdiff</option><option value='2'>stat only</option></select></td></tr><tr><td/><td class='ctrl'><noscript><input type='submit' value='reload'/></noscript></td></tr></table></form></div><table summary='commit info' class='commit-info'>
<tr><th>author</th><td>Eric Biggers &lt;ebiggers@google.com&gt;</td><td class='right'>2016-08-19 12:15:22 -0700</td></tr>
<tr><th>committer</th><td>Kees Cook &lt;keescook@chromium.org&gt;</td><td class='right'>2016-08-22 19:07:55 -0700</td></tr>
<tr><th>commit</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/commit/?id=7329a655875a2f4bd6984fe8a7e00a6981e802f3'>7329a655875a2f4bd6984fe8a7e00a6981e802f3</a> (<a href='/cgit.cgi/linux/net-next.git/patch/?id=7329a655875a2f4bd6984fe8a7e00a6981e802f3'>patch</a>)</td></tr>
<tr><th>tree</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/tree/?id=7329a655875a2f4bd6984fe8a7e00a6981e802f3'>5c77614be62600da9d02d3b57709280e91e7292d</a></td></tr>
<tr><th>parent</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/commit/?id=ef0e1ea8856bed6ff8394d3dfe77f2cab487ecea'>ef0e1ea8856bed6ff8394d3dfe77f2cab487ecea</a> (<a href='/cgit.cgi/linux/net-next.git/diff/?id=7329a655875a2f4bd6984fe8a7e00a6981e802f3&amp;id2=ef0e1ea8856bed6ff8394d3dfe77f2cab487ecea'>diff</a>)</td></tr></table>
<div class='commit-subject'>usercopy: avoid potentially undefined behavior in pointer math</div><div class='commit-msg'>check_bogus_address() checked for pointer overflow using this expression,
where 'ptr' has type 'const void *':

	ptr + n &lt; ptr

Since pointer wraparound is undefined behavior, gcc at -O2 by default
treats it like the following, which would not behave as intended:

	(long)n &lt; 0

Fortunately, this doesn't currently happen for kernel code because kernel
code is compiled with -fno-strict-overflow.  But the expression should be
fixed anyway to use well-defined integer arithmetic, since it could be
treated differently by different compilers in the future or could be
reported by tools checking for undefined behavior.

Signed-off-by: Eric Biggers &lt;ebiggers@google.com&gt;
Signed-off-by: Kees Cook &lt;keescook@chromium.org&gt;
</div><div class='diffstat-header'><a href='/cgit.cgi/linux/net-next.git/diff/?id=7329a655875a2f4bd6984fe8a7e00a6981e802f3'>Diffstat</a></div><table summary='diffstat' class='diffstat'>