sg_copy_results (8) - Linux Manuals
sg_copy_results: send SCSI RECEIVE COPY RESULTS command (XCOPY related)
NAMEsg_copy_results - send SCSI RECEIVE COPY RESULTS command (XCOPY related)
SYNOPSISsg_copy_results [--failed|--params|--receive|--status] [--help] [--hex] [--list_id=ID] [--verbose] [--version] [--xfer_len=BTL] DEVICE
This utility is designed to query the status of the SCSI Extended Copy (XCOPY) facility (see SPC-3 revision 23 sections 6.3 and 6.17), present in some modern storage arrays. This utility sends a SCSI RECEIVE COPY RESULTS command to the given DEVICE and displays the response.
During the draft stages of SPC-4 the T10 committee has expanded the XCOPY command so that it now has two variants: "LID1" (for a List Identifier length of 1 byte) and "LID4" (for a List Identifier length of 4 bytes). This utility supports the older, LID1 variant which is also found in SPC-3 and earlier. While the LID1 variant in SPC-4 is command level (binary) compatible with XCOPY as defined in SPC-3, some of the command naming has changed. This utility uses the older, SPC-3 XCOPY names.
The command has four distinct modes of operation, distinguished by the service action field:
- COPY STATUS
- Displays the current status of the EXTENDED COPY command identified by the list id field.
- RECEIVE DATA
- Return the held data read by the EXTENDED COPY command identified by the list id field. This option is only meaningful if the respective segment descriptor are supported.
- OPERATING PARAMETERS
- Return copy manager operating parameters. This option is also useful to determine if the SCSI Extended Copy facility is supported.
- FAILED SEGMENT DETAILS
Return copy target device sense data and other information about any
OPTIONSArguments to long options are mandatory for short options as well.
- -f, --failed
- sets the service action field to FAILED SEGMENT DETAILS .
- -h, --help
- output the usage message then exit.
- -H, --hex
- prints out the response buffer in hex.
- -l, --list_id=ID
- sets the list identifier field to ID (default: 0).
- -p, --params
- sets the service action field to OPERATING PARAMETERS . This is the default.
- -r, --receive
- sets the service action field to RECEIVE DATA .
- -s, --status
- sets the service action field to COPY STATUS .
- -v, --verbose
- increase the level of verbosity, (i.e. debug output).
- -V, --version
- print the version string and then exit.
- -x, --xfer_len=BTL
- sets the allocation length field to BTL. It is the byte transfer length and is the maximum (byte) size of the response. BTL must be less than 10000 and defaults to 520.
NOTESDecoding of RECEIVE DATA service action is not implemented.
EXAMPLESQuery the operating parameters for a device:
# sg_copy_results -p /dev/sdo
Receive copy results (report operating parameters):
EXIT STATUSThe exit status of sg_copy_results is 0 when it is successful. Otherwise see the sg3_utils(8) man page.
AUTHORSWritten by Douglas Gilbert.
REPORTING BUGSReport bugs to <dgilbert at interlog dot com>.
COPYRIGHTCopyright © 2012-2013 Hannes Reinecke and Douglas Gilbert
This software is distributed under a FreeBSD license. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.