smartpqi
Table des matières
Retour à l'index
NOM
smartpqi — pilote SCSI pour Microchip Smart Storage
SYNOPSIS
[disable_device_id_wildcards={0|1}]
[disable_heartbeat={0|1}] [disable_ctrl_shutdown={0|1}]
[lockup_action={none|reboot|panic}]
[expose_ld_first={0|1}] [hide_vsep={0|1}]
[disable_managed_interrupts={0|1}]
[ctrl_ready_timeout={0|[30,1800]}]
DESCRIPTION
smartpqi est un pilote SCSI pour les contrôleurs Microchip Smart Storage.
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 |
| 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.
FICHIERS
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
VERSIONS
Le pilote smartpqi a été ajouté dans Linux 4.9.
NOTES
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
HISTORIQUE
/sys/class/scsi_host/host*/version a été remplacé par deux entrées de
sysfs :
-
/sys/class/scsi_host/host*/driver_version
-
/sys/class/scsi_host/host*/firmware_version
VOIR AUSSI
cciss(4), hpsa(4), sd(4), st(4), sg(4)
Documentation/ABI/testing/sysfs-bus-pci-devices-cciss dans les fichiers
source du noyau Linux
TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.rafin@laposte.net>,
Thierry Vignaud <tvignaud@mandriva.com>,
François Micaux,
Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>,
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>,
David Prévot <david@tilapin.org>,
Cédric Boutillier <cedric.boutillier@gmail.com>,
Frédéric Hantrais <fhantrais@gmail.com>
et
Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à la
GNU General Public License version 3
concernant les conditions de copie et
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- Opérations ioctl/() prises en charge
-
- Options de démarrage
-
- FICHIERS
-
- Nœuds de périphériques
-
- Fichiers d'attribut d'hôte spécifiques à SmartPQI dans /sys
-
- Fichiers d'attribut de disque spécifiques à SmartPQI dans /sys
-
- VERSIONS
-
- NOTES
-
- Configuration
-
- HISTORIQUE
-
- VOIR AUSSI
-
- TRADUCTION
-
This document was created by
man2html,
using the manual pages.
Time: 05:06:32 GMT, September 19, 2025