From b6bc9ee42522285a70bcb1a4b81f052cc1c08bf6 Mon Sep 17 00:00:00 2001 From: Douglas Gilbert Date: Wed, 19 Sep 2007 13:48:40 +0000 Subject: sg_stpg work, device_name simplification, restore sg_read_buffer to build git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@103 6180dd3e-e324-4e3e-922d-17de1ae2f315 --- doc/sg_stpg.8 | 35 ++++++++++++++++++++++++++++------- 1 file changed, 28 insertions(+), 7 deletions(-) (limited to 'doc/sg_stpg.8') diff --git a/doc/sg_stpg.8 b/doc/sg_stpg.8 index 02cc99fd..5b676e8b 100644 --- a/doc/sg_stpg.8 +++ b/doc/sg_stpg.8 @@ -1,4 +1,4 @@ -.TH SG_STPG "8" "August 2007" "sg3_utils\-1.25" SG3_UTILS +.TH SG_STPG "8" "September 2007" "sg3_utils\-1.25" SG3_UTILS .SH NAME sg_stpg \- sends a SCSI SET TARGET PORT GROUPS command .SH SYNOPSIS @@ -9,24 +9,46 @@ sg_stpg \- sends a SCSI SET TARGET PORT GROUPS command .SH DESCRIPTION .\" Add any additional description here .PP -Send a SCSI SET TARGET PORT GROUPS command to \fIDEVICE\fR. +Send a SCSI SET TARGET PORT GROUPS command to \fIDEVICE\fR. +.PP +A sequence of SCSI commands are sent to the \fIDEVICE\fR leading up to the +SET TARGET PORT GROUPS command. First a INQUIRY is sent to fetch the device +identification VPD page to find the (primary) target port group. Then a +REPORT TARGET PORT GROUPS command is issued to find the current state and +whether a transition to the requested state is supported. If so the +SET TARGET PORT GROUPS command is sent. .PP Target port group access is described in SPC\-4 found at www.t10.org in section 5.8 (in rev 11 dated 2007/5/14). The Set Target Port Groups command is also described in that document. .PP -xxxxxxxxxxxxxx Placeholder more to add xxxxxxxxxxxxxxxxxx .SH OPTIONS Arguments to long options are mandatory for short options as well. .TP +\fB\-a\fR, \fB\-\-active\fR +set active/non-optimized state. +.TP \fB\-h\fR, \fB\-\-help\fR output the usage message then exit. .TP \fB\-H\fR, \fB\-\-hex\fR -output response in hex (rather than partially or fully decode it). +output response to the REPORT TARGET PORT GROUPS command in hex then exit. +.TP +\fB\-o\fR, \fB\-\-optimized\fR +set active/optimized state. +.TP +\fB\-O\fR, \fB\-l\fR, \fB\-\-offline\fR +set active/non-optimized state. .TP \fB\-r\fR, \fB\-\-raw\fR -output response in binary to stdout. +output response to the REPORT TARGET PORT GROUPS command in binary to stdout +then exit. +.TP +\fB\-s\fR, \fB\-\-standby\fR +set standby state. +.TP +\fB\-u\fR, \fB\-\-unavailable\fR +set unavailable state. .TP \fB\-v\fR, \fB\-\-verbose\fR increase the level of verbosity, (i.e. debug output). @@ -35,8 +57,7 @@ increase the level of verbosity, (i.e. debug output). print the version string and then exit. .SH NOTES The Set 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.] +value in a standard INQUIRY response is 2 or 3. [View with sg_inq utility.] .SH EXIT STATUS The exit status of sg_stpg is 0 when it is successful. Otherwise see the sg3_utils(8) man page. -- cgit v1.2.3