diff options
| author | Pádraig Brady <P@draigBrady.com> | 2011-07-01 09:42:17 +0100 |
|---|---|---|
| committer | Pádraig Brady <P@draigBrady.com> | 2011-07-01 22:47:54 +0100 |
| commit | e7734b4a66f0d860698538cef13e6392ff8fdaf7 (patch) | |
| tree | 2187b0933d2a69a1e251a7adad3d9f9948b9fcbc | |
| parent | 0c87ba4693e871b7d668056674f160001f73b460 (diff) | |
| download | coreutils-e7734b4a66f0d860698538cef13e6392ff8fdaf7.tar.xz | |
doc: detail the effect of disabling input buffering with stdbuf
* docs/coreutils.texi (stdbuf invocation): Expand on the different
reasons for disabling buffering on input and output.
| -rw-r--r-- | doc/coreutils.texi | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 4b0917d3f..c59af2f47 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -15448,8 +15448,13 @@ This option is invalid with standard input. @item 0 Disable buffering of the selected stream. -In this mode data is output immediately and only the +In this mode, data is output immediately and only the amount of data requested is read from input. +Note the difference in function for input and output. +Disabling buffering for input will not influence the responsiveness +or blocking behavior of the stream input functions. +For example @code{fread} will still block until @code{EOF} or error, +even if the underlying @code{read} returns less data than requested. @item @var{size} Specify the size of the buffer to use in fully buffered mode. |