scdisk SCSI 设备驱动程序

仅当目标设备当前未打开时，才能以诊断方式打开该设备。 如果尝试在诊断模式下打开设备，而目标设备已经打开，则子程序返回 -1 值，并将 errno 全局变量设置为 EACCES 值。

仅当设备当前未打开时，才能以互斥存取方式打开该设备。 如果尝试在独占访问模式下打开设备，而设备已经打开，则子例程返回 -1 值，并将 errno 全局变量设置为 EBUSY 值。 如果 SC_DIAGNOSTIC 标志与 SC_SINGLE 标志一起指定，那么设备将处于 "诊断" 方式。

提供了 DKIOWRSE 操作以供诊断使用。 当目标设备在活动系统环境中运行时，它允许有限使用该设备。 DKIOWRSE 操作中的 阿尔格 参数包含 sc_rdwrt 结构的地址。 此结构在 /usr/include/sys/scsi.h 文件中定义。

开发信息 结构定义了 写 操作的最大传输大小。 如果试图传输的数据超过最大值，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 请参阅 小型计算机系统接口 (SCSI) 规范 ，以了解特定设备的请求检测数据的格式。

1. page_code 和 subpage_code (对于请求的日志页面)
2. 和平与发展 设置为值 CUMUL_VAL。
3. 分配长度 -如果此字段设置为零，那么将仅返回由 页代码 和日志页长度组成的日志页头。 如果此字段为非零值，那么它必须等于日志页的长度 (不包括大小为 4 字节的日志页头)。 如果用户指定的分配长度小于实际日志页长度，那么将仅返回所请求的日志数据长度。
4. log_data 包含已分配的内存地址，用于存储从 ioctl 操作返回的数据。

如果请求的日志页面是 SCSI_BSR_LOG_PAGE (在 /usr/include/sys/scsi.h中定义) ，那么 log_data 指向调用者分配的 struct sc_bsr_log_data 。 调用者还会为 struct sc_bms_log_data 分配内存，以使分配给 struct sc_bms_log_data 的 sizeof struct sc_bsr_log_data 和内存的总量等于 分配长度。

否则 (对于除 SCSI_BSR_LOG_PAGE之外的日志页) ，它将指向等于 分配长度的内存块。

以下是用于填充 sc_log_sense 结构的示例代码:

struct sc_log_sense log_sense;

melog_sense, '\0', sizeof(struct sc_log_sense));
log_sense.page_code = SCSI_BSR_LOG_PAGE ;
log_sense.subpage_code = 0; 
log_sense.pc = CUMUL_VAL;
log_sense.allocation_length = 16; 
if (log_sense.allocation_length) 
 {  
 if (log_sense.page_code == SCSI_BSR_LOG_PAGE)
  {    
   log_sense.log_data = (struct sc_bsr_log_data *) malloc(sizeof(struct sc_bsr_log_data));  
  }
  else 
  { 
   log_sense.log_data = (char *) malloc(log_sense.allocation_length); 
  }      
  if (log_sense.log_data == NULL)   
  exit(-1); 
  if (log_sense.page_code == SCSI_BSR_LOG_PAGE)
  {
   bms_param_len = log_sense.allocation_length - sizeof(struct sc_scan_status);
   ((struct sc_bsr_log_data *)(log_sense.log_data))-> bms_log_data = (struct sc_bms_log_data *)
	 malloc(bms_param_len); 
  if (((struct sc_bsr_log_data *)(log_sense.log_data))-> bms_log_data == NULL)
  exit(-1);
  }
 }
 rc = ioctl(fd, DKLOGSENSE,&log_sense);

提供了发出 日志 SELECT 命令的方法。

struct sc_log_select log_select;

memset(&log_select, '\0', sizeof(struct sc_log_select));
log_select.page_code = SCSI_BSR_LOG_PAGE;
log_select.subpage_code = 0;
log_select.pcr = 1;
log_select.sp = 0;
log_select.pc = CUMUL_VAL;
log_select.param_length = 0;
if (log_select.param_length) 
{
 log_select.log_data = (char *)malloc(log_select.param_length);
 if (log_select.log_data == NULL) exit(-1);
} 
rc = ioctl(fd, DKLOGSELECT,&log_select);   

如果在 CD-ROM 以外的设备上尝试此操作，那么会将其解释为 DKiordse 操作。 在此情况下， 阿尔格 参数将被视为 sc_rdwrt 结构。

如果在未处于诊断模式的设备上尝试 CDIOCMD 操作，子例程将返回 -1 值，并将 errno 全局变量设置为 EACCES 值。 请参阅 小型计算机系统接口 (SCSI) 规范 ，以了解特定设备的请求检测数据的格式。

提供了 DKiordse 操作以供诊断使用。 当目标设备在活动系统环境中运行时，它允许有限使用该设备。 DKiordse 操作中的 阿尔格 参数包含 sc_rdwrt 结构的地址。 此结构在 /usr/include/sys/scsi.h 文件中定义。

开发信息 结构定义了 读 操作的最大传输大小。 如果试图传输的数据超过最大值，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 请参阅 小型计算机系统接口 (SCSI) 规范 ，以了解特定设备的请求检测数据的格式。

SCSI 状态字节和适配器状态字节通过 arg 参数返回，该参数包含 sc_iocmd 结构 (在 /usr/include/sys/scsi.h 文件中定义) 的地址。 如果 DKIOCMD 操作失败，子例程将返回 -1 值，并将 errno 全局变量设置为非零值。 在此情况下，调用者必须对返回的状态字节进行求值，以确定操作失败的原因以及必须执行的恢复操作。

开发信息 结构定义了该命令的最大传输大小。 如果试图传输的数据超过最大值，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 请参阅 小型计算机系统接口 (SCSI) 规范 ，以了解特定设备的请求检测数据的格式。

如果此操作的 阿尔格 参数为空，那么格式单元会将有效 (FOV) 位的格式选项 0 为 0 (即，它使用磁带机的缺省设置)。 如果 DKFORMAT 操作的 阿尔格 参数不为空，那么缺陷列表头的第一个字节将设置为由 阿尔格 参数指定的第一个字节中指定的值。 它允许创建应用程序，以唯一地格式化特定类型的读/写光学介质。

驱动程序最初尝试将 FmtData 和 CmpLst 位设置为 0。 如果此操作失败，那么驱动程序将尝试这些位的其余 3 个排列。 如果所有四个排列都失败，那么此操作将失败，并且子例程会将 errno 全局变量设置为值 EIO。

如果为硬盘指定了 DKFORMAT 操作，则子例程返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 如果在设备未处于独占访问模式时尝试 DKFORMAT 操作，子例程将返回 -1 值，并将 errno 全局变量设置为 EACCES 值。 如果介质受写保护，子程序将返回 -1 值，并将 errno 全局变量设置为 EWRPROTECT 值。 如果格式化单元超过超时值，子例程将返回 -1 值，并将 errno 全局变量设置为 ETIMEDOUT 值。 如果操作失败，子程序将返回 -1 值，并将 errno 全局变量设置为 EIO 值。

如果在设备的音频支持属性设置为 "否 "时尝试 DKAUDIO 操作，子例程将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 如果 DKAUDIO 操作失败，子程序将返回 -1 值，并将 errno 全局变量设置为非零值。 在此情况下，调用者必须对返回的状态字节进行求值，以确定操作失败的原因以及必须执行的恢复操作。

CD-ROM 数据方式 1

通过原始 (dev/rcd*) 和块特殊 (/dev/cd*) 文件的 512 字节块大小

CD-ROM 数据方式 2 表单 1

2048 字节的块大小 (通过原始 (dev/rcd*) 和块特殊 (/dev/cd*) 文件)

CD-ROM 数据方式 2 表单 2

仅通过原始 (dev/rcd*) 特殊文件的 2336 字节块大小

光盘 (紧凑光盘数字音频)

仅通过原始 (dev/rcd*) 特殊文件的 2352 字节块大小

DVD-ROM

2048 字节的块大小 (通过原始 (/dev/rcd *) 和块特殊 (/dev/cd *) 文件)

DVD-RAM

2048 字节的块大小 (通过原始 (/dev/rcd *) 和块特殊 (/dev/cd *) 文件)

DVD-RW

2048 字节的块大小 (通过原始 (/dev/rcd *) 和块特殊 (/dev/cd *) 文件)

DK_CD_MODE arg 参数包含 /usr/include/sys/scdisk.h 文件中定义的 mode_form_op 结构的地址。 要让 DK_CD_MODE 操作确定或更改 CD-ROM 数据方式，请将actionchange_mode_form 结构的字段为下列其中一个值:

CD_GET_MODE

返回当前 CD-ROM 数据方式 (在cd_mode_formmode_form_op 结构的字段 (在成功打开设备时)。

CD_CHG_MODE

将 CD-ROM 数据方式更改为指定的方式。cd_mode_formmode_form_op 结构的字段，在互斥存取方式下成功打开设备时。

如果未针对不同数据方式配置 CD-ROM (通过方式-选择密度代码) ，并且尝试更改 CD-ROM 数据方式 (通过设置actionchange_mode_form结构的字段设置为 CD_CHG_MODE），子例程将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 将 CD-ROM 模式更改为任何 DVD 模式的尝试也会导致 -1 返回值和 errno 全局变量设置为 EINVAL 。

如果在设备不处于独占访问模式时尝试 DK_CD_MODE 的 CD_CHG_MODE 操作，子例程将返回 -1 值，并将 errno 全局变量设置为 EACCES 值。 如果操作失败，子程序将返回 -1 值，并将 errno 全局变量设置为 EIO 值。

SCSI 状态字节和适配器状态字节通过 arg 参数返回，该参数包含 sc_passthru 结构 (在 /usr/include/sys/scsi.h 文件中定义) 的地址。 如果 DK_PASSTHRU 操作失败，子例程将返回 -1 值，并将 errno 全局变量设置为非零值。 如果发生这种情况，那么调用者必须对返回的状态字节进行求值，以确定操作不成功的原因以及必须执行的恢复操作。

DK_PASSTHRU 操作将进一步细分为在发出请求之前停顿其他 I/O 请求的请求以及不停顿 I/O 请求的请求。 这些子部分基于 sc_passthru 结构的 devflags 字段。 当 sc_passthru 结构的 devflags 字段的值为 SC_MIX_IO时， DK_PASSTHRU 操作将与其他 I/O 请求混合执行。 禁止将数据写入设备的 SC_MIX_IO 请求，并且这些请求将失败。 当出现这种情况时，将返回 -1 并将 errno 全局变量设置为 EINVAL 。 如果 sc_passthru 结构的 devflags 字段的值为 SC_QUIESCE_IO，那么在向设备发出 DK_PASSTHRU 请求之前，所有其他 I/O 请求都将停顿。 如果 SC_QUIESCE_IO 请求的 timeout_value 字段设置为 0，DK_PASSTHRU 请求将以 -1 返回代码失败，errno 全局变量将设置为 EINVAL ，参数 字段将设置为 SC_PASSTHRU_INV_TO 值（在 /usr/include/sys/scsi.h 文件中定义）。 如果SC_QUIESCE_IO请求的非零超时值对设备来说过大，DK_PASSTHRU请求将失败，返回代码为-1、errno 全局变量将被设置为 EINVAL, einval_arg 字段将被设置为 SC_PASSTHRU_INV_TO 值（定义在 /usr/include/sys/scsi.h文件中定义），timeout_value 将被设置为允许的最大值。

• 变量 _cdb_ptr 是指向包含 Variable SCSI cdb 的缓冲区的指针。
• variable_cdb_length 确定 变量 _cdb_ptr 字段所指向的 欧洲委员会 变量的长度。

请参阅 小型计算机系统接口 (SCSI) 规范 ，以了解特定设备的请求检测数据的格式。

成功打开设备后， DKPRES_READKEYS 操作将提供一种方法来读取设备上的持久性预留注册密钥。 DKPRES_READKEYS 的 阿尔格 参数将包含 dk_pres_in 结构的地址。 此结构在 /usr/include/sys/scdisk.h中定义。 用户必须提供要返回的已注册密钥的缓冲区和大小。 返回长度 变量用于设置返回的字节数。

在共享访问或集群环境中，此操作标识特定 LUN 的所有已注册密钥。

成功打开设备后， DKPRES_READRES 操作将提供一种方法来读取设备上的持久预留保留密钥。 DKPRES_READKEYS 的 阿尔格 参数将包含 dk_pres_in 结构的地址。 此结构在 /usr/include/sys/scdisk.h中定义。 用户必须提供要返回的预留信息的缓冲区和大小。 返回长度 变量用于设置返回的字节数。 在共享访问权或集群环境中，此操作将标识持有保留的主发起方。

在成功打开设备后， DKPRES_CLEAR 操作将提供一种方法来清除设备上的所有持久性预留密钥和注册密钥。 DKPRES_CLEAR 的 阿尔格 参数将包含 dk_pres_clear 结构的地址。 此结构在 /usr/include/sys/scdisk.h中定义。

成功打开设备后， DKPRES_PREEMPT 操作将提供一种方法来抢占设备上的 "持久预留密钥" 或 "注册密钥"。 DKPRES_PREEMPT 的 阿尔格 参数将包含 dk_pres_prepete 结构的地址。 此结构在 /usr/include/sys/scdisk.h中定义。 用户必须在要抢占的设备上提供第二个参与方发起方密钥。 如果第二方发起方持有对设备的保留，那么发出抢占的发起方将成为该保留的所有者。 否则，将撤销第二方发起方访问权。

要使此操作成功，必须先向设备注册启动器，然后才能执行任何抢占。 在共享访问或集群环境中，此操作用于抢占任何可操作或不可操作的发起方，或者任何未被识别为共享组的一部分的发起方。

此操作与 DKPRES_PREEMPT相同，但设备在异常终止属于被抢占的发起方的任务时遵循 SCSI 主命令规范。

当设备成功打开时， DKPRES_REGISTER 操作将提供向设备注册密钥的方法。 密钥从 ODM 定制属性中抽取，并在配置期间传递到设备驱动程序。 DKPRES_REGISTER 的 阿尔格 参数将包含 dk_pres_register 结构的地址。 此结构在 /usr/include/sys/scdisk.h中定义。

在共享访问或集群环境中，此操作将尝试向设备注册，然后进行读保留以确定设备是否已保留。 如果未保留该设备，那么会随该设备一起放置预留。

arg 参数包含 sc_rwbuffer 结构的地址 (在 /usr/include/sys/scsi.h 文件中定义)。 在调用 DK_RWBUFFER ioctl 之前，必须根据必需的行为来设置此结构的字段。 模式 字段对应于 SCSI 主命令 (SPC) 规范中所定义的 SCSI 命令描述符块 (CDB) 的 模式 字段。 受支持的方式列示在头文件 /usr/include/sys/scsi.h中。

设备驱动程序会停顿来自发出写缓冲区 ioctl 的发起方的所有其他 I/O 请求，直到整个操作完成为止。 一旦写缓冲区 ioctl 完成，所有已停顿的 I/O 请求都将恢复。

SCSI 状态字节和适配器状态字节通过 arg 参数返回，该参数包含 sc_rwbuffer 结构 (在 /usr/include/sys/scsi.h 文件中定义) 的地址。 如果 DK_RWBUFFER 操作失败，子例程将返回 -1 值，并将 errno 全局变量设置为非零值。 在此情况下，调用者必须对返回的状态字节进行求值，以确定操作失败的原因以及必须执行的恢复操作。

如果 DK_RWBUFFER 操作因 sc_rwbuffer 结构中的字段值无效而失败，子例程将返回 -1 值，并将 errno 全局变量设置为 EINVAL 。

DK_RWBUFFER ioctl 允许用户通过一次 ioctl 调用向设备发出多条 SCSI 写缓冲区命令 (CDB)。 对于用户提供指向整个微码映像的指针的应用程序 (例如微码下载) ，它很有用，但是由于设备缓冲区的大小限制，希望在整个下载完成之前将映像发送到片段中。

如果在 sc_rwbuffer struct 的 fragment_size 成员等于 数据长度的情况下调用 DK_RWBUFFER ioctl ，那么将向设备发出单个 "写缓冲区" 命令，并且将 SCSI CDB 的 缓冲区偏移量 和 缓冲区标识 设置为 sc_rwbuffer struct 中提供的值。

如果 数据长度 大于 fragment_size ，并且 fragment_size 为非零值，那么将向设备发出多个写缓冲区。 通过将 数据长度 除以必需的 fragment_size来计算发出的写缓冲区命令 (SCSI CDB) 的数量。 如果 数据长度 不是 fragment_size的偶数倍，那么此值将递增 1 ，并且最终数据传输的大小是此残差值的大小。 对于发出的每个 "写入缓冲区" 命令， 缓冲区偏移量 将设置为 sc_rwbuffer struct 中提供的值 (SCSD 设备的微码下载要求将此值设置为 0)。

如果 fragment_size 设置为零，那么将返回 EINVAL 的 错误号 。 如果希望使用一个 SCSI 写缓冲区命令来发送整个缓冲区，那么必须将此字段设置为等于 数据长度。 如果 fragment_size 大于 数据长度，那么也会返回 EINVAL 错误。

"参数列表长度" (fragment_size) 加上 "缓冲区偏移量" 不能超过设备的指定缓冲区的容量。 "写入缓冲区" ioctl 的调用者负责确保 fragment_size 设置满足此需求。 大于设备的 fragment_size 会导致设备发生 SCSI 错误，并且 "写缓冲区" ioctl 会报告此错误，但不执行任何操作以进行恢复。

开发信息 结构定义了该命令的最大传输大小。 如果尝试传输的大小超过最大传输大小，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 请参阅 小型计算机系统接口 (SCSI) 规范 ，以了解特定设备的请求检测数据的格式。

• 尝试打开当前以 "诊断" 或 "互斥访问" 方式打开的设备。
• 已尝试在已打开的设备上打开诊断方式会话。
• 用户在处于诊断方式时尝试了除 ioctl 或 关闭 子例程之外的子例程。
• 在未处于诊断方式的设备上尝试了 DKIOCMD 或 CDIOCMD 操作。
• 在未处于互斥访问方式的设备上尝试了 DK_CD_MODE ioctl 子例程操作。
• 在未处于 "互斥访问" 方式的设备上尝试了 DKFORMAT 操作。

• 已尝试在已打开的设备上以 "互斥访问" 方式打开会话。
• 目标设备由另一个发起方保留。

• 对于未配置为使用 SCSI-2 播放音频命令的设备，已尝试执行 DKAudio (play-audio) 操作。
• 读 或 写 子例程提供了 nbyte 参数，该参数不是块大小的偶数倍。
• 对于 CDIORDSE， DKIOWRSE或 DKiordse ioctl 子例程操作，大于 255 个字节的检测数据缓冲区长度无效。
• 对于 CDIORDSE， CDIOCMD， DKiordse， DKIOWRSE或 DKIOCMD ioctl 子例程操作，数据缓冲区长度超过了 开发信息 结构中定义的最大值。
• 尝试了不受支持的 ioctl 子例程操作。
• 对于 CDIOCMD ioctl 子例程操作，大于 CD-ROM 驱动器所允许长度的数据缓冲区长度是无效的。
• 已尝试配置仍处于打开状态的设备。
• 给出了不正确的配置命令。
• 已向不支持可移动介质的设备发送 DKPMR (阻止介质除去) ， DKAMR (允许介质除去) 或 DKEJECT (弹出介质) 命令。
• DKEJECT (弹出介质) 命令已发送到当前将其介质锁定在磁带机中的设备。
• 数据缓冲区长度超过了为 策略 操作定义的最大值。

• 找不到目标设备或目标设备未响应。
• 目标设备指示不可恢复的硬件错误。

• 目标设备指示不可恢复的介质错误。
• 媒体已更改。

• 尝试了访问未定义的设备。
• 已尝试关闭未定义的设备。

• ioctl 子例程提供了无效参数。
• 已尝试在硬盘结束之后执行 读 或 写 操作。

• 在只读介质上尝试了请求 读/写 方式的 开 操作。
• 已尝试对只读介质执行 写 操作。

• 0000 ，它指示必须执行问题确定过程
• 1601 ，它指示必须更换并重试可移动介质

• 5000 ，指示介质发生故障
• 6310 ，表示磁盘驱动器发生故障

• 0000 ，它指示必须执行问题确定过程
• 1601 ，它指示必须更换可移动介质并重试

注意：

该Detail_Dataerr_rec 结构中的字段包含 sc_error_log_df 结构。 err_rec 结构在 /usr/include/sys/errids.h 文件中定义。 sc_error_log_df 结构在 /usr/include/sys/scsi.h 文件中定义。

sc_error_log_df 结构中包含以下字段:

req_sense_data

包含来自发生错误的特定设备的请求检测信息 (如果此信息有效)。

reserved2

包含段计数，它是在发生错误时从设备读取的兆字节数。

reserved3

包含自最近一次增加段计数以来读取的字节数。

• 6310 ，表示磁盘驱动器发生故障
• 6330 ，指示磁盘驱动器电子部件发生故障

注意：

该Detail_Dataerr_rec 结构中的字段包含 sc_error_log_df 结构。 err_rec 结构在 /usr/include/sys/errids.h 文件中定义。 sc_error_log_df 结构在 /usr/include/sys/scsi.h 文件中定义。

sc_error_log_df 结构中包含以下字段:

req_sense_data

包含来自发生错误的特定设备的请求检测信息 (如果此信息有效)。

reserved2

包含段计数，它是在发生错误时从设备读取的兆字节数。

reserved3

包含自最近一次增加段计数以来读取的字节数。

• 3452 ，指示设备电缆发生故障
• 6310 ，表示磁盘驱动器发生故障

• 3452 ，指示存储设备电缆发生故障
• 6310 ，表示磁盘驱动器发生故障
• 6330 ，指示磁盘驱动器的电子故障

注意：

该Detail_Dataerr_rec 结构中的字段包含 sc_error_log_df 结构。 err_rec 结构在 /usr/include/sys/errids.h 文件中定义。 sc_error_log_df 结构在 /usr/include/sys/scsi.h 文件中定义。

sc_error_log_df 结构中包含以下字段:

req_sense_data

包含来自发生错误的特定设备的请求检测信息 (如果此信息有效)。

reserved2

包含段计数，它是在发生错误时从设备读取的兆字节数。

reserved3

包含自最近一次增加段计数以来读取的字节数。

• 5000 ，指示介质发生故障
• 6310 ，表示磁盘驱动器发生故障

• 0000 ，它指示必须执行问题确定过程
• 1601 ，它指示必须更换可移动介质并重试

• 5000 ，指示介质发生故障
• 6310 ，表示磁盘驱动器发生故障

• 0000 ，它指示必须执行问题确定过程
• 1601 ，它指示必须更换可移动介质并重试

注意：

该Detail_Dataerr_rec 结构中的字段包含 sc_error_log_df 结构。 err_rec 结构在 /usr/include/sys/errids.h 文件中定义。 sc_error_log_df 结构在 /usr/include/sys/scsi.h 文件中定义。

sc_error_log_df 结构中包含以下字段:

req_sense_data

包含来自发生错误的特定设备的请求检测信息 (如果此信息有效)。

reserved2

包含段计数，它是在发生错误时从设备读取的兆字节数。

reserved3

包含自最近一次增加段计数以来读取的字节数。

• 3300 (指示适配器故障)
• 5000 ，指示介质发生故障
• 6310 ，表示磁盘驱动器发生故障

• 0000 ，它指示必须执行问题确定过程
• 1601 ，它指示必须更换可移动介质并重试

注意：

该Detail_Dataerr_rec 结构中的字段包含 sc_error_log_df 结构。 err_rec 结构在 /usr/include/sys/errids.h 文件中定义。 sc_error_log_df 结构在 /usr/include/sys/scsi.h 文件中定义。

sc_error_log_df 结构中包含以下字段:

req_sense_data

包含来自发生错误的特定设备的请求检测信息 (如果此信息有效)。

reserved2

包含段计数，它是在发生错误时从设备读取的兆字节数。

reserved3

包含自最近一次增加段计数以来读取的字节数。