USB 大容量ストレージ・クライアント・デバイス・ドライバー

ターゲット装置が現在オープンされていない場合にのみ、装置を Diagnostic モードでオープンすることができます。 デバイスをDiagnosticターゲットデバイスがすでに開いている場合、サブルーチンは次の値を返します。-1そして、エラーグローバル変数をEACCES。

デバイスを Exclusive Access モードで開くことができるのは、そのデバイスが現在オープンされていない場合のみです。 デバイスをExclusive Accessモードでデバイスがすでに開いている場合、サブルーチンは値を返します。-1そして、エラーグローバル変数をEBUSY。 SC_DIAGNOSTIC フラグを SC_SINGLE フラグと一緒に指定すると、デバイスは Diagnostic モードになります。

DKIORDSE 操作は、診断に使用するために提供されています。 これにより、アクティブ・システム環境での操作中にターゲット装置を限定的に使用することができます。 DKIORDSE 操作の arg パラメーターには、 sc_rdwrt 構造体のアドレスが含まれます。 この構造は、 /usr/include/sys/scsi.h ファイルで定義されます。

devinfo 構造体は、読み取り操作の最大転送サイズを定義します。 最大限度を超えて転送した場合、サブルーチンは次の値を返します。-1そして、エラーグローバル変数をEINVAL。

SCSI 状況バイトおよびアダプター状況バイトは、 /usr/include/sys/scsi.h ファイルに定義されている sc_iocmd 構造体のアドレスを含む arg パラメーターを介して戻されます。 もし、DKIOCMD操作が失敗した場合、サブルーチンは値を返します-1そして、エラーグローバル変数をゼロ以外の値に設定します。 この場合、呼び出し側は、戻された状況バイトを評価して、操作の失敗の原因とリカバリー・アクションを判別する必要があります。

devinfo 構造は、コマンドの最大転送サイズを定義します。 最大値を超えて転送した場合、サブルーチンは次の値を返します。-1そして、エラーグローバル変数を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そして、エラーグローバル変数をゼロ以外の値に設定します。 この場合、呼び出し側は、戻された状況バイトを評価して、操作の失敗の原因とリカバリー・アクションを判別する必要があります。

DKIOLCMD ioctl 要求が完了すると、残余フィールドは、装置がこの要求に対して完全には満たさなかった残りのデータを示します。 正常終了の場合、残余フィールドは、装置に要求されたすべてのデータがないか、装置のデータ量が要求された量より少ないことを示します。 要求が失敗した場合は、 status_validity フィールドを調べて、有効な SCSI バスの問題が存在するかどうかを判別する必要があります。 この場合、残留フィールドは、この要求に対して装置が完了できなかったバイト数を示します。

devinfo 構造は、コマンドの最大転送サイズを定義します。 最大値を超えて転送した場合、サブルーチンは次の値を返します。-1そして、エラーグローバル変数を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そして、エラーグローバル変数をゼロ以外の値に設定します。 この場合、呼び出し側は、戻された状況バイトを評価して、操作の失敗の原因とリカバリー・アクションを判別する必要があります。

もしDK_PASSTHRU操作は失敗しました。sc_passthru構造体に無効な値がある場合、サブルーチンは値を返します。-1そして、エラーグローバル変数にEINVAL。 einval_arg フィールドは、無効な値を持つフィールドのフィールド番号 (バージョン・フィールドの場合は 1 から始まる) に設定されます。 einval_arg フィールドの値が 0 の場合は、障害に関する追加情報が入手できないことを示します。

DK_PASSTHRU 要求が完了すると、残余フィールドは、装置がこの要求に対して完全には満たさなかった残りのデータを示します。 正常終了の場合、残余フィールドは、装置に要求されたすべてのデータがないか、装置のデータ量が要求された量より少ないことを示します。 要求が失敗した場合は、 status_validity フィールドを調べて、有効な SCSI バスの問題が存在するかどうかを判別する必要があります。 この場合、残留フィールドは、この要求に対して装置が完了できなかったバイト数を示します。

devinfo 構造は、コマンドの最大転送サイズを定義します。 最大転送サイズを超えて転送しようとすると、サブルーチンは次の値を返します。-1は、エラーグローバル変数を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 Attachment (ATA) 状況バイトおよび ATA エラー・バイトは、 arg パラメーターを介して戻されます。 このパラメーターには、 /usr/include/sys/ide.h ファイルに定義されている ide_ata_passthru 構造体のアドレスが含まれます。 もし、IDEPASSTHRU操作が失敗した場合、サブルーチンは値を返します-1そして、エラーグローバル変数をゼロ以外の値に設定します。 この場合、呼び出し元は、戻された状況バイトを評価して、操作の失敗の原因とリカバリー・アクションを判別します。

IDEPASSTHRU 操作が失敗した場合、デバイス・ドライバーは限定されたエラー・リカバリーを実行します。 この操作が失敗した場合、ide_ata_passthru構造体に無効な値がある場合、サブルーチンは値を返します。-1そして、エラーグローバル変数に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);

もし、DKAUDIOデバイスのオーディオサポート属性が設定されている場合に操作が試行されますNoサブルーチンは値を返します-1そして、エラーグローバル変数をEINVAL。 もし、DKAUDIO操作が失敗した場合、サブルーチンは値を返します-1そして、エラーグローバル変数をゼロ以外の値に設定します。 この場合、呼び出し側は、戻された状況バイトを評価して、操作の失敗の原因とリカバリー・アクションを判別する必要があります。

CD_GET_MODE

装置が正常にオープンされたときに、 mode_form_op 構造体の cd_mode_form フィールドに現行の CD-ROM データ・モードを戻します。

CD_CHG_MODE

装置が排他的アクセス・モードで正常にオープンされると、CD-ROM データ・モードを mode_form_op 構造体の cd_mode_form フィールドに指定されているモードに変更します。

CD-ROMがモード選択密度コードを使用して異なるデータモード用に設定されていない場合、およびCD-ROMデータモードをアクションフィールドで設定して変更した場合、change_mode_form構造にCD_CHG_MODEコマンドを実行すると、サブルーチンは-1そして、エラーグローバル変数をEINVAL。 CD-ROMモードをDVDモードに変更しようとすると、戻り値は-1そしてそのエラーグローバル変数は次のように設定されますEINVAL。 もし、DK_CD_MODEの操作CD_CHG_MODEデバイスが排他アクセスモードではないときにコマンドが試行されると、サブルーチンは次の値を返します。-1そして、エラーグローバル変数をEACCES。 その他の原因で操作が失敗した場合、サブルーチンは次の値を返します。-1そして、エラーグローバル変数をEIO。