Debian Codegraph @

upstream/debian-trixie/man1/tail.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH TAIL "1" "June 2025" "GNU coreutils 9.7" "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 an absent option argument means 'descriptor'
25 .TP
26 \fB\-F\fR
27 same as \fB\-\-follow\fR=\fI\,name\/\fR \fB\-\-retry\fR
28 .TP
29 \fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM
30 output the last NUM lines, instead of the last 10;
31 or use \fB\-n\fR +NUM to skip NUM\-1 lines at the start
32 .TP
33 \fB\-\-max\-unchanged\-stats\fR=\fI\,N\/\fR
34 with \fB\-\-follow\fR=\fI\,name\/\fR, reopen a FILE which has not
35 changed size after N (default 5) iterations
36 to see if it has been unlinked or renamed
37 (this is the usual case of rotated log files);
38 with inotify, this option is rarely useful
39 .TP
40 \fB\-\-pid\fR=\fI\,PID\/\fR
41 with \fB\-f\fR, terminate after process ID, PID dies;
42 can be repeated to watch multiple processes
43 .TP
44 \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
45 never output headers giving file names
46 .TP
47 \fB\-\-retry\fR
48 keep trying to open a file if it is inaccessible
49 .TP
50 \fB\-s\fR, \fB\-\-sleep\-interval\fR=\fI\,N\/\fR
51 with \fB\-f\fR, sleep for approximately N seconds
52 (default 1.0) between iterations;
53 with inotify and \fB\-\-pid\fR=\fI\,P\/\fR, check process P at
54 least once every N seconds
55 .TP
56 \fB\-v\fR, \fB\-\-verbose\fR
57 always output headers giving file names
58 .TP
59 \fB\-z\fR, \fB\-\-zero\-terminated\fR
60 line delimiter is NUL, not newline
61 .TP
62 \fB\-\-help\fR
63 display this help and exit
64 .TP
65 \fB\-\-version\fR
66 output version information and exit
67 .PP
68 NUM may have a multiplier suffix:
69 b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
70 GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q.
71 Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
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: <https://www.gnu.org/software/coreutils/>
84 .br
85 Report any translation bugs to <https://translationproject.org/team/>
86 .SH "SEE ALSO"
87 \fBhead\fP(1)
88 .PP
89 .br
90 Full documentation <https://www.gnu.org/software/coreutils/tail>
91 .br
92 or available locally via: info \(aq(coreutils) tail invocation\(aq
93 .PP
94 .br
95 Packaged by Debian (9.7\-3)
96 .br
97 Copyright \(co 2025 Free Software Foundation, Inc.
98 .br
99 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
100 .br
101 This is free software: you are free to change and redistribute it.
102 .br
103 There is NO WARRANTY, to the extent permitted by law.