summaryrefslogtreecommitdiffstats
path: root/man/stdbuf.1
blob: e781ed1bda65397104fdf9a93d713fbceed1482e (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
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH STDBUF "1" "August 2023" "GNU coreutils 9.4" "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,R,Q.
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.
.SS "Exit status:"
.TP
125
if the stdbuf command itself fails
.TP
126
if COMMAND is found but cannot be invoked
.TP
127
if COMMAND cannot be found
.TP
\-
the exit status of COMMAND otherwise
.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 2023 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