SCIOTRAM (Diagnostic) SCSI Adapter Device Driver ioctl Operation

Purpose

Provides the means to issue various adapter commands to test the card DMA interface and buffer RAM.

Description

The SCIOTRAM operation allows the caller to issue various adapter commands to test the card DMA interface and buffer RAM. The arg parameter block to the SCIOTRAM operation is the sc_ram_test structure. This structure is defined in the /usr/include/sys/scsi.h file and contains the following information:

A pointer to a read or write test pattern buffer
The length of the buffer
An option field indicating whether a read or write operation is requested
Note: The SCSI adapter device driver is not responsible for comparing read data with previously written data. After successful completion of write or read operations, the caller is responsible for performing a comparison test to determine the final success or failure of this test.

The SCSI adapter device driver performs no internal retries or other error recovery procedures during execution of this operation. Error logging is inhibited when running this command.

Return Values

When completed successfully, this operation returns a value of 0. Otherwise, a value of -1 is returned and the errno global variable is set to one of the following values:

Value	Description
EIO	Indicates that the adapter device driver detected an error. The specific adapter status is returned in the sc_ram_test parameter block. The SCIOTRAM operation is a diagnostic command and, as a result, this error is not logged in the system error log.
ENXIO	Indicates that the operation or suboption selected is not supported on this adapter. This should not be treated as an error. The caller must check for this return value first (before other errno values) to avoid mistaking this for a failing command.
ETIMEDOUT	Indicates the adapter did not respond with status before the passed command time-out value expired. The SCIOTRAM operation is a diagnostic command, so this error is not logged in the system error log.

Files

Item	Description
/dev/scsi0, /dev/scsi1,..., /dev/scsin	Provide an interface to allow SCSI device drivers to access SCSI devices or adapters.