s2pexec

Section: User Commands (1)
Index

NAME

s2pexec - SCSI2Pi SCSI/SASI command executor

SYNOPSIS

s2pexec [--scsi-target/-i ID[:LUN]] [--sasi-target/-h ID[:LUN]] [--board-id/-B BOARD_ID] [--cdb/-c CDB[:CDB:...]] [--data/-d DATA] [--buffer-size/-b BUFFER_SIZE] [--log-level/-L LEVEL] [--log-limit/-l LIMIT] {--binary-input-file/-f FILE] {--binary-output-file/-F FILE] {--hex-input-file/-t FILE] {--hex-output-file/-T FILE] {--timeout/-o TIMEOUT] [--request-sense/-R] [--reset-bus/-r] [--hex-only/] [--help/-H] [--version/-v]

DESCRIPTION

s2pexec sends SCSI or SASI commands to a device and displays the results.

When launched without arguments s2pexec enters interactive mode, where you can enter commands on the command line. Like with the bash shell, "!!" repeats the last command. In interactive mode the target, initiator and log level settings are preserved between command invocations.

NOTES

s2pexec helps with advanced testing. The board s2pexec is running on must be a FULLSPEC board because s2pexec requires SCSI initiator support.

OPTIONS

--scsi-target/-i ID[:LUN]: ID and optional LUN (0-31) of the SCSI target device.
--sasi-target/-h ID[:LUN]: ID and optional LUN (0-1) of the SASI target device.
--board-id/-B BOARD_ID: Initiator ID used by s2pexec. If not specified, s2pexec will use the board (initiator) ID 7. Not relevant for SASI.
--cdb/-c CDB[:CDB:...]: Command blocks to send in hexecimal format. Hexadecimal numbers may be separated by a colon. s2pexec also accepts linked commands.
--data/-d DATA: Data to send with the command in hexedecimal format. These data are sent in the DATA OUT phase. If DATA starts with @, the remaining string is the name of a file in hexadecimal format to read the data from.
--buffer-size/-b BUFFER_SIZE: Buffer size for received data, the default is 131072 bytes. When sending data the buffer is automatically sized to match the size of data to be sent.
--log-level/-L LEVEL: Set the log level (trace, debug, info, warning, error, critical, off). The default log level is 'info'.
--log-limit/-l LIMIT: Limits the number of data bytes being logged, 0 means no limit. The default is 128.
--binary-input-file/-f FILE: Optional file with binary data to send in the DATA OUT phase.
--binary-output-file/-F FILE: Optional file for binary data received in the DATA IN phase.
--hex-input-file/-t FILE: Optional file with data in hexadecimal (human-readable) format to send in the DATA OUT phase.
--hex-output-file/-T FILE: Optional file for data received in the DATA IN phase. The data in this file are coded in hexadecimal (human-readable) format.
--timeout/-o TIMEOUT: The command timeout in seconds, default is 3 seconds. Operations like formatting may take much longer.
--request-sense/-R: Automatically send REQUEST SENSE after an error in order to get the sense data.
--reset-bus/-r: Reset the bus.
--hex-only: Do not display/save the offsets and the ASCII representantion of the received data.
--help/-H: Display a help text.
--version/-v: Display the s2pexec version.

EXIT STATUS

0: No error. -1: There was a general error and the command could not be sent. Any other value means the command could be sent but the target device reported an error. In this case the return status contains the additional sense code (ASC).

EXAMPLE

s2pexec -i 0 -c 12:00:00:00:20:00
Send an INQUIRY command to the device with SCSI ID 0 and display the results.

s2pexec -i 5 -c 15:11:00:04:0c:00 -t data.dat
Send a MODE SELECT command to the device with SCSI ID 5, with the hexadecimally coded data in data.dat as parameters.

s2pexec -i 5:1 -c 15:11:00:04:0c:00 -d 00:00:00:08:00:00:00:00:00:00:02:00
Send a MODE SELECT command to the device with SCSI ID 5 and LUN 1, with explicit parameter data.

This document was created by man2html, using the manual pages.