Opérations ioctl() prises en charge

Par soucis de compatibilité avec les applications écrites pour les pilotes cciss(4) et hpsa(4), de nombreuses opérations ioctl(2), mais pas toutes, prises en charge par le pilote hpsa sont aussi prises en charge par le pilote smartpqi. Les structures de données utilisées par ces opérations sont décrites dans le fichier source du noyau Linux include/linux/cciss_ioctl.h.

CCISS_DEREGDISK

CCISS_REGNEWDISK

CCISS_REGNEWD

Ces opérations font toutes les trois la même chose, à savoir forcer le pilote à rechercher des nouveaux périphériques. Cela revient exactement à écrire dans l'attribut d'hôte rescan spécifique à smartpqi.

CCISS_GETPCIINFO

Cette opération renvoie les domaine, bus, dispositif et fonction PCI, ainsi que l'« identifiant de carte » (identifiant du sous-système PCI).

CCISS_GETDRIVVER

Cette opération renvoie la version du pilote encodée dans quatre octets comme suit :

 (version_majeure << 28) | (version_mineure << 24) |


        (publication << 16) | révision
    

CCISS_PASSTHRU

Permettre aux commandes BMIC et CISS d'être passées au contrôleur.

Options de démarrage

disable_device_id_wildcards={0|1}

Désactiver la prise en charge des jockers d'ID de périphérique. La valeur par défaut est 0 (les jockers sont activés).

disable_heartbeat={0|1}

Désactiver la prise en charge de la vérification du « heartbeat » du contrôleur. Ce paramètre est utilisé dans le cadre du débogage. La valeur par défaut est 0 (la vérification du « heartbeat » du contrôleur est activée).

disable_ctrl_shutdown={0|1}

Désactiver la prise en charge de la fermeture du contrôleur en cas de verrouillage du contrôleur. La valeur par défaut est 0 (le contrôleur sera arrêté).

lockup_action={none|reboot|panic}

Spécifier l'action que le pilote entreprend quand un verrouillage du contrôleur est détectée. L'action par défaut est none.

paramètre	action
none	mettre seulement le contrôleur hors ligne
reboot	redémarrer le système
panic	déclencher une panique du système

expose_ld_first={0|1}

Cette option expose les périphériques logiques au système d'exploitation avant les périphériques physiques. La valeur par défaut est 0 (périphériques physiques activés en premier).

hide_vsep={0|1}

Cette option désactive l'exposition du SEP virtuel au système d'exploitation. La valeur par défaut est 0 (SEP virtuel exposé).

disable_managed_interrupts={0|1}

Cette option désactive l’utilisation du pilote des interruptions gérées du noyau Linux pour les contrôleurs. La fonctionnalité des interruptions gérées distribue automatiquement les interruptions à tous les processeurs disponibles et assigne l'affinité SMP. La valeur par défaut est 0 (interruptions gérées activées).

ctrl_ready_timeout={0|[30,1800]}

Cette option spécifie le délai en secondes pendant lequel le pilote attend que le contrôleur soit prêt. La plage valable est 0 ou [30, 1800]. La valeur par défaut est 0 qui fait que le pilote utilise un délai de 180 secondes.

Nœuds de périphériques

On accède aux lecteurs de disque au moyen du pilote de disque SCSI (sd), aux lecteurs de bandes au moyen du pilote de lecteur de bande SCSI (st) et au contrôleur RAID au moyen du pilote SCSI générique (sg), avec des nœuds de périphérique appelés respectivement /dev/sd*, /dev/st* et /dev/sg*.

Fichiers d'attribut d'hôte spécifiques à SmartPQI dans /sys

/sys/class/scsi_host/host*/rescan

L'attribut rescan de l'hôte est un attribut en écriture seule. Écrire dans cet attribut forcera le pilote à rechercher les périphériques nouveaux, modifiés ou retirés (par exemple, des lecteurs de bandes branchés à chaud ou des volumes logiques nouvellement configurés ou supprimés, etc.) et prévenir la couche intermédiaire SCSI de tout changement détecté. Normalement, une telle recherche est déclenchée automatiquement par les modifications de configuration, donc l'utilisateur ne devrait normalement pas avoir à écrire dans ce fichier. Faire cela peut s'avérer utile lors du branchement à chaud de périphériques tels que les lecteurs de bandes ou des boîtiers entiers de stockage contenant des volumes logiques préconfigurés.

/sys/class/scsi_host/host*/lockup_action

L'attribut lockup_action de l'hôte est un attribut en lecture et en écriture. Cet attribut fera que le pilote réalisera une action spécifique dans le cas peu probable où un verrouillage du contrôleur aura été détecté. Voir OPTIONS ci-dessus pour une explication sur les valeurs de lockup_action.

/sys/class/scsi_host/host*/driver_version

L'attribut driver_version est en lecture seule. Cet attribut contient la version du pilote smartpqi.

Par exemple :

$ cat /sys/class/scsi_host/host1/driver_version
1.1.2-126
    

/sys/class/scsi_host/host*/firmware_version

L'attribut firmware_version est en lecture seule. Cet attribut contient la version du microprogramme du contrôleur.

Par exemple :

$ cat /sys/class/scsi_host/host1/firmware_version
1.29-112
    

/sys/class/scsi_host/host*/model

L'attribut model est en lecture seule. Cet attribut contient la chaîne d'identification produit du contrôleur.

Par exemple :

$ cat /sys/class/scsi_host/host1/model
1100-16i
    

/sys/class/scsi_host/host*/serial_number

L'attribut serial_number est en lecture seule. Cet attribut contient le numéro unique d'identification du contrôleur.

Par exemple :

$ cat /sys/class/scsi_host/host1/serial_number
6A316373777
    

/sys/class/scsi_host/host*/vendor

L'attribut vendor est en lecture seule. Cet attribut contient la chaîne d'identification du fabricant du contrôleur.

Par exemple :

$  cat /sys/class/scsi_host/host1/vendor
Adaptec
    

/sys/class/scsi_host/host*/enable_stream_detection

L'attribut enable_stream_detection est un attribut en lecture et en écriture. Cet attribut active ou désactive la détection de flux dans le pilote. Activer la détection de flux peut améliorer la performance en écriture des volumes où ioaccel est activé. Voir la section sur l'attribut de disque ssd_smart_path_enabled pour des détails sur les volumes où ioaccel est activé. La valeur par défaut est 1 (détection de flux activée).

Enable Exemple :

$ echo 1 > /sys/class/scsi_host/host1/enable_stream_detection
    

/sys/class/scsi_host/host*/enable_r5_writes

L'attribut enable_r5_writes est un attribut en lecture et en écriture. Cet attribut active ou désactive les opérations d'écriture RAID 5 sur les volumes où ioaccel est activé. L'activation peut améliorer les performances d'écriture séquentielle. Voir la section sur l'attribut de disque ssd_smart_path_enabled pour des détails sur les volumes où ioaccel est activé. La valeur par défaut est 1 (écritures RAID 5 activées).

Enable Exemple :

$ echo 1 > /sys/class/scsi_host/host1/enable_r5_writes
    

/sys/class/scsi_host/host*/enable_r6_writes

L'attribut enable_r6_writes est un attribut en lecture et en écriture. Cet attribut active ou désactive les opérations d'écriture RAID 6 sur les volumes où ioaccel est activé. L'activation peut améliorer les performances d'écriture séquentielle. Voir la section sur l'attribut de disque ssd_smart_path_enabled pour des détails sur les volumes où ioaccel est activé. La valeur par défaut est 1 (écritures RAID 6 activées).

Enable Exemple :

$ echo 1 > /sys/class/scsi_host/host1/enable_r6_writes
    

Fichiers d'attribut de disque spécifiques à SmartPQI dans /sys

Dans les spécifications du fichier ci-dessous, c est le numéro du contrôleur SCSI approprié, b est le numéro de bus, t le numéro de cible et l est le numéro d'unité logique (LUN).

/sys/class/scsi_disk/c:b:t:l/device/raid_level

L'attribut raid_level est en lecture seule. Cet attribut contient le niveau RAID du volume logique.

Par exemple :

$ cat /sys/class/scsi_disk/4:0:0:0/device/raid_level
RAID 0
    

/sys/class/scsi_disk/c:b:t:l/device/sas_address

L'attribut sas_address est en lecture seule. Cet attribut contient l'adresse SAS du périphérique.

Par exemple :

$ cat /sys/class/scsi_disk/1:0:3:0/device/sas_address
0x5001173d028543a2
    

/sys/class/scsi_disk/c:b:t:l/device/ssd_smart_path_enabled

L'attribut ssd_smart_path_enabled est en lecture seule. Cet attribut est pour les volumes où ioaccel est activé. (Ioaccel est un chemin alternatif de soumission du pilote qui permet au pilote d'envoyer des requêtes d'E/S directement aux périphériques du dorsal SCSI en contournant le microprogramme du contrôleur. Cela aboutit à une meilleure performance. Cette méthode est utilisée pour les disques HBA et pour les volumes logiques composés de SSD.) Il contient 1 si ioaccel est activé pour le volume et 0 dans le cas contraire.

Par exemple :

$ cat /sys/class/scsi_disk/1:0:3:0/device/ssd_smart_path_enabled
0
    

/sys/class/scsi_disk/c:b:t:l/device/lunid

L'attribut lunid est en lecture seule. Cet attribut contient l'ID LUN SCSI du périphérique.

Par exemple :

$ cat /sys/class/scsi_disk/13:1:0:3/device/lunid
0x0300004000000000
    

/sys/class/scsi_disk/c:b:t:l/device/unique_id

L'attribut unique_id est en lecture seule. Cet attribut contient l'ID 16 octets qui identifie de façon unique le périphérique dans le contrôleur.

Par exemple :

$ cat /sys/class/scsi_disk/13:1:0:3/device/unique_id
600508B1001C6D4723A8E98D704FDB94
    

/sys/class/scsi_disk/c:b:t:l/device/path_info

L'attribut path_info est en lecture seule. Cet attribut contient le c:b:t:l du périphérique ainsi que le type du périphérique et son état Active ou Inactive. Si le périphérique est un périphérique HBA, path_info affichera aussi les PORT, BOX et BAY où il est connecté.

Par exemple :

$ cat /sys/class/scsi_disk/13:1:0:3/device/path_info
[13:1:0:3]    Direct-Access     Active
$ cat /sys/class/scsi_disk/12:0:9:0/device/path_info
[12:0:9:0]  Direct-Access   PORT: C1 BOX: 1 BAY: 14 Inactive
[12:0:9:0]  Direct-Access   PORT: C0 BOX: 1 BAY: 14 Active
    

/sys/class/scsi_disk/c:b:t:l/device/raid_bypass_cnt

L'attribut raid_bypass_cnt est en lecture seule. Cet attribut contient le nombre de requêtes qui sont passées par le chemin ioaccel pour les volumes où ioaccel est activé. Voir la section sur l'attribut de disque ssd_smart_path_enabled pour des détails sur les volumes où ioaccel est activé.

Par exemple :

$ cat /sys/class/scsi_disk/13:1:0:3/device/raid_bypass_cnt
0x300
    

/sys/class/scsi_disk/c:b:t:l/device/sas_ncq_prio_enable

L'attribut raid_bypass_cnt est un attribut en lecture et en écriture. Cet attribut active la prise en charge de la priorité NCQ de SATA. Cet attribut ne fonctionne que si le périphérique bénéficie de la prise en charge de NCQ et si le microprogramme du contrôleur peut gérer les Entrées/Sorties avec l'attribut de priorité NCQ.

Par exemple :

$ echo 1 > /sys/class/scsi_disk/13:1:0:3/device/sas_ncq_prio_enable
    

Configuration

Pour configurer un contrôleur Microchip Smart Storage, veuillez vous référer au guide d'utilisation du contrôleur que vous trouverez en recherchant le contrôleur spécifique sur la page https://www.microchip.com/design-centers/storage.