diff options
author | Douglas Gilbert <dgilbert@interlog.com> | 2018-05-20 02:08:23 +0000 |
---|---|---|
committer | Douglas Gilbert <dgilbert@interlog.com> | 2018-05-20 02:08:23 +0000 |
commit | 26e76bf6c671941fec1a8d2b3fb53fcd64993577 (patch) | |
tree | cc52a31ff65e1b4affeea6fe117beeb13d30f637 /doc | |
parent | 856fb91355bddbe7a15a9d11334c354d8ee7b6d3 (diff) | |
download | sg3_utils-26e76bf6c671941fec1a8d2b3fb53fcd64993577.tar.gz |
sg_sanitize: add --dry-run option; sg_format: extend --wait timeout to 40 hours for disk sizes > 4 TB and 80 hours if > 8 TB
git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@773 6180dd3e-e324-4e3e-922d-17de1ae2f315
Diffstat (limited to 'doc')
-rw-r--r-- | doc/sg3_utils.8 | 10 | ||||
-rw-r--r-- | doc/sg_format.8 | 46 | ||||
-rw-r--r-- | doc/sg_logs.8 | 4 | ||||
-rw-r--r-- | doc/sg_raw.8 | 8 | ||||
-rw-r--r-- | doc/sg_readcap.8 | 8 | ||||
-rw-r--r-- | doc/sg_sanitize.8 | 18 | ||||
-rw-r--r-- | doc/sg_senddiag.8 | 20 | ||||
-rw-r--r-- | doc/sg_sync.8 | 10 | ||||
-rw-r--r-- | doc/sg_timestamp.8 | 10 |
9 files changed, 73 insertions, 61 deletions
diff --git a/doc/sg3_utils.8 b/doc/sg3_utils.8 index f1c0f4e7..74e2fa9d 100644 --- a/doc/sg3_utils.8 +++ b/doc/sg3_utils.8 @@ -5,7 +5,7 @@ sg3_utils \- a package of utilities for sending SCSI commands .B sg_* [\fI\-\-dry\-run\fR] [\fI\-\-enumerate\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-in=FN\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-raw\fR] -[\fI\-\-timeout=SEC\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] +[\fI\-\-timeout=SECS\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] [\fIOTHER_OPTIONS\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here @@ -516,19 +516,19 @@ SCSI command, use this option. Alternatively the \fI\-\-in=FN\fR option causes from a file named \fIFN\fR. In these cases this option may indicate that binary data can be read from stdin or from a nominated file (e.g. \fIFN\fR). .TP -\fB\-t\fR, \fB\-\-timeout\fR=\fISEC\fR +\fB\-t\fR, \fB\-\-timeout\fR=\fISECS\fR utilities that issue potentially long\-running SCSI commands often have a -\fI\-\-timeout=SEC\fR option. This typically instructs the operating system +\fI\-\-timeout=SECS\fR option. This typically instructs the operating system to abort the SCSI command in question once the timeout expires. Aborting SCSI commands is typically a messy business and in the case of format like commands may leave the device in a "format corrupt" state requiring another -long\-running re\-initialization command to be sent. The argument, \fISEC\fR, +long\-running re\-initialization command to be sent. The argument, \fISECS\fR, is usually in seconds and the short form of the option may be something other than \fI\-t\fR since the timeout option was typically added later as storage devices grew in size and initialization commands took longer. Since many utilities had relatively long internal command timeouts before this option was introduced, the actual command timeout given to the operating -systems is the higher of the internal timeout and \fISEC\fR. +systems is the higher of the internal timeout and \fISECS\fR. .br Many long running SCSI commands have an IMMED bit which causes the command to finish relatively quickly but the initialization process to continue. In diff --git a/doc/sg_format.8 b/doc/sg_format.8 index 85f6eb78..7d36f5fe 100644 --- a/doc/sg_format.8 +++ b/doc/sg_format.8 @@ -1,16 +1,16 @@ -.TH SG_FORMAT "8" "March 2018" "sg3_utils\-1.43" SG3_UTILS +.TH SG_FORMAT "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_format \- format, resize a SCSI disk or format a tape .SH SYNOPSIS .B sg_format [\fI\-\-cmplst=\fR{0|1}] [\fI\-\-count=COUNT\fR] [\fI\-\-dcrt\fR] -[\fI\-\-early\fR] [\fI\-\-ffmt=FFMT\fR] [\fI\-\-fmtpinfo=FPI\fR] -[\fI\-\-format\fR] [\fI\-\-help\fR] [\fI\-\-ip\-def\fR] [\fI\-\-long\fR] -[\fI\-\-mode=MP\fR] [\fI\-\-pfu=PFU\fR] [\fI\-\-pie=PIE\fR] [\fI\-\-pinfo\fR] -[\fI\-\-poll=PT\fR] [\fI\-\-quick\fR] [\fI\-\-resize\fR] [\fI\-\-rto_req\fR] -[\fI\-\-security\fR] [\fI\-\-six\fR] [\fI\-\-size=SIZE\fR] [\fI\-\-tape=FM\fR] -[\fI\-\-timeout=SEC\fR] [\fI\-\-verbose\fR] [\fI\-\-verify\fR] -[\fI\-\-version\fR] [\fI\-\-wait\fR] +[\fI\-\-dry\-run\fR] [\fI\-\-early\fR] [\fI\-\-ffmt=FFMT\fR] +[\fI\-\-fmtpinfo=FPI\fR] [\fI\-\-format\fR] [\fI\-\-help\fR] +[\fI\-\-ip\-def\fR] [\fI\-\-long\fR] [\fI\-\-mode=MP\fR] [\fI\-\-pfu=PFU\fR] +[\fI\-\-pie=PIE\fR] [\fI\-\-pinfo\fR] [\fI\-\-poll=PT\fR] [\fI\-\-quick\fR] +[\fI\-\-resize\fR] [\fI\-\-rto_req\fR] [\fI\-\-security\fR] [\fI\-\-six\fR] +[\fI\-\-size=SIZE\fR] [\fI\-\-tape=FM\fR] [\fI\-\-timeout=SECS\fR] +[\fI\-\-verbose\fR] [\fI\-\-verify\fR] [\fI\-\-version\fR] [\fI\-\-wait\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here @@ -117,6 +117,12 @@ The default action of this utility (i.e. when this option is not given) is to clear the DCRT bit thereby requesting "media certification". When the DCRT bit is set, the FOV bit must also be set hence sg_format does that. .TP +\fB\-d\fR, \fB\-\-dry\-run\fR +this option will parse the command line, do all the preparation but bypass +the actual FORMAT UNIT or FORMAT MEDIUM commands. Also if the options would +cause the logical block size to change, then the MODE SELECT command that +would do that is also bypassed when the dry run option is given. +.TP \fB\-e\fR, \fB\-\-early\fR during a format operation, The default action of this utility is to poll the disk every 60 seconds to determine the progress of the format operation until @@ -275,17 +281,19 @@ set to \fIFM\fR. This option is used to prepare a tape (i.e. the "medium") in a tape drive for use. Values for \fIFM\fR include 0 to do the "default" format; 1 to partition a volume and 2 to do a default format then partition. .TP -\fB\-m\fR, \fB\-\-timeout\fR=\fISEC\fR -where \fISEC\fR is the FORMAT UNIT or FORMAT MEDIUM command timeout in -seconds. \fISEC\fR will only be used if it exceeds the internal timeout +\fB\-m\fR, \fB\-\-timeout\fR=\fISECS\fR +where \fISECS\fR is the FORMAT UNIT or FORMAT MEDIUM command timeout in +seconds. \fISECS\fR will only be used if it exceeds the internal timeout which is 20 seconds if the IMMED bit is set and 72000 seconds (20 hours) -if the IMMED bit is not set. If the timeout is exceeded then the -operating system will typically abort the command. Aborting a command -may escalate to a LUN reset (or worse). A timeout may also leave -the disk or tape format operation incomplete. And that may result in the -disk or tape being in a "format corrupt" state requiring another format -to remedy the situation. So for various reasons timeouts are best -avoided. +or higher if the IMMED bit is not set. If the didk unit exceeds 4 TB then +the timeout value is increased to 144000 seconds (40 hours). And if it is +greater than 8 TB then the timeout value is increased to 288000 seconds (80 +hours). If the timeout is exceeded then the operating system will typically +abort the command. Aborting a command may escalate to a LUN reset (or +worse). A timeout may also leave the disk or tape format operation +incomplete. And that may result in the disk or tape being in a "format +corrupt" state requiring another format to remedy the situation. So for +various reasons timeouts are best avoided. .TP \fB\-v\fR, \fB\-\-verbose\fR increase the level of verbosity, (i.e. debug output). "\-vvv" gives @@ -304,7 +312,7 @@ command's (short) parameter header. If this option (i.e. \fI\-\-wait\fR) is given then the "IMMED" bit is not set. If \fI\-\-wait\fR is given then the FORMAT UNIT or FORMAT MEDIUM command waits until the format operation completes before returning its response. This can be many hours on large -disks. See the \fI\-\-timeout=SEC\fR option. +disks. See the \fI\-\-timeout=SECS\fR option. .SH LISTS The SBC\-3 draft (revision 36) defines PLIST, CLIST, DLIST and GLIST in section 4.13 on "Medium defects". Briefly, the PLIST is the "primary" diff --git a/doc/sg_logs.8 b/doc/sg_logs.8 index 04bb4f56..8a2447b6 100644 --- a/doc/sg_logs.8 +++ b/doc/sg_logs.8 @@ -1,4 +1,4 @@ -.TH SG_LOGS "8" "October 2017" "sg3_utils\-1.43" SG3_UTILS +.TH SG_LOGS "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_logs \- access log pages with SCSI LOG SENSE command .SH SYNOPSIS @@ -472,7 +472,7 @@ Written by Douglas Gilbert .SH "REPORTING BUGS" Report bugs to <dgilbert at interlog dot com>. .SH COPYRIGHT -Copyright \(co 2002\-2017 Douglas Gilbert +Copyright \(co 2002\-2018 Douglas Gilbert .br This software is distributed under the GPL version 2. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. diff --git a/doc/sg_raw.8 b/doc/sg_raw.8 index 499ca46f..4bdea7ad 100644 --- a/doc/sg_raw.8 +++ b/doc/sg_raw.8 @@ -1,4 +1,4 @@ -.TH SG_RAW "8" "February 2018" "sg3_utils\-1.43" SG3_UTILS +.TH SG_RAW "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_raw \- send arbitrary SCSI command to a device .SH SYNOPSIS @@ -6,7 +6,7 @@ sg_raw \- send arbitrary SCSI command to a device [\fI\-\-binary\fR] [\fI\-\-cmdfile=CF\fR] [\fI\-\-enumerate\fR] [\fI\-\-help\fR] [\fI\-\-infile=IFILE\fR] [\fI\-\-nosense\fR] [\fI\-\-outfile=OFILE\fR] [\fI\-\-readonly\fR] [\fI\-\-request=RLEN\fR] -[\fI\-\-send=SLEN\fR] [\fI\-\-skip=KLEN\fR] [\fI\-\-timeout=SEC\fR] +[\fI\-\-send=SLEN\fR] [\fI\-\-skip=KLEN\fR] [\fI\-\-timeout=SECS\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR [CDB0 CDB1 ...] .SH DESCRIPTION This utility sends an arbitrary SCSI command (between 6 and 256 bytes) to @@ -95,8 +95,8 @@ Skip the first \fIKLEN\fR bytes of the input file or stream. This option is ignored if \fI\-\-send\fR is not specified. If \fI\-\-send\fR is given and this option is not given, then zero bytes are skipped. .TP -\fB\-t\fR, \fB\-\-timeout\fR=\fISEC\fR -Wait up to \fISEC\fR seconds for command completion (default: 20). +\fB\-t\fR, \fB\-\-timeout\fR=\fISECS\fR +Wait up to \fISECS\fR seconds for command completion (default: 20). Note that if a command times out the operating system may start by aborting the command and if that is unsuccessful it may attempt to reset the device. diff --git a/doc/sg_readcap.8 b/doc/sg_readcap.8 index 9ebb25d9..ffc8724b 100644 --- a/doc/sg_readcap.8 +++ b/doc/sg_readcap.8 @@ -1,4 +1,4 @@ -.TH SG_READCAP "8" "October 2017" "sg3_utils\-1.43" SG3_UTILS +.TH SG_READCAP "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_readcap \- send SCSI READ CAPACITY command .SH SYNOPSIS @@ -31,8 +31,8 @@ CAPACITY(16). Sadly there are horrible SCSI command set implementations in the wild that crash when the READ CAPACITY(16) command is sent to them. .PP Device capacity is the product of the number of blocks by the block size. -This utility outputs this figure in bytes, MiB (1048576 bytes per MiB) -and GB (1000000000 bytes per GB). +This utility outputs this figure in bytes, MiB (1048576 bytes per MiB), +GB (1000000000 bytes per GB) and, if large enough, TB (1000 GB). .PP If sg_readcap is called without the \fI\-\-long\fR option then the 10 byte cdb version (i.e. READ CAPACITY (10)) is sent to the \fIDEVICE\fR. If the @@ -179,7 +179,7 @@ using \fI\-\-old\fR (or \fI\-O\fR) as the first command line option. .SH AUTHORS Written by Douglas Gilbert .SH COPYRIGHT -Copyright \(co 1999\-2017 Douglas Gilbert +Copyright \(co 1999\-2018 Douglas Gilbert .br This software is distributed under the GPL version 2. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. diff --git a/doc/sg_sanitize.8 b/doc/sg_sanitize.8 index 4886cd2b..5bc7cb61 100644 --- a/doc/sg_sanitize.8 +++ b/doc/sg_sanitize.8 @@ -1,13 +1,13 @@ -.TH SG_SANITIZE "8" "February 2016" "sg3_utils\-1.43" SG3_UTILS +.TH SG_SANITIZE "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_sanitize \- remove all user data from disk with SCSI SANITIZE command .SH SYNOPSIS .B sg_sanitize [\fI\-\-ause\fR] [\fI\-\-block\fR] [\fI\-\-count=OC\fR] [\fI\-\-crypto\fR] -[\fI\-\-desc\fR] [\fI\-\-early\fR] [\fI\-\-fail\fR] [\fI\-\-help\fR] -[\fI\-\-invert\fR] [\fI\-\-ipl=LEN\fR] [\fI\-\-overwrite\fR] +[\fI\-\-dry\-run\fR] [\fI\-\-desc\fR] [\fI\-\-early\fR] [\fI\-\-fail\fR] +[\fI\-\-help\fR] [\fI\-\-invert\fR] [\fI\-\-ipl=LEN\fR] [\fI\-\-overwrite\fR] [\fI\-\-pattern=PF\fR] [\fI\-\-quick\fR] [\fI\-\-test=TE\fR] -[\fI\-\-timeout=SEC\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] +[\fI\-\-timeout=SECS\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] [\fI\-\-wait\fR] [\fI\-\-zero\fR] [\fI\-\-znr\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here @@ -72,6 +72,10 @@ used after the SANITIZE command is issued (assuming that neither the \fI\-\-early\fR nor the \fI\-\-wait\fR option have been given) to check on the progress of this command as it can take some time. .TP +\fB\-D\fR, \fB\-\-dry\-run\fR +this option will parse the command line, do all the preparation but bypass +the actual SANITIZE command. +.TP \fB\-e\fR, \fB\-\-early\fR the default action of this utility is to poll the disk every 60 seconds to fetch the progress indication until the sanitize is finished. When this @@ -124,8 +128,8 @@ set the TEST field in the overwrite service action parameter list. This only affects the "overwrite" sanitize operation. The default is to place 0 in that field. .TP -\fB\-t\fR, \fB\-\-timeout\fR=\fISEC\fR -where \fISEC\fR is the number of seconds used for the timeout on the +\fB\-t\fR, \fB\-\-timeout\fR=\fISECS\fR +where \fISECS\fR is the number of seconds used for the timeout on the SANITIZE command. .TP \fB\-v\fR, \fB\-\-verbose\fR @@ -234,7 +238,7 @@ Written by Douglas Gilbert. .SH "REPORTING BUGS" Report bugs to <dgilbert at interlog dot com>. .SH COPYRIGHT -Copyright \(co 2011\-2016 Douglas Gilbert +Copyright \(co 2011\-2018 Douglas Gilbert .br This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. diff --git a/doc/sg_senddiag.8 b/doc/sg_senddiag.8 index 3877bfa3..e3fa612f 100644 --- a/doc/sg_senddiag.8 +++ b/doc/sg_senddiag.8 @@ -1,4 +1,4 @@ -.TH SG_SENDDIAG "8" "October 2017" "sg3_utils\-1.43" SG3_UTILS +.TH SG_SENDDIAG "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_senddiag \- performs a SCSI SEND DIAGNOSTIC command .SH SYNOPSIS @@ -6,13 +6,13 @@ sg_senddiag \- performs a SCSI SEND DIAGNOSTIC command [\fI\-\-doff\fR] [\fI\-\-extdur\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-list\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-page=PG\fR] [\fI\-\-pf\fR] [\fI\-\-raw=H,H...\fR] [\fI\-\-raw=\-\fR] [\fI\-\-selftest=ST\fR] -[\fI\-\-test\fR] [\fI\-\-timeout=SEC\fR] [\fI\-\-uoff\fR] [\fI\-\-verbose\fR] +[\fI\-\-test\fR] [\fI\-\-timeout=SECS\fR] [\fI\-\-uoff\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR .PP .B sg_senddiag [\fI\-doff\fR] [\fI\-e\fR] [\fI\-h\fR] [\fI\-H\fR] [\fI\-l\fR] [\fI\-pf\fR] [\fI\-raw=H,H...\fR] [\fI\-raw=\-\fR] [\fI\-s=ST\fR] [\fI\-t\fR] -[\fI\-T=SEC\fR] [\fI\-uoff\fR] [\fI\-v\fR] [\fI\-V\fR] [\fI\-?\fR] +[\fI\-T=SECS\fR] [\fI\-uoff\fR] [\fI\-v\fR] [\fI\-V\fR] [\fI\-?\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here @@ -129,10 +129,10 @@ The \fI\-\-selftest=ST\fR option should not be active together with this option. Both the \fI\-\-doff\fR and/or \fI\-\-uoff\fR options can be used with this option. .TP -\fB\-T\fR, \fB\-\-timeout\fR=\fISEC\fR -where \fISEC\fR is a timeout value (in seconds) for foreground self\-test +\fB\-T\fR, \fB\-\-timeout\fR=\fISECS\fR +where \fISECS\fR is a timeout value (in seconds) for foreground self\-test operations. The default value is 7200 seconds (2 hours) and any values -of \fISEC\fR less than the default are ignored. +of \fISECS\fR less than the default are ignored. .TP \fB\-u\fR, \fB\-\-uoff\fR set the Unit Offline (UnitOffL) bit (default is clear). Only significant @@ -254,9 +254,9 @@ The \fI\-s=ST\fR option should not be active together with this option. Both the \fI\-doff\fR and/or \fI\-uoff\fR options can be used with this option. .TP -\fB\-T\fR=\fISEC\fR -where \fISEC\fR is a timeout value (in seconds) for foreground self\-test -operations. See the \fI\-\-timeout=SEC\fR option above. +\fB\-T\fR=\fISECS\fR +where \fISECS\fR is a timeout value (in seconds) for foreground self\-test +operations. See the \fI\-\-timeout=SECS\fR option above. .TP \fB\-uoff\fR set the Unit Offline (UnitOffL) bit (default is clear). Equivalent to @@ -292,7 +292,7 @@ Written by Douglas Gilbert .SH "REPORTING BUGS" Report bugs to <dgilbert at interlog dot com>. .SH COPYRIGHT -Copyright \(co 2003\-2017 Douglas Gilbert +Copyright \(co 2003\-2018 Douglas Gilbert .br This software is distributed under the GPL version 2. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. diff --git a/doc/sg_sync.8 b/doc/sg_sync.8 index 233a3f2d..64d3e479 100644 --- a/doc/sg_sync.8 +++ b/doc/sg_sync.8 @@ -1,11 +1,11 @@ -.TH SG_SYNC "8" "September 2017" "sg3_utils\-1.43" SG3_UTILS +.TH SG_SYNC "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS .SH NAME sg_sync \- send SCSI SYNCHRONIZE CACHE command .SH SYNOPSIS .B sg_sync [\fI\-\-16\fR] [\fI\-\-count=COUNT\fR] [\fI\-\-group=GN\fR] [\fI\-\-help\fR] [\fI\-\-immed\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-sync\-nv\fR] -[\fI\-\-timeout=SEC\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR +[\fI\-\-timeout=SECS\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here .PP @@ -58,8 +58,8 @@ option (or if there is no non\-volatile cache in the device) the synchronization is with the medium. The SYNC_NV bit was made obsolete in SBC\-3 revision 35d. .TP -\fB\-t\fR, \fB\-\-timeout\fR=\fISEC\fR -where \fISEC\fR is the number of seconds the OS allows the SYNCHRONIZE +\fB\-t\fR, \fB\-\-timeout\fR=\fISECS\fR +where \fISECS\fR is the number of seconds the OS allows the SYNCHRONIZE CACHE(16) to complete before it tries to cancel the command. Cancelling commands (typically with the task management function "abort task") is best avoided. Note this option is only active together with the \fI\-\-16\fR @@ -89,7 +89,7 @@ Written by Douglas Gilbert. .SH "REPORTING BUGS" Report bugs to <dgilbert at interlog dot com>. .SH COPYRIGHT -Copyright \(co 2004\-2017 Douglas Gilbert +Copyright \(co 2004\-2018 Douglas Gilbert .br This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. diff --git a/doc/sg_timestamp.8 b/doc/sg_timestamp.8 index 36fa55f7..3dd076da 100644 --- a/doc/sg_timestamp.8 +++ b/doc/sg_timestamp.8 @@ -5,7 +5,7 @@ sg_timestamp \- report or set timestamp on SCSI device .B sg_timestamp [\fI\-\-elapsed\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-milliseconds=MS\fR] [\fI\-\-no\-timestamp\fR] [\fI\-\-origin\fR] -[\fI\-\-raw\fR] [\fI\-\-readonly\fR] [\fI\-\-seconds=SEC\fR] [\fI\-\-srep\fR] +[\fI\-\-raw\fR] [\fI\-\-readonly\fR] [\fI\-\-seconds=SECS\fR] [\fI\-\-srep\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here @@ -14,7 +14,7 @@ Sends a SCSI REPORT TIMESTAMP or SET TIMESTAMP command to the \fIDEVICE\fR. These commands are found in the SPC\-5 draft standard revision 7 (spc5r07.pdf). .PP -If either the \fI\-\-milliseconds=MS\fR or \fI\-\-seconds=SEC\fR option is +If either the \fI\-\-milliseconds=MS\fR or \fI\-\-seconds=SECS\fR option is given (and both can't be given) then the SET TIMESTAMP command is sent; otherwise the REPORT TIMESTAMP command is sent. .PP @@ -78,9 +78,9 @@ verbose messages are output to stderr. open the \fIDEVICE\fR read\-only. The default action is to open the \fIDEVICE\fR read\-write. .TP -\fB\-s\fR, \fB\-\-seconds\fR=\fISEC\fR -where \fISEC\fR is the number of seconds since 1970\-01\-01 00:00:00 UTC -to set in the \fIDEVICE\fR with the SCSI SET TIMESTAMP command. \fISEC\fR +\fB\-s\fR, \fB\-\-seconds\fR=\fISECS\fR +where \fISECS\fR is the number of seconds since 1970\-01\-01 00:00:00 UTC +to set in the \fIDEVICE\fR with the SCSI SET TIMESTAMP command. \fISECS\fR is multiplied by 1000 before being used in the SET TIMESTAMP command. .TP \fB\-S\fR, \fB\-\-srep\fR |