s2pexec

NAME
SYNOPSIS
DESCRIPTION
NOTES
OPTIONS
EXAMPLE
SEE ALSO

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] [−-buffer-size/-b BUFFER_SIZE] [−-log-level/-L LOG_LEVEL] {−-binary-input-file/-f FILE] {−-binary-output-file/-F FILE] {−-hex-input-file/-t FILE] {−-hex-output-file/-T FILE] {−-timeout/ TIMEOUT] [−-no-request-sense/-n] [−-hex-only/] [−-help/-H] [−-version/-v]

DESCRIPTION

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

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

SCSI ID used by s2pexec. If not specified, s2pexec will use the board (initiator) ID 7. Not relevant for SASI.

−-cdb/-c CDB

Command block to send in hexecimal format. Hexadecimal numbers may be separated by a colon.

−-buffer-size/-b BUFFER_SIZE

Buffer size for receiving data, the default is 4096 bytes. When sending data the buffer is automatically sized to match the size of data to be sent.

−-log-level/-L LOG_LEVEL

Set the log level (trace, debug, info, warning, error, off). The default log level is ’info’.

−-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/ TIMEOUT

The command timeout in seconds, default is 3 seconds. Operations like formatting usually take longer.

−-no-request-sense

Do not automatically send REQUEST SENSE after an error to get the sense data.

−-hex-only

Do not display/save the offsets and the ASCI representantion of the received data.

−-help/-H

Show a help text.

−-version/-v

Show the s2pexec version.

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.

SEE ALSO

s2p(1), s2pctl(1), s2pdump(1), s2pproto(1)

Also see <https://www.scsi2pi.net> and <https://github.com/uweseimet/scsi2pi>.