aboutsummaryrefslogtreecommitdiff
path: root/doc/sg_dd.8
diff options
context:
space:
mode:
authorDouglas Gilbert <dgilbert@interlog.com>2020-10-13 20:27:48 +0000
committerDouglas Gilbert <dgilbert@interlog.com>2020-10-13 20:27:48 +0000
commit4ca8449c2826be469bc9558f2a037236c6703d64 (patch)
treef4822e70e3a382a651636a46271bd4e4407f7f6a /doc/sg_dd.8
parent050aa4385fef1eb0ef515bdc97c47dc24858354a (diff)
downloadsg3_utils-4ca8449c2826be469bc9558f2a037236c6703d64.tar.gz
sg_dd: add oflag=nocreat and conv=nocreat : OFILE must exist; similar in testing sgh_dd+sg_mrq_dd
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@865 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'doc/sg_dd.8')
-rw-r--r--doc/sg_dd.814
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/sg_dd.8 b/doc/sg_dd.8
index 90d707bc..b2d45874 100644
--- a/doc/sg_dd.8
+++ b/doc/sg_dd.8
@@ -242,6 +242,10 @@ traditional dd conversions (e.g. ASCII to EBCDIC). Recently added
conversions overlap somewhat with the flags so some conversions are
now supported by sg_dd.
.TP
+nocreat
+this conversion has the same effect as "oflag=nocreat", namely: \fIOFILE\fR
+must exist, it will not be created.
+.TP
noerror
this conversion is very close to "iflag=coe" and is treated as such. See
the "coe" flag. Note that an error on \fIOFILE\fR will stop the copy.
@@ -352,6 +356,16 @@ nocache
use posix_fadvise() to advise corresponding file there is no need to fill
the file buffer with recently read or written blocks.
.TP
+nocreat
+this flag is only active in \fIoflag=FLAGS\fR. If present then \fIOFILE\fR
+will be opened if it exists. If \fIOFILE\fR doesn't exist then an error
+is generated. Without this flag a regular (empty) file named \fIOFILE\fR
+will be created (and then filled). For production quality scripts where
+\fIOFILE\fR is a device node (e.g. '/dev/sdc') this flag is recommended.
+It guards against the remote possibility of 'dev/sdc' disappearing
+temporarily (e.g. a USB memory key removed) resulting in a large regular
+file called '/dev/sdc' being created.
+.TP
null
has no affect, just a placeholder.
.TP