USB 大容量存储客户机设备驱动程序

仅当当前未打开目标设备时，才能以 Diagnostic 方式打开设备。 如果在目标设备已打开的情况下以 Diagnostic 模式打开设备，子程序将返回 -1 值，并将 errno 全局变量设置为 EACCES 值。

仅当设备当前未打开时，才能以 Exclusive Access 方式打开该设备。 如果在 Exclusive Access 模式下打开设备，而设备已经打开，则子程序返回 -1 值，并将 errno 全局变量设置为 EBUSY 值。 如果 SC_DIAGNOSTIC 标志与 SC_SINGLE 标志一起指定，那么设备将处于 Diagnostic 方式。

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

devinfo 结构定义读操作的最大传输大小。 如果传输量超过最大限制，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。

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

devinfo 结构定义命令的最大传输大小。 如果传输量超过最大值，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。

    char sense_data[255];
    char *data_buffer=NULL;
    struct sc_iocmd sciocmd;
....

    fd = open("/dev/usbms0", O_RDWR);
    if (fd == -1){
        printf("\niocmd: Open FAIL\n");
        exit(-1);
    }

    memset(&sciocmd, '\0', sizeof(struct scsi_iocmd));
    sciocmd.version = SCSI_VERSION_1;
    sciocmd.timeout_value = 30;
    sciocmd.command_length = 6;
    sciocmd.flags = B_READ;
    sciocmd.autosense_length = 255;
    sciocmd.autosense_buffer_ptr = &sense_data[0];

    sciocmd.data_length = 0xFF;
    sciocmd.buffer = inq_data;
    sciocmd.scsi_cdb[0] = SCSI_INQUIRY;
    sciocmd.scsi_cdb[1] = 0x00; /* Standard Inquiry*/
    sciocmd.scsi_cdb[2] = 0x00;
    sciocmd.scsi_cdb[3] = 0x00;
    sciocmd.scsi_cdb[4] = 0xFF;
    sciocmd.scsi_cdb[5] = 0x00;

    if ((rc=ioctl(fd, DKIOCMD, &sciocmd)) != 0){
        printf("iocmd: Ioctl FAIL errno %d\n",errno);
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        hexdump(sense_data, (long)20);
        close(fd);
        exit(-1);
    } else {
        printf("cdiocmd : Ioctl PASS\n");
        if (cmd = SCSI_INQUIRY)
            hexdump(inq_data,0x20);
    }

    close(fd);

此 ioctl 操作类似于用于向 USB 海量存储设备发出 16 字节 SCSI 命令的 DKIOCMD16 操作。

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

在完成 DKIOLCMD ioctl 请求时，残差字段指示设备未完全满足此请求的剩余数据。 在成功完成时，剩余字段指示设备没有所请求的所有数据，或者设备的数据量小于所请求的数据量。 在请求失败时，必须检查 status_validity 字段以确定是否存在有效的 SCSI 总线问题。 在这种情况下，残差字段指示设备针对此请求未能完成的字节数。

devinfo 结构定义命令的最大传输大小。 如果传输量超过最大值，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。

    char sense_data[255];
    char *data_buffer=NULL;
    struct sc_iocmd16cdb sciocmd;
....

    fd = open("/dev/usbms0", O_RDWR);
    if (fd == -1){
        printf("\niocmd: Open FAIL\n");
        exit(-1);
    }

    memset(&sciocmd, '\0', sizeof(struct scsi_iocmd));
    sciocmd.version = SCSI_VERSION_1;
    sciocmd.timeout_value = 30;
    sciocmd.command_length = 6;
    sciocmd.flags = B_READ;
    sciocmd.autosense_length = 255;
    sciocmd.autosense_buffer_ptr = &sense_data[0];

    sciocmd.data_length = 0xFF;
    sciocmd.buffer = inq_data;
    sciocmd.scsi_cdb[0] = SCSI_INQUIRY;
    sciocmd.scsi_cdb[1] = 0x00; /* Standard Inquiry*/
    sciocmd.scsi_cdb[2] = 0x00;
    sciocmd.scsi_cdb[3] = 0x00;
    sciocmd.scsi_cdb[4] = 0xFF;
    sciocmd.scsi_cdb[5] = 0x00;

    if ((rc=ioctl(fd, DKIOCMD, &sciocmd)) != 0){
        printf("iocmd: Ioctl FAIL errno %d\n",errno);
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        hexdump(sense_data, (long)20);
        close(fd);
        exit(-1);
    } else {
        printf("cdiocmd : Ioctl PASS\n");
        if (cmd = SCSI_INQUIRY)
            hexdump(inq_data,0x20);
    }

    close(fd);

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

如果 DK_PASSTHRU 操作因 sc_passthru 结构中的字段值无效而失败，子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL。 einval_arg 字段设置为具有无效值的字段的字段号 (对于版本字段，以 1 开头)。 einval_arg 字段的值 0 指示没有关于故障的其他信息可用。

在完成 DK_PASSTHRU 请求时，残差字段指示设备未完全满足此请求的剩余数据。 在成功完成时，剩余字段指示设备没有所请求的所有数据，或者设备的数据量小于所请求的数据量。 在请求失败时，必须检查 status_validity 字段以确定是否存在有效的 SCSI 总线问题。 在这种情况下，残差字段指示设备针对此请求未能完成的字节数。

devinfo 结构定义命令的最大传输大小。 如果尝试传输的大小超过最大传输大小，子程序将返回 -1 值，将 errno 全局变量设置为 EINVAL 值，并将 einval_arg 字段设置为 SC_PASSTHRU_INV_D_LEN 值。 这些值在 /usr/include/sys/scsi.h 文件中定义。

    char sense_data[255];
    char *data_buffer=NULL;
    struct sc_passthru sciocmd;
....

    fd = open("/dev/usbms0", O_RDWR);
    if (fd == -1){
        printf("\npassthru: Open FAIL\n");
        exit(-1);
    }

    memset(&sciocmd, '\0', sizeof(struct sc_passthru));
    sciocmd.version = SCSI_VERSION_1;
    sciocmd.timeout_value = 30;
    sciocmd.command_length = 6;
    sciocmd.autosense_length = 255;
    sciocmd.autosense_buffer_ptr = &sense_data[0];

    sciocmd.data_length = 0xFF;
    sciocmd.buffer = inq_data;

    sciocmd.flags = B_READ;

    sciocmd.scsi_cdb[0] = SCSI_INQUIRY;
    sciocmd.scsi_cdb[1] = 0x00; /* Standard Inquiry*/
    sciocmd.scsi_cdb[2] = 0x00;
    sciocmd.scsi_cdb[3] = 0x00;
    sciocmd.scsi_cdb[4] = 0xFF;
    sciocmd.scsi_cdb[5] = 0x00;

    if ((rc=ioctl(fd, DK_PASSTHRU, &sciocmd)) != 0){
        if (sciocmd.adap_set_flags & SC_AUTOSENSE_DATA_VALID) {
            /* look at sense data */
        } /* end SC_AUTOSENSE_DATA_VALID */

        printf("passthru: Ioctl FAIL errno %d\n",errno);
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        printf("Residual: %x\n", sciocmd.residual);
        exit(-1);
    } else {
        printf("passthru: Ioctl PASS\n");
        printf("status_validity: %x, scsi_status: %x, adapter_status:%x\n",
               sciocmd.status_validity, sciocmd.scsi_bus_status,
               sciocmd.adapter_status);
        printf("Residual: %x\n", sciocmd.residual);
        /* inq_data buffer has valid Standard Inquiry data */
    }

devinfo.devtype = DD_SCDISK;
devinfo.flags =(uchar)DF_RAND;
devinfo.devsubtype = 0x00;
devinfo.un.scdk.max_request = Maximum_transfer_supported_by_usbcd_driver;
devinfo.un.scdk.numblks = Largest_LBA_supported_by_device+1;
devinfo.un.scdk.blksize = Block_size_set_for_the_USB_Disk/Flash/RDX_Device;

devinfo.devtype = DD_CDROM;
devinfo.flags = (uchar)DF_RAND;
devinfo.devsubtype = 0x00;
devinfo.un.idecd.numblks = 
  Largest logical block addressing (LBA) supported by device + 1;
devinfo.un.idecd.blksize = Block size set for the USB Disk, flash, or RDX device;

AT 附件 (ATA) 状态字节和 ATA 错误字节通过 arg 参数返回。 此参数包含 /usr/include/sys/ide.h 文件中定义的 ide_ata_passthru 结构的地址。 如果 IDEPASSTHRU 操作失败，子程序将返回 -1 值，并将 errno 全局变量设置为非零值。 在此情况下，调用者将评估返回的状态字节以确定操作失败的原因以及恢复操作。

如果 IDEPASSTHRU 操作失败，那么设备驱动程序将执行有限的错误恢复。 如果由于 ide_ata_passthru 结构中的某个字段具有无效值而导致操作失败，则子程序会返回 -1 值，并将 errno 全局变量设置为 EINVAL 。

成功完成 IDEPASSTHRU 请求时，残差字段指示设备没有所请求的所有数据，或者设备的数据量小于所请求的数据量。 如果 IDEPASSTHRU 请求失败，那么残差字段指示设备对此请求未能完成的字节数。

以下示例代码发出使用 IDEPASSTHRU 操作的 SCSI 查询命令:

    struct ide_atapi_passthru atapicmd;
    char inq_buffer[255];
    uchar sense_data[255];
 
    /* set up the arg parameter block */
    memset(&atapicmd, '\0', sizeof(struct ide_atapi_passthru));
    memset(sense_data, '\0', 255);

    atapicmd.ide_device = 0;
    atapicmd.flags = IDE_PASSTHRU_READ;
    atapicmd.timeout_value    = 30;
    atapicmd.rsv0             = IDE_PASSTHRU_VERSION_01;
    atapicmd.rsv1             = 0;
    atapicmd.atapi_cmd.length = 12;
    atapicmd.atapi_cmd.resvd  = 0;
    atapicmd.atapi_cmd.resvd1 = 0;
    atapicmd.atapi_cmd.resvd2 = 0;

    atapicmd.data_ptr = inq_buffer;
    atapicmd.buffsize = 0xFF;

    atapicmd.atapi_cmd.packet.opcode  = SCSI_INQUIRY;
    atapicmd.atapi_cmd.packet.byte[0] = (0x00 | vpd)  ;  /*Standard Inquiry */
    atapicmd.atapi_cmd.packet.byte[1] = page_code;  /*Page Code-Valid if vpd=1 */
    atapicmd.atapi_cmd.packet.byte[2] = 0x00;
    atapicmd.atapi_cmd.packet.byte[3] = 0xFF;
    atapicmd.atapi_cmd.packet.byte[4] = 0x00;

    atapicmd.sense_data        = sense_data;
    atapicmd.sense_data_length = 255;

    fd = openx(“/dev/cd0”, O_RDWR, NULL, SC_DIAGNOSTIC);
    if (fd == -1) {
         printf("IDEPASSTHRU: Openx failed with errno %x \n", errno);
         exit(-1);
    }

   if ((rc = ioctl(fd, IDEPASSTHRU, &atapicmd) != 0)) {
         printf("IDEPASSTHRU: IOCTL Failed");
         printf("errno %d\n",errno);
         printf("ata_status: %x, ata_error:%x\n",
                atapicmd.ata_status, atapicmd.ata_error);
         close(fd);
         exit(-1);
     } else {
         printf("IDEPASSTHRU : Ioctl PASS\n");
         printf("ata_status: %x, ata_error: %x\n",
                atapicmd.ata_status, atapicmd.ata_error);
     }
     close(fd);

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

CD_GET_MODE

成功打开设备时，在 mode_form_op 结构的 cd_mode_form 字段中返回当前 CD-ROM 数据方式。

CD_CHG_MODE

当设备以互斥存取方式成功打开时，将 CD-ROM 数据方式更改为 mode_form_op 结构的 cd_mode_form 字段中指定的方式。

如果 CD-ROM 没有通过使用模式选择密度代码来配置不同的数据模式，并且通过将 change_mode_form 结构的操作字段设置为 CD_CHG_MODE 命令来更改 CD-ROM 的数据模式，则子程序将返回 -1 值，并将 errno 全局变量设置为 EINVAL 值。 将 CD-ROM 模式更改为任何 DVD 模式的尝试也会导致 -1 返回值和 errno 全局变量设置为 EINVAL。 如果在设备未处于独占访问模式时尝试执行 DK_CD_MODE 命令的 CD_CHG_MODE 操作，子例程将返回 -1 值，并将 errno 全局变量设置为 EACCES 值。 对于操作失败的任何其他原因，子例程返回 -1 值，并将 errno 全局变量设置为 EIO 值。