Pilote de périphérique du client de stockage de masse USB

Une unité peut être ouverte en mode Diagnostic uniquement si l'unité cible n'est pas ouverte actuellement. Si vous ouvrez un appareil dans leDiagnostic mode lorsque le périphérique cible est déjà ouvert, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEACCES .

Un périphérique ne peut être ouvert en mode Exclusive Access que s'il n'est pas actuellement ouvert. Si vous ouvrez un appareil dans leExclusive Access mode et que l'appareil est déjà ouvert, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEBUSY . Si l'indicateur SC_DIAGNOSTIC est spécifié avec l'indicateur SC_SINGLE , l'unité est placée en mode Diagnostic .

L'opération DKIORDSE est fournie à des fins de diagnostic. Il permet l'utilisation limitée de l'unité cible lors de son fonctionnement dans un environnement système actif. Le paramètre arg de l'opération DKIORDSE contient l'adresse d'une structure sc_rdwrt . Cette structure est définie dans le fichier /usr/include/sys/scsi.h .

La structure devinfo définit la taille de transfert maximale pour une opération de lecture. Si vous transférez plus que la limite maximale, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEINVAL .

L'octet de statut SCSI et les octets de statut de l'adaptateur sont renvoyés via le paramètre arg qui contient l'adresse d'une structure sc_iocmd , qui est définie dans le fichier /usr/include/sys/scsi.h . Si laDKIOCMD L'opération échoue, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur non nulle. Dans ce cas, l'appelant doit évaluer les octets d'état renvoyés pour déterminer la cause de l'échec de l'opération et les actions de reprise.

La structure devinfo définit la taille de transfert maximale pour la commande. Si vous transférez plus que la valeur maximale, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEINVAL .

    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);

Cette opération ioctl est similaire à l'opération DKIOCMD16 qui est utilisée pour émettre des commandes SCSI de 16 octets vers l'unité de stockage de masse USB.

L'octet de statut SCSI et les octets de statut de l'adaptateur sont renvoyés via le paramètre arg qui contient l'adresse d'une structure sc_iocmd16cdb . Cette structure est définie dans le fichier /usr/include/sys/scsi.h . Si laDKIOLCMD L'opération échoue, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur non nulle. Dans ce cas, l'appelant doit évaluer les octets d'état renvoyés pour déterminer la cause de l'échec de l'opération et les actions de reprise.

A la fin de la demande DKIOLCMD ioctl , la zone résiduelle indique les données restantes que le périphérique n'a pas entièrement satisfait pour cette demande. En cas d'achèvement réussi, la zone résiduelle indique que l'unité ne dispose pas de toutes les données demandées ou que l'unité dispose de moins de données que celles demandées. En cas d'échec d'une demande, vous devez vérifier la zone status_validity pour déterminer s'il existe un problème de bus SCSI valide. Dans ce cas, la zone résiduelle indique le nombre d'octets que l'unité n'a pas pu remplir pour cette demande.

La structure devinfo définit la taille de transfert maximale pour la commande. Si vous transférez plus que la valeur maximale, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEINVAL .

    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);

L'octet de statut SCSI et les octets de statut de l'adaptateur sont renvoyés via le paramètre arg qui contient l'adresse d'une structure sc_passthru . Cette structure est définie dans le fichier /usr/include/sys/scsi.h . Si laDK_PASSTHRU L'opération échoue, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur non nulle. Dans ce cas, l'appelant doit évaluer les octets d'état renvoyés pour déterminer la cause de l'échec de l'opération et les actions de reprise.

Si unDK_PASSTHRU l'opération échoue car un champ dans lesc_passthru structure a une valeur invalide, le sous-programme renvoie une valeur de-1 et réglez le numéro d'erreur variable globale àEINVAL . La zone einval_arg est définie sur le numéro de zone (en commençant par 1 pour la zone de version) de la zone dont la valeur n'est pas valide. La valeur 0 pour la zone einval_arg indique qu'aucune information supplémentaire sur l'échec n'est disponible.

A la fin de la demande DK_PASSTHRU , la zone résiduelle indique les données restantes que le périphérique n'a pas entièrement satisfait pour cette demande. En cas d'achèvement réussi, la zone résiduelle indique que l'unité ne dispose pas de toutes les données demandées ou que l'unité dispose de moins de données que celles demandées. En cas d'échec d'une demande, vous devez vérifier la zone status_validity pour déterminer s'il existe un problème de bus SCSI valide. Dans ce cas, la zone résiduelle indique le nombre d'octets que l'unité n'a pas pu remplir pour cette demande.

La structure devinfo définit la taille de transfert maximale pour la commande. Si une tentative est faite pour transférer une taille supérieure à la taille maximale de transfert, le sous-programme renvoie une valeur de-1 , définit le numéro d'erreur variable globale à une valeur deEINVAL , et définit leeinval_arg champ à une valeur deSC_PASSTHRU_INV_D_LEN . Ces valeurs sont définies dans le fichier /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;

Les octets de statut AT Attachment (ATA) et les octets d'erreur ATA sont renvoyés via le paramètre arg . Ce paramètre contient l'adresse d'une structure ide_ata_passthru définie dans le fichier /usr/include/sys/ide.h . Si laIDEPASSTHRU L'opération échoue, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur non nulle. Dans ce cas, l'appelant évalue les octets d'état renvoyés pour déterminer la cause de l'échec de l'opération et les actions de reprise.

Si l'opération IDEPASSTHRU échoue, le pilote de périphérique effectue une reprise sur incident limitée. Si cette opération échoue parce qu'un champ dans leide_ata_passthru structure a une valeur invalide, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale àEINVAL .

A l'issue de la demande IDEPASSTHRU , la zone résiduelle indique que l'unité ne possède pas toutes les données demandées ou que l'unité possède une quantité de données inférieure à la quantité demandée. Si la demande IDEPASSTHRU échoue, la zone résiduelle indique le nombre d'octets que l'unité n'a pas pu exécuter pour cette demande.

L'exemple de code suivant émet une commande d'interrogation SCSI qui utilise l'opération IDEPASSTHRU :

    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);

Si laDKAUDIO L'opération est tentée lorsque l'attribut audio pris en charge du périphérique est défini surNo , le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEINVAL . Si laDKAUDIO L'opération échoue, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur non nulle. Dans ce cas, l'appelant doit évaluer les octets d'état renvoyés pour déterminer la cause de l'échec de l'opération et des actions de reprise.

CD_GET_MODE

Renvoie le mode de données CD-ROM en cours dans la zone cd_mode_form de la structure mode_form_op lorsque l'unité est correctement ouverte.

CD_CHG_MODE

Remplace le mode de données CD-ROM par le mode spécifié dans la zone cd_mode_form de la structure mode_form_op lorsque l'unité est correctement ouverte en mode d'accès exclusif.

Si un CD-ROM n'est pas configuré pour différents modes de données à l'aide des codes de densité de sélection de mode et si vous modifiez le mode de données du CD-ROM en définissant le champ d'action duchange_mode_form structure à laCD_CHG_MODE commande, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEINVAL . Les tentatives de changement du mode CD-ROM vers l'un des modes DVD entraînent également une valeur de retour de-1 et le numéro d'erreur la variable globale est définie surEINVAL . Si laDK_CD_MODE opération pour leCD_CHG_MODE La commande est tentée lorsque l'appareil n'est pas en mode d'accès exclusif, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEACCES . Pour toute autre cause d’échec de fonctionnement, le sous-programme renvoie une valeur de-1 et définit le numéro d'erreur variable globale à une valeur deEIO .