original/man1/stdbuf.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH STDBUF "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 stdbuf \-
   5 Run COMMAND, with modified buffering operations for its standard streams.
   6 .SH SYNOPSIS
   7 .B stdbuf
   8 \fI\,OPTION\/\fR... \fI\,COMMAND\/\fR
   9 .SH DESCRIPTION
  10 .\" Add any additional description here
  11 .PP
  12 Run COMMAND, with modified buffering operations for its standard streams.
  13 .PP
  14 Mandatory arguments to long options are mandatory for short options too.
  15 .TP
  16 \fB\-i\fR, \fB\-\-input\fR=\fI\,MODE\/\fR
  17 adjust standard input stream buffering
  18 .TP
  19 \fB\-o\fR, \fB\-\-output\fR=\fI\,MODE\/\fR
  20 adjust standard output stream buffering
  21 .TP
  22 \fB\-e\fR, \fB\-\-error\fR=\fI\,MODE\/\fR
  23 adjust standard error stream buffering
  24 .TP
  25 \fB\-\-help\fR
  26 display this help and exit
  27 .TP
  28 \fB\-\-version\fR
  29 output version information and exit
  30 .PP
  31 If MODE is 'L' the corresponding stream will be line buffered.
  32 This option is invalid with standard input.
  33 .PP
  34 If MODE is '0' the corresponding stream will be unbuffered.
  35 .PP
  36 Otherwise MODE is a number which may be followed by one of the following:
  37 KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
  38 In this case the corresponding stream will be fully buffered with the buffer
  39 size set to MODE bytes.
  40 .PP
  41 NOTE: If COMMAND adjusts the buffering of its standard streams ('tee' does
  42 for example) then that will override corresponding changes by 'stdbuf'.
  43 Also some filters (like 'dd' and 'cat' etc.) don't use streams for I/O,
  44 and are thus unaffected by 'stdbuf' settings.
  45 .SH EXAMPLES
  46 .B tail -f access.log | stdbuf -oL cut -d \(aq \(aq -f1 | uniq
  47 .br
  48 This will immedidately display unique entries from access.log
  49 .SH BUGS
  50 On GLIBC platforms, specifying a buffer size, i.e., using fully buffered mode
  51 will result in undefined operation.
  52 .SH AUTHOR
  53 Written by Padraig Brady.
  54 .SH "REPORTING BUGS"
  55 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  56 .br
  57 Report stdbuf translation bugs to <http://translationproject.org/team/>
  58 .SH COPYRIGHT
  59 Copyright \(co 2016 Free Software Foundation, Inc.
  60 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  61 .br
  62 This is free software: you are free to change and redistribute it.
  63 There is NO WARRANTY, to the extent permitted by law.
  64 .SH "SEE ALSO"
  65 Full documentation at: <http://www.gnu.org/software/coreutils/stdbuf>
  66 .br
  67 or available locally via: info \(aq(coreutils) stdbuf invocation\(aq