NAME¶

sg_rep_zones - send SCSI REPORT ZONES command

SYNOPSIS¶

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

DESCRIPTION¶

Sends a SCSI REPORT ZONES command to DEVICE and outputs the data returned. This command is found in the ZBC draft standard whose most recent revision is 1a.

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.

-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 or all zones. Some other values are 1 for list full zones; 2 for list all open zones; 3 for list all empty zones; 4 for list all read only zones; 5 for list all offline zones; and 6 for list all zones with the RESET bit set.

-s, --start=LBA

where LBA is a zone start logical block address (LBA) of the first zone to be reported. The default value is 0. LBA must be a zone start LBA otherwise an ILLEGAL REQUEST sense key is returned. 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.

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 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(sg3_utils)