summaryrefslogtreecommitdiffstats
path: root/man/stdbuf.1
blob: 2baaf90ff136c53ab76196f02960f8012c8dc22e (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
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH STDBUF "1" "March 2020" "GNU coreutils 8.32" "User Commands"
.SH NAME
stdbuf \-
Run COMMAND, with modified buffering operations for its standard streams.
.SH SYNOPSIS
.B stdbuf
\fI\,OPTION\/\fR... \fI\,COMMAND\/\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
Run COMMAND, with modified buffering operations for its standard streams.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-i\fR, \fB\-\-input\fR=\fI\,MODE\/\fR
adjust standard input stream buffering
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,MODE\/\fR
adjust standard output stream buffering
.TP
\fB\-e\fR, \fB\-\-error\fR=\fI\,MODE\/\fR
adjust standard error stream buffering
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
If MODE is 'L' the corresponding stream will be line buffered.
This option is invalid with standard input.
.PP
If MODE is '0' the corresponding stream will be unbuffered.
.PP
Otherwise MODE is a number which may be followed by one of the following:
KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
In this case the corresponding stream will be fully buffered with the buffer
size set to MODE bytes.
.PP
NOTE: If COMMAND adjusts the buffering of its standard streams ('tee' does
for example) then that will override corresponding changes by 'stdbuf'.
Also some filters (like 'dd' and 'cat' etc.) don't use streams for I/O,
and are thus unaffected by 'stdbuf' settings.
.SH EXAMPLES
.B tail -f access.log | stdbuf -oL cut -d \(aq \(aq -f1 | uniq
.br
This will immediately display unique entries from access.log
.SH BUGS
On GLIBC platforms, specifying a buffer size, i.e., using fully buffered mode
will result in undefined operation.
.SH AUTHOR
Written by Padraig Brady.
.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"
Full documentation <https://www.gnu.org/software/coreutils/stdbuf>
.br
or available locally via: info \(aq(coreutils) stdbuf invocation\(aq