NAME

       sg_rep_zones - send SCSI REPORT ZONES command

SYNOPSIS

       sg_rep_zones  [--help] [--hex] [--maxlen=LEN] [--num=NUM] [--partial] [--raw] [--readonly] [--report=OPT]
       [--start=LBA] [--verbose] [--version] [--wp] DEVICE

DESCRIPTION

       Sends a SCSI REPORT ZONES command to DEVICE and outputs the data returned. This command is found  in  the
       ZBC draft standard, revision 5 (zbc-r05.pdf).

OPTIONS

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

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

       -H, --hex
              output the response in hexadecimal to stdout. When used once the whole response is output in ASCII
              hexadecimal  with  a  leading  address  (starting  at  0)  on each line. When used twice each zone
              descriptor in the response is output  separately  in  hexadecimal.  When  used  thrice  the  whole
              response is output in hexadecimal with no leading address (on each line).

       -m, --maxlen=LEN
              where LEN is the (maximum) response length in bytes. It is placed in the cdb's "allocation length"
              field.  If  not  given  (or  LEN  is  zero) then 8192 is used. The maximum allowed value of LEN is
              1048576.

       -n, --num=NUM
              where NUM is the (maximum) number of zone descriptors to print out.  The  default  value  is  zero
              which is taken to mean print out all zone descriptors returned by the REPORT ZONES command.

       -p, --partial
              set the PARTIAL bit in the cdb.

       -r, --raw
              output the SCSI response (i.e. the data-out buffer) in binary (to stdout).

       -R, --readonly
              open  the  DEVICE  read-only  (e.g.  in  Unix  with the O_RDONLY flag).  The default is to open it
              read-write.

       -o, --report=OPT
              where OPT will become the contents of the REPORTING OPTION field in the cdb. The default value  is
              0  which  means  report  a  list of all zones.  Some other values are 1 for list zones with a zone
              condition of empty; 2 for list zones with a zone condition of implicitly opened; 3 for list  zones
              with  a  zone  condition of explicitly opened; 4 for list zones with a zone condition of closed; 5
              for list zones with a zone condition of full; 6 for list zones with a zone condition of read only;
              7 for list zones with a zone condition of offline. Other values are 0x10 for list zones  with  RWP
              recommended set to true; 0x11 for list zones with non-sequential write resource active set to true
              and 0x3f for list zones with a zone condition of not write pointer.

       -s, --start=LBA
              where  LBA is at the start or within the first zone to be reported. The default value is 0. If LBA
              is not a zone start LBA then the preceding zone start LBA is used for reporting. Assumed to be  in
              decimal unless prefixed with '0x' or has a trailing 'h' which indicate hexadecimal.

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

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

       -w, --wp
              print the write pointer (in hex) only. In the absence of errors, then a hex LBA will be printed on
              each  line,  one  line  for each zone. Can be usefully combined with the --num=NUM and --start=LBA
              options.

EXIT STATUS

       The exit status of sg_rep_zones 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  MERCHANTABILITY
       or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       sg_reset_wp,sg_zone(sg3_utils)

sg3_utils-1.46                                     March 2021                                    SG_REP_ZONES(8)