diff options
| author | Paul Eggert <eggert@cs.ucla.edu> | 2005-04-09 04:51:52 +0000 |
|---|---|---|
| committer | Paul Eggert <eggert@cs.ucla.edu> | 2005-04-09 04:51:52 +0000 |
| commit | a3d3cf669ce3a225c970582e61dc26abdfe46578 (patch) | |
| tree | f31eb4c5792fdd00687d1fc360772282cb4fc270 /doc/coreutils.texi | |
| parent | c7eda8c16f0578f4725b6fc74fe17c0c676689cc (diff) | |
| download | coreutils-a3d3cf669ce3a225c970582e61dc26abdfe46578.tar.xz | |
(dd invocation): Document the distinction between
INFO and USR1 for dd, and the effect of POSIXLY_CORRECT here.
Diffstat (limited to 'doc/coreutils.texi')
| -rw-r--r-- | doc/coreutils.texi | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index e6fbb3978..5904ac403 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -6906,16 +6906,16 @@ tape=/dev/rmt/0 (dd bs=4k seek=1 count=0 && dd bs=512k) <$tape >$disk @end example -Note that sending a @samp{SIGUSR1} signal to a running @command{dd} -process makes it print I/O statistics to standard error, -then to resume copying. In the example below, +Sending an @samp{INFO} signal to a running @command{dd} +process makes it print I/O statistics to standard error +and then 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 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 +$ kill -s INFO $pid; wait $pid 3385223+0 records in 3385223+0 records out 1733234176 bytes (1.7 GB) copied, 6.42173 seconds, 270 MB/s @@ -6924,6 +6924,11 @@ $ kill -s USR1 $pid; wait $pid 5120000000 bytes (5.1 GB) copied, 18.913 seconds, 271 MB/s @end example +@vindex POSIXLY_CORRECT +On systems lacking the @samp{INFO} signal @command{dd} responds to the +@samp{USR1} signal instead, unless the @env{POSIXLY_CORRECT} +environment variable is set. + @exitstatus |