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)