OS Manuals

/usr/bin/sg_z_act_query

SCSI utilities for Linux, Unix and Windows

From sg3-utils 1.49-r3 (enterprise-packages), captured 2026-11-08 by running sg_z_act_query --help (exit 0). permalink

Usage: sg_z_act_query [--activate] [--all] [--force] [--help] [--hex]
                      [--inhex=FN] [--maxlen=LEN] [--num=ZS] [--other=ZDID]
                      [--query] [--raw] [--verbose] [--version]
                      [--zone=ID] DEVICE
  where:
    --activate|-A      do ZONE ACTIVATE command (def: ZONE QUERY)
    --all|-a           sets the ALL flag in the cdb
    --force|-f         bypass some sanity checks
    --help|-h          print out usage message
    --hex|-H           print out response in hexadecimal
    --inhex=FN|-i FN    decode contents of FN, ignore DEVICE
    --maxlen=LEN|-m LEN    LEN place in cdb's allocation length field
                           (def: 8192 (bytes))
    --num=ZS|-n ZS     ZS is the number of zones and is placed in the cdb;
                       default value is 1, ignored if --all given
    --other=ZDID|-o ZDID    ZDID is placed in Other zone domain ID field
    --query|-q         do ZONE QUERY command (def: ZONE QUERY)
    --raw|-r           output response in binary, or if --inhex=FN is
                       given, then FN's contents are binary
    --verbose|-v       increase verbosity
    --version|-V       print version string and exit
    --zone=ID|-z ID    ID is the starting LBA of the zone (def: 0)

Performs either a SCSI ZONE ACTIVATE command, or a ZONE QUERY command.
Arguments to options are decimal by default, for hex use a leading '0x'
or a trailing 'h'. The default action is to send a ZONE QUERY command.
Options (14)
OptionDescriptionSource
--inhex, -i FN|-iwhere FN is a file name whose contents are assumed to be ASCII hexadecimal.help + man
--maxlen, -m LEN|-mLEN place in cdb's allocation length field (def: 8192 (bytes))help + man
--num, -n ZS|-nwhere ZS is placed in the "Number of zones" field in the cdb.help + man
--other, -o ZDID|-owhere the ZDID value will be placed in the "Other zone domain ID" field of the cdb to be sent to the DEVICE.help + man
--zone, -z ID|-zwhere ID is placed in the cdb's ZONE ID field.help + man
-A, --activatesends a ZONE ACTIVATE command to the DEVICE. (in the manual page but not in --help)man
-a, --allsets the ALL field in the cdb. (in the manual page but not in --help)man
-f, --forcewhen decoding the response to this command, certain sanity checks are done and if they fail a message is sent to stderr and a non-zero exit status is set. (in the manual page but not in --help)man
-h, --helpoutput the usage message then exit. (in the manual page but not in --help)man
-H, --hexoutput the response in hexadecimal to stdout. (in the manual page but not in --help)man
-q, --querycauses the ZONE QUERY command to be sent to the DEVICE. (in the manual page but not in --help)man
-r, --rawoutput response in binary (to stdout) unless the --inhex=FN option is also given. (in the manual page but not in --help)man
-v, --verboseincrease the level of verbosity, (i.e. debug output). (in the manual page but not in --help)man
-V, --versionprint the version string and then exit. (in the manual page but not in --help)man
Exit status (1) from the manual page
0it is successful

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.