Opération ioctl de pilote de périphérique d'adaptateur SCSI SCIOHALT (Halt)

Editer en ligne

Objectif

Met fin à la commande en cours (s'il y en a un), efface la file d'attente des commandes en attente et place la file d'attente dans un état arrêté.

Descriptif

L'opération SCIOHALT permet à l'appelant de mettre fin à la commande en cours (s'il y en a un) à une unité sélectionnée, d'effacer la file d'attente des commandes en attente et de placer la file d'attente d'unités à l'état arrêté. La commande permet à la carte SCSI connectée d'exécuter un message d'abandon SCSI sur l'unité cible sélectionnée. Cette commande est utilisée par un pilote de périphérique SCSI de niveau supérieur pour mettre fin à une opération en cours d'exécution au lieu d'attendre que l'opération se termine ou se termine.

Une fois l'opération SCIOHALT envoyée, le pilote de périphérique appelant doit définir l'indicateur SC_RESUME . Ce bit se trouve dans leflagsDe la prochaine structure Sc_buf à traiter par le pilote de périphérique de l'adaptateur SCSI. Toute structure Sc_buf envoyée sans l'indicateur SC_RESUME , une fois la file d'attente d'unités à l'état arrêté, est rejetée.

Le paramètre Arg de l'opération SCIOHALT permet à l'appelant de spécifier l'identificateur SCSI de l'unité à réinitialiser. L'octet le moins significatif dans le paramètre Arg est l'ID LUN (identificateur de numéro d'unité logique) de l'unité logique sur le contrôleur SCSI à arrêter. L'octet le moins significatif est l'ID SCSI. Les deux octets restants sont réservés et doivent être définis sur une valeur de 0.

Le pilote de périphérique de l'adaptateur SCSI effectue des procédures normales de reprise après incident lors de l'exécution de cette commande. Par exemple, si le message d'abandon entraîne le blocage du bus SCSI, une réinitialisation de bus SCSI est initialisée pour effacer la condition.

Valeurs renvoyées

Une fois l'opération terminée, cette opération renvoie la valeur 0. Sinon, une valeur de-1 est renvoyé, et le numéro d'erreur La variable globale est définie sur l'une des valeurs suivantes :

Valeur Descriptif
EINVAL Indique qu'une opération SCIOSTART n'a pas été émise avant cette opération.
EIO Indique qu'une erreur d'E-S irrémédiable s'est produite. Dans ce cas, les informations d'état d'erreur de l'adaptateur sont consignées dans le journal des erreurs système.
EIO Indique que l'unité est déjà en cours d'arrêt ou que le pilote de périphérique n'a pas pu broder le code.
ENOCONNECT Indique qu'une erreur de bus SCSI s'est produite.
ENODEV Indique que l'ID SCSI cible n'a pas pu être sélectionné ou ne répond pas. Cette condition n'est pas nécessairement une erreur et n'est pas consignée.
ENOMEM Indique que la mémoire est insuffisante pour exécuter la commande.
ETIMEDOUT Indique que l'adaptateur n'a pas répondu au statut avant l'expiration de la valeur de délai de commande interne. Cette erreur est consignée dans le journal des erreurs système.

Fichiers

Article Descriptif
/dev/scsi0, /dev/scsi1, ..., /dev/scsi n Fournissez une interface permettant aux pilotes de périphérique SCSI d'accéder aux cartes et périphériques SCSI.
/dev/vscsi0, /dev/vscsi1, ..., /dev/vscsin Fournissez une interface permettant aux pilotes de périphérique Adapter/A SCSI-2 Fast / Wide et SCSI-2 Adapter/A à l'adaptation/A d'accéder aux cartes ou aux périphériques SCSI.