manual/GNU_textutils/original/man1/tail.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.012.
   2 .TH TAIL "1" "August 1999" "GNU textutils 2.0" FSF
   3 .SH NAME
   4 tail \- output the last part of files
   5 .SH SYNOPSIS
   6 .B tail
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 .PP
  10 .\" Add any additional description here
  11 .PP
  12 Print the last 10 lines of each FILE to standard output.
  13 With more than one FILE, precede each with a header giving the file name.
  14 With no FILE, or when FILE is -, read standard input.
  15 .TP
  16 \fB\-\-retry\fR
  17 keep trying to open a file even if it is
  18 .IP
  19 inaccessible when tail starts or if it becomes
  20 inaccessible later \fB\-\-\fR useful only with \fB\-f\fR
  21 .TP
  22 \fB\-c\fR, \fB\-\-bytes\fR=\fIN\fR
  23 output the last N bytes
  24 .IP
  25 \fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}] output appended data as the file grows;
  26 .IP
  27 \fB\-f\fR, \fB\-\-follow\fR, and \fB\-\-follow\fR=\fIdescriptor\fR are
  28 equivalent
  29 .TP
  30 \fB\-n\fR, \fB\-\-lines\fR=\fIN\fR
  31 output the last N lines, instead of the last 10
  32 .IP
  33 \fB\-\-max\-unchanged\-stats\fR=\fIN\fR see the texinfo documentation
  34 .IP
  35 (the default is 5)
  36 .IP
  37 \fB\-\-max\-consecutive\-size\-changes\fR=\fIN\fR see the texinfo documentation
  38 .IP
  39 (the default is 200)
  40 .TP
  41 \fB\-\-pid\fR=\fIPID\fR
  42 with \fB\-f\fR, terminate after process ID, PID dies
  43 .TP
  44 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
  45 never output headers giving file names
  46 .TP
  47 \fB\-s\fR, \fB\-\-sleep\-interval\fR=\fIS\fR
  48 with \fB\-f\fR, sleep S seconds between iterations
  49 .TP
  50 \fB\-v\fR, \fB\-\-verbose\fR
  51 always output headers giving file names
  52 .TP
  53 \fB\-\-help\fR
  54 display this help and exit
  55 .TP
  56 \fB\-\-version\fR
  57 output version information and exit
  58 .PP
  59 If the first character of N (the number of bytes or lines) is a `+',
  60 print beginning with the Nth item from the start of each file, otherwise,
  61 print the last N items in the file.  N may have a multiplier suffix:
  62 b for 512, k for 1024, m for 1048576 (1 Meg).  A first OPTION of \fB\-VALUE\fR
  63 or +VALUE is treated like \fB\-n\fR VALUE or \fB\-n\fR +VALUE unless VALUE has one of
  64 the [bkm] suffix multipliers, in which case it is treated like \fB\-c\fR VALUE
  65 or \fB\-c\fR +VALUE.
  66 .PP
  67 With \fB\-\-follow\fR (-f), tail defaults to following the file descriptor, which
  68 means that even if a tail'ed file is renamed, tail will continue to track
  69 its end.  This default behavior is not desirable when you really want to
  70 track the actual name of the file, not the file descriptor (e.g., log
  71 rotation).  Use \fB\-\-follow\fR=\fIname\fR in that case.  That causes tail to track the
  72 named file by reopening it periodically to see if it has been removed and
  73 recreated by some other program.
  74 .SH "REPORTING BUGS"
  75 Report bugs to <bug-textutils@gnu.org>.
  76 .SH "SEE ALSO"
  77 The full documentation for
  78 .B tail
  79 is maintained as a Texinfo manual.  If the
  80 .B info
  81 and
  82 .B tail
  83 programs are properly installed at your site, the command
  84 .IP
  85 .B info tail
  86 .PP
  87 should give you access to the complete manual.
  88 .SH COPYRIGHT
  89 Copyright \(co 1999 Free Software Foundation, Inc.
  90 .br
  91 This is free software; see the source for copying conditions.  There is NO
  92 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.