From: Jim Meyering <jim@meyering.net>
Date: Fri, 25 Jul 2003 07:45:20 +0000 (+0000)
Subject: (usage): Document the fact that SIGUSR1 makes dd
X-Git-Tag: v5.0.90~87
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7fd35644894fe721ae5396d0e3dea09f2ebf04ff;p=thirdparty%2Fcoreutils.git

(usage): Document the fact that SIGUSR1 makes dd
output its current record counts.  Reported by Jurriaan.
---

diff --git a/src/dd.c b/src/dd.c
index 9977592014..187764ca9e 100644
--- a/src/dd.c
+++ b/src/dd.c
@@ -326,6 +326,17 @@ Each KEYWORD may be:\n\
   noerror   continue after read errors\n\
   sync      pad every input block with NULs to ibs-size; when used\n\
               with block or unblock, pad with spaces rather than NULs\n\
+"), stdout);
+      fputs (_("\
+\n\
+Note that sending a SIGUSR1 signal to a running `dd' process makes it\n\
+print to standard error the number of records read and written so far,\n\
+then to resume copying.\n\
+\n\
+  $ dd if=/dev/zero of=/dev/null& pid=$!\n\
+  $ kill -USR1 $pid; sleep 1; kill $pid\n\
+  10899206+0 records in\n\
+  10899206+0 records out\n\
 "), stdout);
       printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
     }