# phpman > man > SG_REP_ZONES(8)

[SG_REP_ZONES(8)](https://www.chedong.com/phpMan.php/man/SGREPZONES/8/markdown)                               SG3_UTILS                              [SG_REP_ZONES(8)](https://www.chedong.com/phpMan.php/man/SGREPZONES/8/markdown)



## 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
              where  _LEN_ is the (maximum) response length in bytes. It is placed in the cdb's "allo‐
              cation length" field. If not given (or _LEN_ is zero) then 8192 is used. The maximum al‐
              lowed value of _LEN_ is 1048576.

### -n --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
              where _OPT_ will become the contents of the REPORTING OPTION field in the cdb.  The  de‐
              fault  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
              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 re‐
              porting. 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)](https://www.chedong.com/phpMan.php/man/sg3utils/8/markdown)
       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**___**reset**___**wp,sg**___**zone(sg3**___**utils)**



sg3_utils-1.46                               March 2021                              [SG_REP_ZONES(8)](https://www.chedong.com/phpMan.php/man/SGREPZONES/8/markdown)