original/man1/tail.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH TAIL "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 tail \- output the last part of files
   5 .SH SYNOPSIS
   6 .B tail
   7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Print the last 10 lines of each FILE to standard output.
  12 With more than one FILE, precede each with a header giving the file name.
  13 .PP
  14 With no FILE, or when FILE is \-, read standard input.
  15 .PP
  16 Mandatory arguments to long options are mandatory for short options too.
  17 .TP
  18 \fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM
  19 output the last NUM bytes; or use \fB\-c\fR +NUM to
  20 output starting with byte NUM of each file
  21 .TP
  22 \fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}]
  23 output appended data as the file grows;
  24 .IP
  25 an absent option argument means 'descriptor'
  26 .TP
  27 \fB\-F\fR
  28 same as \fB\-\-follow\fR=\fI\,name\/\fR \fB\-\-retry\fR
  29 .TP
  30 \fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM
  31 output the last NUM lines, instead of the last 10;
  32 or use \fB\-n\fR +NUM to output starting with line NUM
  33 .TP
  34 \fB\-\-max\-unchanged\-stats\fR=\fI\,N\/\fR
  35 with \fB\-\-follow\fR=\fI\,name\/\fR, reopen a FILE which has not
  36 .IP
  37 changed size after N (default 5) iterations
  38 to see if it has been unlinked or renamed
  39 (this is the usual case of rotated log files);
  40 with inotify, this option is rarely useful
  41 .TP
  42 \fB\-\-pid\fR=\fI\,PID\/\fR
  43 with \fB\-f\fR, terminate after process ID, PID dies
  44 .TP
  45 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
  46 never output headers giving file names
  47 .TP
  48 \fB\-\-retry\fR
  49 keep trying to open a file if it is inaccessible
  50 .TP
  51 \fB\-s\fR, \fB\-\-sleep\-interval\fR=\fI\,N\/\fR
  52 with \fB\-f\fR, sleep for approximately N seconds
  53 (default 1.0) between iterations;
  54 with inotify and \fB\-\-pid\fR=\fI\,P\/\fR, check process P at
  55 least once every N seconds
  56 .TP
  57 \fB\-v\fR, \fB\-\-verbose\fR
  58 always output headers giving file names
  59 .TP
  60 \fB\-z\fR, \fB\-\-zero\-terminated\fR
  61 line delimiter is NUL, not newline
  62 .TP
  63 \fB\-\-help\fR
  64 display this help and exit
  65 .TP
  66 \fB\-\-version\fR
  67 output version information and exit
  68 .PP
  69 NUM may have a multiplier suffix:
  70 b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
  71 GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y.
  72 .PP
  73 With \fB\-\-follow\fR (\fB\-f\fR), tail defaults to following the file descriptor, which
  74 means that even if a tail'ed file is renamed, tail will continue to track
  75 its end.  This default behavior is not desirable when you really want to
  76 track the actual name of the file, not the file descriptor (e.g., log
  77 rotation).  Use \fB\-\-follow\fR=\fI\,name\/\fR in that case.  That causes tail to track the
  78 named file in a way that accommodates renaming, removal and creation.
  79 .SH AUTHOR
  80 Written by Paul Rubin, David MacKenzie, Ian Lance Taylor,
  81 and Jim Meyering.
  82 .SH "REPORTING BUGS"
  83 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  84 .br
  85 Report tail translation bugs to <http://translationproject.org/team/>
  86 .SH COPYRIGHT
  87 Copyright \(co 2016 Free Software Foundation, Inc.
  88 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  89 .br
  90 This is free software: you are free to change and redistribute it.
  91 There is NO WARRANTY, to the extent permitted by law.
  92 .SH "SEE ALSO"
  93 head(1)
  94 .PP
  95 .br
  96 Full documentation at: <http://www.gnu.org/software/coreutils/tail>
  97 .br
  98 or available locally via: info \(aq(coreutils) tail invocation\(aq