From 245e8d347a48c70d5a2e047bf85b98609b64b900 Mon Sep 17 00:00:00 2001 From: Douglas Gilbert Date: Sun, 31 Jan 2021 23:48:11 +0000 Subject: sg_zone: add Remove element and modify zones command; testing/sg_mrq_dd work git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@874 6180dd3e-e324-4e3e-922d-17de1ae2f315 --- doc/sg_zone.8 | 36 ++++++++++++++++++++++++------------ 1 file changed, 24 insertions(+), 12 deletions(-) (limited to 'doc') diff --git a/doc/sg_zone.8 b/doc/sg_zone.8 index e3dfd3c7..a2aa45fc 100644 --- a/doc/sg_zone.8 +++ b/doc/sg_zone.8 @@ -1,21 +1,23 @@ -.TH SG_ZONE "8" "May 2018" "sg3_utils\-1.43" SG3_UTILS +.TH SG_ZONE "8" "January 2021" "sg3_utils\-1.43" SG3_UTILS .SH NAME -sg_zone \- send SCSI OPEN, CLOSE, FINISH or SEQUENTIALIZE ZONE command +sg_zone \- send a SCSI ZONE modifying command .SH SYNOPSIS .B sg_zone -[\fI\-\-all\fR] [\fI\-\-close\fR] [\fI\-\-count=ZC\fR] [\fI\-\-finish\fR] -[\fI\-\-help\fR] [\fI\-\-open\fR] [\fI\-\-sequentialize\fR] -[\fI\-\-verbose\fR] [\fI\-\-version\fR] [\fI\-\-zone=ID\fR] \fIDEVICE\fR +[\fI\-\-all\fR] [\fI\-\-close\fR] [\fI\-\-count=ZC\fR] [\fI\-\-element=EID\fR] +[\fI\-\-finish\fR] [\fI\-\-help\fR] [\fI\-\-open\fR] [\fI\-\-remove\fR] +[\fI\-\-sequentialize\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR] +[\fI\-\-zone=ID\fR] \fIDEVICE\fR .SH DESCRIPTION .\" Add any additional description here .PP -Sends a SCSI OPEN ZONE, CLOSE ZONE, FINISH ZONE or SEQUENTIALIZE ZONE -command to the \fIDEVICE\fR. All but the last are found in the soon to -be released ZBC standard (close to draft ZBC BSR INCITS 536 revision 05). -The SEQUENTIALIZE ZONE command was added in zbc2r01b. +Sends a SCSI OPEN ZONE, CLOSE ZONE, FINISH ZONE, REMOVE ELEMENT AND MODIFY +ZONES or SEQUENTIALIZE ZONE command to the \fIDEVICE\fR. All but the last +two are found in the ZBC standard (INCITS 536-2016). The REMOVE ELEMENT AND +MODIFY ZONES command was added in zbc2r07 while the SEQUENTIALIZE ZONE command +was added in zbc2r01b. .PP -One and only one of the \fI\-\-open\fR, \fI\-\-close\fR, \fI\-\-finish\fR -and \fI\-\-sequentialize\fR options can be chosen. +One and only one of the \fI\-\-open\fR, \fI\-\-close\fR, \fI\-\-finish\fR, +\fI\-\-remove\fR and \fI\-\-sequentialize\fR options can be chosen. .SH OPTIONS Arguments to long options are mandatory for short options as well. .TP @@ -30,6 +32,12 @@ ZC is placed in the Zone Count field in the cdb of all four commands supported by this utility. ZC should be a value from 0 to 65535 (0xffff) inclusive. .TP +\fB\-e\fR, \fB\-\-element\fR=\fIEID\fR +where \fIEID\fR is an element identifier which is a 32 bit unsigned integer +starting at one. This field is used by the REMOVE ELEMENT AND MODIFY ZONES +command and its default value is zero (which is invalid). So the user needs +to supply a valid element identifier when \fI\-\-remove\fR is used. +.TP \fB\-f\fR, \fB\-\-finish\fR causes the FINISH ZONE command to be sent to the \fIDEVICE\fR. .TP @@ -39,6 +47,10 @@ output the usage message then exit. \fB\-o\fR, \fB\-\-open\fR causes the OPEN ZONE command to be sent to the \fIDEVICE\fR. .TP +\fB\-r\fR, \fB\-\-remove\fR +causes the REMOVE ELEMENT AND MODIFY ZONES command to be sent to the +\fIDEVICE\fR. In practice, \fI\-\-element=EID\fR needs to be also given. +.TP \fB\-S\fR, \fB\-\-sequentialize\fR causes the SEQUENTIALIZE ZONE command to be sent to the \fIDEVICE\fR. .TP @@ -61,7 +73,7 @@ Written by Douglas Gilbert. .SH "REPORTING BUGS" Report bugs to . .SH COPYRIGHT -Copyright \(co 2014\-2018 Douglas Gilbert +Copyright \(co 2014\-2021 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. -- cgit v1.2.3