diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2022-07-06 23:42:19 -0500 |
---|---|---|
committer | Paul Eggert <eggert@cs.ucla.edu> | 2022-07-06 23:42:55 -0500 |
commit | e6c70916344ea59f64303d6f2e2baec49ff712c6 (patch) | |
tree | 796ed6780797fce9472a17179992e223f3bf4ca5 /doc | |
parent | 8da1edffff5a5932fd77afd84fb42cc5e24b9922 (diff) | |
download | coreutils-e6c70916344ea59f64303d6f2e2baec49ff712c6.tar.gz |
dd: doc improvement (Bug#54586)
* doc/coreutils.texi (dd invocation): Explain
fdatasync and fsync better.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/coreutils.texi | 13 |
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 7bca37b71..e0c87d1ad 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -9466,7 +9466,13 @@ Continue after read errors. @cindex synchronized data writes, before finishing Synchronize output data just before finishing, even if there were write errors. -This forces a physical write of output data. +This forces a physical write of output data, +so that even if power is lost the output data will be preserved. +If neither this nor @samp{fsync} are specified, output is treated as +usual with file systems, i.e., output data and metadata may be cached +in primary memory for some time before the operating system physically +writes it, and thus output data and metadata may be lost if power is lost. +@xref{sync invocation}. This conversion is a GNU extension to POSIX. @item fsync @@ -9474,7 +9480,10 @@ This conversion is a GNU extension to POSIX. @cindex synchronized data and metadata writes, before finishing Synchronize output data and metadata just before finishing, even if there were write errors. -This forces a physical write of output data and metadata. +This acts like @samp{fdatasync} except it also preserves output metadata, +such as the last-modified time of the output file; for this reason it +may be a bit slower than @samp{fdatasync} although the performance +difference is typically insignificant for @command{dd}. This conversion is a GNU extension to POSIX. @end table |