[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

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:

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:

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

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

Related Information

The rmt SCSI device driver, scdisk SCSI device driver, SCSI Adapter device driver.


[ Previous | Next | Contents | Home | Search ]