summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2011-03-05 02:21:45 +0000
committerPádraig Brady <P@draigBrady.com>2011-03-05 02:21:45 +0000
commit433a7c614f0fbce3ba3346409af847d82670d284 (patch)
tree3d311c28a89ea81cc5bd1cd01455673ab7a44cfc
parent7525860fb9c158cba362037fba491d82a09613c6 (diff)
downloadcoreutils-433a7c614f0fbce3ba3346409af847d82670d284.tar.xz
doc: clarify that `dd bs=` can immediately output short reads
* doc/coreutils.texi (dd invocation): Clarify that bs= can cause parital reads to be immediately written to output. * src/dd.c (usage): Hint that bs= can cause partial writes. See http://debbugs.gnu.org/cgi/bugreport.cgi?bug=8171
-rw-r--r--doc/coreutils.texi4
-rw-r--r--src/dd.c4
2 files changed, 4 insertions, 4 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 9f6c734ca..ae3712dba 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7971,8 +7971,8 @@ Set both input and output block sizes to @var{bytes}.
This makes @command{dd} read and write @var{bytes} per block,
overriding any @samp{ibs} and @samp{obs} settings.
In addition, if no data-transforming @option{conv} option is specified,
-each input block is copied to the output as a single block,
-without aggregating short reads.
+input is copied to the output as soon as it's read,
+even if it is smaller than the block size.
@item cbs=@var{bytes}
@opindex cbs
diff --git a/src/dd.c b/src/dd.c
index a2b4d209f..acbcea95f 100644
--- a/src/dd.c
+++ b/src/dd.c
@@ -467,11 +467,11 @@ Usage: %s [OPERAND]...\n\
fputs (_("\
Copy a file, converting and formatting according to the operands.\n\
\n\
- bs=BYTES read and write BYTES bytes at a time (also see ibs=,obs=)\n\
+ bs=BYTES read and write up to BYTES bytes at a time\n\
cbs=BYTES convert BYTES bytes at a time\n\
conv=CONVS convert the file as per the comma separated symbol list\n\
count=BLOCKS copy only BLOCKS input blocks\n\
- ibs=BYTES read BYTES bytes at a time (default: 512)\n\
+ ibs=BYTES read up to BYTES bytes at a time (default: 512)\n\
"), stdout);
fputs (_("\
if=FILE read from FILE instead of stdin\n\