summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2012-05-08 13:18:45 +0100
committerPádraig Brady <P@draigBrady.com>2012-05-08 14:12:48 +0100
commitbe2dabef95d5638e40c7c74b2bc1a3a4dd64bae3 (patch)
treece6e6f4bc285b315eb38a5d36d211c80e4637d01 /doc
parent452dc6b5ef39d3a9c26208d960085fe992f4c3b7 (diff)
downloadcoreutils-be2dabef95d5638e40c7c74b2bc1a3a4dd64bae3.tar.xz
doc: clarify dd conv=sparse usage with devices
* doc/coreutils.texi (dd invocation): Clarify that NUL blocks are not copied for devices either, and give examples of where it might be useful.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 61b3c8925..767267bf3 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8167,9 +8167,12 @@ On a file system that supports sparse files, this will create
sparse output when extending the output file.
Be careful when using this option in conjunction with
@samp{conv=notrunc} or @samp{oflag=append}.
-With @samp{conv=notrunc}, existing data in the output
+With @samp{conv=notrunc}, existing data in the output file
corresponding to @sc{nul} blocks from the input, will be untouched.
With @samp{oflag=append} the seeks performed will be ineffective.
+Similarly, when the output is a device rather than a file,
+@sc{nul} input blocks are not copied, and therefore this option
+is most useful with virtual or pre zeroed devices.
@item swab
@opindex swab @r{(byte-swapping)}