81 lines
2.6 KiB
Groff
81 lines
2.6 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
|
|
.TH STDBUF "1" "April 2025" "GNU coreutils 9.7" "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 2025 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
|