diff options
Diffstat (limited to 'man/tail.1')
-rw-r--r-- | man/tail.1 | 97 |
1 files changed, 97 insertions, 0 deletions
diff --git a/man/tail.1 b/man/tail.1 new file mode 100644 index 0000000..7e5074b --- /dev/null +++ b/man/tail.1 @@ -0,0 +1,97 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35. +.TH TAIL "1" "March 2007" "GNU coreutils 6.9" "User Commands" +.SH NAME +tail \- output the last part of files +.SH SYNOPSIS +.B tail +[\fIOPTION\fR]... [\fIFILE\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the last 10 lines of each FILE to standard output. +With more than one FILE, precede each with a header giving the file name. +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-retry\fR +keep trying to open a file even if it is +inaccessible when tail starts or if it becomes +inaccessible later; useful when following by name, +i.e., with \fB\-\-follow\fR=\fIname\fR +.TP +\fB\-c\fR, \fB\-\-bytes\fR=\fIN\fR +output the last N bytes; alternatively, use +N to +output bytes starting with the Nth of each file +.TP +\fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}] +output appended data as the file grows; +\fB\-f\fR, \fB\-\-follow\fR, and \fB\-\-follow\fR=\fIdescriptor\fR are +equivalent +.TP +\fB\-F\fR +same as \fB\-\-follow\fR=\fIname\fR \fB\-\-retry\fR +.TP +\fB\-n\fR, \fB\-\-lines\fR=\fIN\fR +output the last N lines, instead of the last 10; +or use +N to output lines starting with the Nth +.TP +\fB\-\-max\-unchanged\-stats\fR=\fIN\fR +with \fB\-\-follow\fR=\fIname\fR, reopen a FILE which has not +changed size after N (default 5) iterations +to see if it has been unlinked or renamed +(this is the usual case of rotated log files) +.TP +\fB\-\-pid\fR=\fIPID\fR +with \fB\-f\fR, terminate after process ID, PID dies +.TP +\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR +never output headers giving file names +.TP +\fB\-s\fR, \fB\-\-sleep\-interval\fR=\fIS\fR +with \fB\-f\fR, sleep for approximately S seconds +(default 1.0) between iterations. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +always output headers giving file names +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If the first character of N (the number of bytes or lines) is a `+', +print beginning with the Nth item from the start of each file, otherwise, +print the last N items in the file. N may have a multiplier suffix: +b 512, k 1024, m 1024*1024. +.PP +With \fB\-\-follow\fR (\fB\-f\fR), tail defaults to following the file descriptor, which +means that even if a tail'ed file is renamed, tail will continue to track +its end. This default behavior is not desirable when you really want to +track the actual name of the file, not the file descriptor (e.g., log +rotation). Use \fB\-\-follow\fR=\fIname\fR in that case. That causes tail to track the +named file by reopening it periodically to see if it has been removed and +recreated by some other program. +.SH AUTHOR +Written by Paul Rubin, David MacKenzie, Ian Lance Taylor, and Jim Meyering. +.SH "REPORTING BUGS" +Report bugs to <bug\-coreutils@gnu.org>. +.SH COPYRIGHT +Copyright \(co 2007 Free Software Foundation, Inc. +.br +This is free software. You may redistribute copies of it under the terms of +the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +The full documentation for +.B tail +is maintained as a Texinfo manual. If the +.B info +and +.B tail +programs are properly installed at your site, the command +.IP +.B info tail +.PP +should give you access to the complete manual. |