smartpqi(4) Device Drivers Manual smartpqi(4) NOM smartpqi -- pilote SCSI pour Microchi Smart Storage SYNOPSIS modprobe smartpqi [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 controleurs Microchip Smart Storage. Operations ioctl() prises en charge Par soucis de compatibilite avec les applications ecrites pour les pilotes cciss(4) et hpsa(4), de nombreuses operations ioctl(2), mais pas toutes, prises en charge par le pilote hpsa sont aussi prises en charge par le pilote smartpqi. Les structures de donnees utilisees par ces operations sont decrites dans le fichier source du noyau Linux include/linux/cciss_ioctl.h. CCISS_DEREGDISK CCISS_REGNEWDISK CCISS_REGNEWD Ces operations font toutes les trois la meme chose, a savoir forcer le pilote a rechercher des nouveaux peripheriques. Cela revient exactement a ecrire dans l'attribut d'hote rescan specifique a smartpqi. CCISS_GETPCIINFO Cette operation renvoie les domaine, bus, dispositif et fonction PCI, ainsi que l'<< identifiant de carte >> (identifiant du sous-systeme PCI). CCISS_GETDRIVVER Cette operation renvoie la version du pilote encodee dans quatre octets comme suit : (version_majeure << 28) | (version_mineure << 24) | (publication << 16) | revision CCISS_PASSTHRU Permettre aux commandes BMIC et CISS d'etre passees au controleur. Options de demarrage disable_device_id_wildcards={0|1} Desactiver la prise en charge des ID jocker de peripherique. La valeur par defaut est 0 (les jocker sont actives). disable_heartbeat={0|1} Desactiver la prise en charge de la verification du << heartbeat >> du controleur. Ce parametre est utilise dans le cadre du debogage. La valeur par defaut est 0 (la verification du << heartbeat >> du controleur est activee). disable_ctrl_shutdown={0|1} Desactiver la prise en charge de la fermeture du controleur en cas de verrouillage du controleur. La valeur par defaut est 0 (le controleur sera arrete). lockup_action={none|reboot|panic} Specifier l'action que le pilote entreprend quand un verrouillage du controleur est detectee. L'action par defaut est none. parametre action -------------------------------------------------------------- none mettre seulement le controleur hors ligne reboot redemarrer le systeme panic declencher une panique du systeme expose_ld_first={0|1} Cette option expose les peripheriques logiques au systeme d'exploitation avant les peripheriques physiques. La valeur par defaut est 0 (peripheriques physiques actives en premier). hide_vsep={0|1} Cette option desactive l'exposition du SEP virtuel au systeme d'exploitation. La valeur par defaut est 0 (SEP virtuel expose). 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. FICHIERS Noeuds de peripheriques On accede 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 controleur RAID via le pilote SCSI generique (sg), avec des noeuds de peripherique appeles respectivement /dev/sd*, /dev/st*, et /dev/sg*. Fichiers d'attribut d'hote specifiques a SmartPQI dans /sys /sys/class/scsi_host/host*/rescan L'attribut rescan de l'hote est un attribut en ecriture seule. Ecrire dans cet attribut forcera le pilote a rechercher les peripheriques nouveaux, modifies ou retires (par exemple, des lecteurs de bandes branches a chaud ou des volumes logiques nouvellement configures ou supprimes, etc.) et prevenir la couche intermediaire SCSI de tout changement detecte. Normalement, une telle recherche est declenchee automatiquement par les modifications de configuration, donc l'utilisateur ne devrait normalement pas avoir a ecrire dans ce fichier. Cet attribut peut s'averer utile lors du branchement a chaud de peripheriques tels que les lecteurs de bandes ou des boitiers entiers de stockage contenant des volumes logiques preconfigures. /sys/class/scsi_host/host*/lockup_action L'attribut lockup_action de l'hote est un attribut en lecture et en ecriture. Cet attribut fera que le pilote realisera une action specifique dans le cas peu probable ou un verrouillage du controleur aura ete detecte. 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 controleur. 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 chaine d'identification produit du controleur. 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 numero unique d'identification du controleur. 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 chaine d'identification du fabricant du controleur. 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 specifiques a SmartPQI dans /sys Dans les specifications du fichier ci-dessous, c est le numero du controleur SCSI approprie, b est le numero de bus, t le numero de cible et l est le numero d'unite 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 peripherique. 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 ou ioaccel est active. (Ioaccel est un chemin alternatif de soumission du pilote qui permet au pilote d'envoyer des requetes d'E/S directement aux peripheriques du moteur SCSI en contournant le microprogramme du controleur. Cela aboutit a une meilleure performance. Cette methode est utilisee pour les disques HBA et pour les volumes logiques composes de SSD.). Il contient 1 si ioaccel est active 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 peripherique. 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 facon unique le peripherique dans le controleur. 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 VERSIONS Le pilote smartpqi a ete ajoute dans Linux 4.9. NOTES Configuration Pour configurer un controleur Microchip Smart Storage, veuillez vous referer au guide d'utilisation du controleur que vous trouverez en recherchant le controleur specifique sur la page . HISTORIQUE /sys/class/scsi_host/host*/version a ete remplace par deux entrees 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 francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot , Cedric Boutillier , Frederic Hantrais et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 smartpqi(4)