SCIOTRAM (诊断) SCSI 适配器设备驱动程序 ioctl 操作

用途

提供用于发出各种适配器命令以测试卡 DMA 接口和缓冲区 RAM 的方法。

描述

SCIOTRAM 操作使调用者能够发出各种适配器命令来测试卡 DMA 接口和缓冲区 RAM。 对于 SCIOTRAM 操作, 阿尔格 参数块是 sc_ram_test 结构。 此结构在 /usr/include/sys/scsi.h 文件中定义,并包含以下信息:

  • 指向读/写测试模式缓冲区的指针
  • 缓冲区的长度。
  • 指示是请求读操作还是写操作的选项字段
    注: SCSI 适配器设备驱动程序不负责将读取数据与先前写入的数据进行比较。 在成功完成 操作之后,调用者将负责执行比较测试以确定此测试的最终成功或失败。

SCSI 适配器设备驱动程序在执行此操作期间不执行内部重试或其他错误恢复过程。 运行此命令时禁止错误日志记录。

返回值

成功完成后,此操作将返回值 0。 否则,将返回 -1 值,并将 errno 全局变量设置为以下值之一:

描述
EIO 指示适配器设备驱动程序已检测到错误。 特定适配器状态将在 sc_ram_test 参数块中返回。 SCIOTRAM 操作是诊断命令,因此,此错误不会记录在系统错误日志中。
ENXIO 指示选择的操作或子选项在此适配器上不受支持。 不应将此操作视为错误。 调用者必须先检查此返回值 (在其他 错误号 值之前) ,以避免将此错误用于失败的命令。
ETIMEDOUT 指示适配器在传递的命令超时值到期之前未以状态进行响应。 SCIOTRAM 操作是诊断命令,因此不会将此错误记录在系统错误日志中。

文件

描述
/dev/scsi0/dev/scsi1.../dev/scsin 提供一个接口以允许 SCSI 设备驱动程序访问 SCSI 设备或适配器。