sg_rtpg(8)

sg_rtpg8

Send scsi report target port groups command

Usage

sg_rtpg [--decode] [--help] [--hex] [--raw] [--readonly] [--verbose] [--version] DEVICE

Overview

Send a SCSI REPORT TARGET PORT GROUPS command to DEVICE and outputs the response.

Target port group access is described in SPC-3 and SPC-4 found at www.t10.org . The most recent draft of SPC-4 is revision 37 in which target port groups are described in section 5.15 .

Options

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

-d, --decode

decodes the status code and asymmetric access state from each target port group descriptor returned. The default action is not to decode these values.

-e, --extended

use extended header format for parameter data. This sets the PARAMETER DATA FORMAT field in the cdb to 1.

-h, --help

output the usage message then exit.

-H, --hex

output response in hex (rather than partially or fully decode it).

-r, --raw

output response 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.

-v, --verbose

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

-V, --version

print the version string and then exit.

Notes

The Report Target Port Groups command should be supported whenever the TPGS bits in a standard INQUIRY response are greater than zero. [View with sg_inq utility.]

Exit status

The exit status of sg_rtpg is 0 when it is successful. Otherwise see the sg3_utils(8) man page.

Releases

11 releases since Debian 4.0 (Etch); the text changed 4 times.

  1. 4.0
  2. 5.0
  3. 6.0–7
  4. 8–12
  5. 13–Arch

--extended since Debian 8 (Jessie); --raw since Debian 5.0 (Lenny); --readonly since Debian 8 (Jessie); -R since Debian 8 (Jessie); -e since Debian 8 (Jessie); -r since Debian 5.0 (Lenny).

Authors

Written by Douglas Gilbert.

Reporting bugs

Report bugs to <dgilbert at interlog dot com>.

From sg3_utils 1.49-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.