Buffer data received on standard input.
stream-buffer receives data on standard input and buffers it before
sending to its standard output stream.
Assuming you have GCC installed, these commands should install
on your system:
$ make -j 4 $ make PREFIX=~/.local install
To uninstall the program:
$ make PREFIX=~/.local uninstall
Two executables are produced and installed:
stream-buffer: the main executable
stream-buffer-ctl: the support program providing control over running buffers
Some quick-start commands.
Use the buffer as you would use, e.g.,
tee(1) - pipe the output of some
process to it and let stream buffer handle buffering:
$ some-process --produce=logs | stream-buffer 64KiB > some-process.log
Resize the buffer while it is streaming data:
$ stream-buffer-ctl 123456 resize 8KiB
Be aware that the buffer is flushed before resizing.
Flushing buffer is accomplished by sending it the
$ kill -s SIGHUP 123456 $ stream-buffer-ctl 123456 flush
Do it either using
kill(1) or the control program.
stdbuf(1) works by adjusting standard streams settings and then
execvp(2)-ing the program. This means that:
stdbuf(1)does nothing to affect that
stream-buffer works by placing itself as a middleman - it receives data on
standard input, buffers it, and sends it to its standard output. Thus, even if
the program adjusts its stream settings
stream-buffer it will not matter
because the program cannot affect what
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.