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 ID jocker de périphérique. La valeur par défaut est 0 (les jocker 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}

Disables driver utilization of Linux kernel managed interrupts for controllers. The managed interrupts feature automatically distributes interrupts to all available CPUs and assigns SMP affinity. The default value is 0 (managed interrupts enabled).

ctrl_ready_timeout={0|[30,1800]}

This option specifies the timeout in seconds for the driver to wait for the controller to be ready. The valid range is 0 or [30, 1800]. The default value is 0, which causes the driver to use a timeout of 180 seconds.

Nœuds de périphériques

On accède aux lecteurs de disque via le pilote de disque SCSI (sd), aux lecteurs de bandes via le pilote de lecteur de bande SCSI (st) et au contrôleur RAID via le 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. Cet attribut 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

The enable_stream_detection attribute is read-write. This attribute enables/disables stream detection in the driver. Enabling stream detection can improve sequential write performance for ioaccel-enabled volumes. See the ssd_smart_path_enabled disk attribute section for details on ioaccel-enabled volumes. The default value is 1 (stream detection enabled).

Enable Exemple :

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

/sys/class/scsi_host/host*/enable_r5_writes

The enable_r5_writes attribute is read-write. This attribute enables/disables RAID 5 write operations for ioaccel-enabled volumes. Enabling can improve sequential write performance. See the ssd_smart_path_enabled disk attribute section for details on ioaccel-enabled volumes. The default value is 1 (RAID 5 writes enabled).

Enable Exemple :

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

/sys/class/scsi_host/host*/enable_r6_writes

The enable_r6_writes attribute is read-write. This attribute enables/disables RAID 6 write operations for ioaccel-enabled volumes. Enabling can improve sequential write performance. See the ssd_smart_path_enabled disk attribute section for details on ioaccel-enabled volumes. The default value is 1 (RAID 6 writes enabled).

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 SAS0 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 moteur 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

The path_info attribute is read-only. This attribute contains the c:b:t:l of the device along with the device type and whether the device is Active or Inactive. If the device is an HBA device, path_info will also display the PORT, BOX, and BAY the device is plugged into.

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

The raid_bypass_cnt attribute is read-only. This attribute contains the number of I/O requests that have gone through the ioaccel path for ioaccel-enabled volumes. See the ssd_smart_path_enabled disk attribute section for details on ioaccel-enabled volumes.

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

The sas_ncq_prio_enable attribute is read/write. This attribute enables SATA NCQ priority support. This attribute works only when device has NCQ support and controller firmware can handle IO with NCQ priority attribute.

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.