summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/tail.1
blob: 0fbf0a98b4554d428e7a5e54c193b6fd0e192997 (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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH TAIL "1" "October 2021" "GNU coreutils 8.32" "User Commands"
.SH NAME
tail \- output the last part of files
.SH SYNOPSIS
.B tail
[\fI\,OPTION\/\fR]... [\fI\,FILE\/\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.
.PP
With no FILE, or when FILE is \-, read standard input.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM
output the last NUM bytes; or use \fB\-c\fR +NUM to
output starting with byte NUM of each file
.TP
\fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}]
output appended data as the file grows;
.IP
an absent option argument means 'descriptor'
.TP
\fB\-F\fR
same as \fB\-\-follow\fR=\fI\,name\/\fR \fB\-\-retry\fR
.TP
\fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM
output the last NUM lines, instead of the last 10;
or use \fB\-n\fR +NUM to output starting with line NUM
.TP
\fB\-\-max\-unchanged\-stats\fR=\fI\,N\/\fR
with \fB\-\-follow\fR=\fI\,name\/\fR, reopen a FILE which has not
.IP
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);
with inotify, this option is rarely useful
.TP
\fB\-\-pid\fR=\fI\,PID\/\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\-\-retry\fR
keep trying to open a file if it is inaccessible
.TP
\fB\-s\fR, \fB\-\-sleep\-interval\fR=\fI\,N\/\fR
with \fB\-f\fR, sleep for approximately N seconds
(default 1.0) between iterations;
with inotify and \fB\-\-pid\fR=\fI\,P\/\fR, check process P at
least once every N seconds
.TP
\fB\-v\fR, \fB\-\-verbose\fR
always output headers giving file names
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
line delimiter is NUL, not newline
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
NUM may have a multiplier suffix:
b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y.
Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
.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=\fI\,name\/\fR in that case.  That causes tail to track the
named file in a way that accommodates renaming, removal and creation.
.SH AUTHOR
Written by Paul Rubin, David MacKenzie, Ian Lance Taylor,
and Jim Meyering.
.SH "REPORTING BUGS"
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
.br
Report any translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2020 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
head(1)
.PP
.br
Full documentation <https://www.gnu.org/software/coreutils/tail>
.br
or available locally via: info \(aq(coreutils) tail invocation\(aq