diff options
author | Pádraig Brady <P@draigBrady.com> | 2008-12-17 11:30:03 +0000 |
---|---|---|
committer | Pádraig Brady <P@draigBrady.com> | 2009-06-17 14:54:29 +0100 |
commit | a5a2a406f8d65f0e852d9ed7fbfb630c6b81dd7f (patch) | |
tree | d6ec40e289bbe748eb05f5e6cb9e8d376d79f446 /man/stdbuf.x | |
parent | ff6fe3d17d9294f2494b4535a320bc9bfc86cc49 (diff) | |
download | coreutils-a5a2a406f8d65f0e852d9ed7fbfb630c6b81dd7f.tar.xz |
stdbuf: A new program to run a command with modified stdio buffering
* AUTHORS: Register as the author.
* NEWS: Mention this change.
* README: Add stdbuf command to list.
* configure.ac: Only enable on ELF systems with GCC.
* cfg.mk (sc_system_h_headers): Use VC_LIST_EXCEPT rather than
VC_LIST, so we can add an exception, if needed.
* .x-sc_system_h_headers: New file. Exempt libstdbuf.c.
* Makefile.am (syntax_check_exceptions): Add .x-sc_system_h_headers.
* doc/coreutils.texi (stdbuf invocation): Add stdbuf info.
* man/.gitignore: Ignore generated manpage.
* src/.gitignore: Ignore stdbuf and libstdbuf.so binaries.
* man/Makefile.am (stdbuf.1): Add dependency.
* man/stdbuf.x: New file with example usage.
* po/POTFILES.in: Reference new command and shared library sources.
* src/Makefile.am (build_if_possible__progs): Add stdbuf and libstdbuf,
(pkglib_PROGRAMS): Reference optional shared lib,
(libstdbuf_so_LDADD): Ensure we don't link with non PIC libcoreutils.a.
(libstdbuf_so_LDFLAGS): Add -shared GCC option,
(libstdbuf_so_CFLAGS): Add -fPIC GCC option.
(check-README): Exclude libstbuf.
(check-AUTHORS): ditto.
(sc_tight_scope): Exclude functions starting with __.
* src/libstdbuf.c: The LD_PRELOAD shared library to control buffering.
* src/stdbuf.c: New file to setup env variables before execing command.
* tests/Makefile.am: Reference new test file.
* tests/misc/help-version: Set expected exit codes.
* tests/misc/invalid-opt: ditto.
* tests/misc/stdbuf: Add 9 tests.
Diffstat (limited to 'man/stdbuf.x')
-rw-r--r-- | man/stdbuf.x | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/man/stdbuf.x b/man/stdbuf.x new file mode 100644 index 000000000..93f0b8e4b --- /dev/null +++ b/man/stdbuf.x @@ -0,0 +1,16 @@ +'\" Copyright (C) 2009 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +stdbuf \- Run COMMAND, with modified buffering operations for its standard streams. +[DESCRIPTION] +.\" Add any additional description here +[EXAMPLES] +.B tail -f access.log | stdbuf -oL cut -d \(aq \(aq -f1 | uniq +.br +This will immedidately display unique entries from access.log +[BUGS] +On GLIBC platforms, specifying a buffer size, i.e. using fully buffered mode +will result in undefined operation. |