phpman > man > sg_zone(8)

SG_ZONE(8)                                    SG3_UTILS                                   SG_ZONE(8)



NAME
       sg_zone - send a SCSI ZONE modifying command

SYNOPSIS
       sg_zone  [--all]  [--close]  [--count=ZC] [--element=EID] [--finish] [--help] [--open] [--re‐
       move] [--sequentialize] [--verbose] [--version] [--zone=ID] DEVICE

DESCRIPTION
       Sends a SCSI OPEN ZONE, CLOSE ZONE, FINISH ZONE, REMOVE ELEMENT AND MODIFY ZONES  or  SEQUEN‐
       TIALIZE  ZONE  command to the DEVICE. All but the last two are found in the ZBC standard (IN‐
       CITS 536-2016). The REMOVE ELEMENT AND MODIFY ZONES command was added in  zbc2r07  while  the
       SEQUENTIALIZE ZONE command was added in zbc2r01b.

       One  and  only one of the --open, --close, --finish, --remove and --sequentialize options can
       be chosen.

OPTIONS
       Arguments to long options are mandatory for short options as well.

       -a, --all
              sets the ALL field in the cdb.

       -c, --close
              causes the CLOSE ZONE command to be sent to the DEVICE.

       -C, --count=ZC
              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.

       -e, --element=EID
              where EID 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 identi‐
              fier when --remove is used.

       -f, --finish
              causes the FINISH ZONE command to be sent to the DEVICE.

       -h, --help
              output the usage message then exit.

       -o, --open
              causes the OPEN ZONE command to be sent to the DEVICE.

       -r, --remove
              causes the REMOVE ELEMENT AND MODIFY ZONES command to be sent to the DEVICE. In  prac‐
              tice, --element=EID needs to be also given.

       -S, --sequentialize
              causes the SEQUENTIALIZE ZONE command to be sent to the DEVICE.

       -v, --verbose
              increase the level of verbosity, (i.e. debug output).

       -V, --version
              print the version string and then exit.

       -z, --zone=ID
              where ID is placed in the cdb's ZONE ID field. A zone id is a zone start logical block
              address (LBA). The default value is 0. ID is assumed to be in decimal unless  prefixed
              with '0x' or has a trailing 'h' which indicate hexadecimal.

EXIT STATUS
       The  exit  status  of  sg_zone is 0 when it is successful. Otherwise see the sg3_utils(8) man
       page.

AUTHORS
       Written by Douglas Gilbert.

REPORTING BUGS
       Report bugs to <dgilbert at interlog dot com>.

COPYRIGHT
       Copyright © 2014-2021 Douglas Gilbert
       This software is distributed under a FreeBSD license. There is NO warranty; not even for MER‐
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
       sg_rep_zones,sg_reset_wp(sg3_utils)



sg3_utils-1.43                              January 2021                                  SG_ZONE(8)