summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2004-11-15 06:50:23 +0000
committerPaul Eggert <eggert@cs.ucla.edu>2004-11-15 06:50:23 +0000
commit9213ced1a709fab3aa746b5616975ac97f62544b (patch)
tree18c638932cfd93ce267c6e8d49ed86362b4554ce /doc
parent7d8f8967f3b1216508bc40237a93bd88894143f2 (diff)
downloadcoreutils-9213ced1a709fab3aa746b5616975ac97f62544b.tar.xz
(dd invocation): dd now outputs total bytes,
seconds, and bytes per second.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi27
1 files changed, 14 insertions, 13 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 925cba0ee..cf8e9369c 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6863,20 +6863,21 @@ tape=/dev/rmt/0
@end example
Note that sending a @samp{SIGUSR1} signal to a running @command{dd}
-process makes it print to standard error the number of records read
-and written so far, then to resume copying. In the example below,
+process makes it print I/O statistics to standard error,
+then to resume copying. In the example below,
@command{dd} is run in the background to copy 10 million blocks.
-The @command{kill} command makes it output the first pair of
-intermediate record counts,
-and when @command{dd} completes, it outputs the final pair.
-
-@example
-$ dd if=/dev/zero of=/dev/null count=10M & pid=$!
-$ kill -s USR1 $pid; sleep 99
-5403604+0 records in
-5403604+0 records out
-10485760+0 records in
-10485760+0 records out
+The @command{kill} command makes it output intermediate I/O statistics,
+and when @command{dd} completes, it outputs the final statistics.
+
+@example
+$ dd if=/dev/zero of=/dev/null count=10MB & pid=$!
+$ kill -s USR1 $pid; wait $pid
+4111640+0 records in
+4111639+0 records out
+2.1GB copied in 7.95411s (265MB/s)
+10000000+0 records in
+10000000+0 records out
+5.1GB copied in 19.3794s (264MB/s)
@end example
@exitstatus