1SMARTPQI(4) Linux Programmer's Manual SMARTPQI(4)
2
6 smartpqi - Microsemi Smart Family SCSI driver
7
9 modprobe smartpqi [disable_device_id_wildcards={0|1}]
10 [disable_heartbeat={0|1}]
11 [disable_ctrl_shutdown={0|1}]
12 [lockup_action={none|reboot|panic}]
13
15 smartpqi is a SCSI driver for Microsemi Smart Family controllers.
16 Supported ioctl() operations
18 For compatibility with applications written for the cciss(4) and
19 hpsa(4) drivers, many, but not all of the ioctl(2) operations supported
20 by the hpsa driver are also supported by the smartpqi driver. The data
21 structures used by these operations are described in the Linux kernel
22 source file include/linux/cciss_ioctl.h.
23 CCISS_DEREGDISK, CCISS_REGNEWDISK, CCISS_REGNEWD
25 These operations all do exactly the same thing, which is to
26 cause the driver to re-scan for new devices. This does exactly
27 the same thing as writing to the smartpqi-specific host rescan
28 attribute.
29 CCISS_GETPCIINFO
31 This operation Returns the PCI domain, bus, device and function
32 and "board ID" (PCI subsystem ID).
33 CCISS_GETDRIVVER
35 This operation returns the driver version in four bytes, encoded
36 as:
37 (major_version << 28) | (minor_version << 24) |
39 (release << 16) | revision
40 CCISS_PASSTHRU
42 Allows BMIC and CISS commands to be passed through to the con‐
43 troller.
44 Boot options
46 disable_device_id_wildcards={0|1}
47 Disables support for device ID wildcards. The default value is
48 0.
49 disable_heartbeat={0|1}
51 Disables support for the controller's heartbeat check. This
52 parameter is used for debugging purposes. The default value is
53 0, leaving the controller's heartbeat check active.
54 disable_ctrl_shutdown={0|1}
56 Disables support for shutting down the controller in the event
57 of a controller lockup. The default value is 0.
58 lockup_action={none|reboot|panic}
60 Specifies the action the driver takes when a controller lockup
61 is detected. The default action is none.
62 parameter action
64 ─────────────────────────────────────────────
65 none take controller offline only
66 reboot reboot the system
68 panic panic the system
69
71 Device nodes
72 Logical drives are accessed via the SCSI disk driver (sd), tape drives
73 via the SCSI tape driver (st), and the RAID controller via the SCSI
74 generic driver (sg), with device nodes named /dev/sd*, /dev/st*, and
75 /dev/sg*, respectively.
76 SmartPQI-specific host attribute files in /sys
78 /sys/class/scsi_host/host*/rescan
79 The host rescan attribute is a write-only attribute. Writing to
80 this attribute will cause the driver to scan for new, changed,
81 or removed devices (e.g., hot-plugged tape drives, or newly con‐
82 figured or deleted logical drives) and notify the SCSI mid-layer
83 of any changes detected. Usually this action is triggered auto‐
84 matically by configuration changes, so the user should not nor‐
85 mally have to write to this file. Doing so may be useful when
86 hot-plugging devices such as tape drives or entire storage boxes
87 containing pre-configured logical drives.
88 /sys/class/scsi_host/host*/version
90 The host version attribute is a read-only attribute. This
91 attribute contains the driver version and the controller
92 firmware version.
93 For example:
95 $ cat /sys/class/scsi_host/host1/version
97 driver: 1.1.2-126
98 firmware: 1.29-112
99 /sys/class/scsi_host/host*/lockup_action
101 The host lockup_action attribute is a read/write attribute.
102 This attribute will cause the driver to perform a specific
103 action in the unlikely event that a controller lockup has been
104 detected. See OPTIONS above for an explanation of the
105 lockup_action values.
106 SmartPQI-specific disk attribute files in /sys
108 In the file specifications below, c stands for the number of the appro‐
109 priate SCSI controller, b is the bus number, t the target number, and l
110 is the logical unit number (LUN).
111 /sys/class/scsi_disk/c:b:t:l/device/raid_level
113 The raid_level attribute is read-only. This attribute contains
114 the RAID level of each logical drive.
115 For example:
117 $ cat /sys/class/scsi_disk/4:0:0:0/device/raid_level
119 RAID 0
120 /sys/class/scsi_disk/c:b:t:l/device/sas_address
122 The sas_address attribute is read-only. This attribute contains
123 the unique identifier of the disk.
124 For example:
126 $ cat /sys/class/scsi_disk/1:0:3:0/device/sas_address
128 0x5001173d028543a2
129 /sys/class/scsi_disk/c:b:t:l/device/ssd_smart_path_enabled
131 The ssd_smart_path_enabled attribute is read-only. This
132 attribute is for ioaccel-enabled volumes. (Ioaccel is an alter‐
133 native driver submission path that allows the driver to send I/O
134 requests directly to backend SCSI devices, bypassing the con‐
135 troller firmware. This results in an increase in performance.
136 This method is used for HBA disks and for logical volumes com‐
137 prised of SSDs.) Contains 1 if ioaccel is enabled for the vol‐
138 ume and 0 otherwise.
139 For example:
141 $ cat /sys/class/scsi_disk/1:0:3:0/device/ssd_smart_path_enabled
143 0
144
146 The smarpqi driver was added in Linux 4.9.
147
149 Configuration
150 To configure a Microsemi Smart Family controller, refer to the User
151 Guide for the controller, which can be found by searching for the spe‐
152 cific controller at ⟨https://storage.microsemi.com/⟩.
153
155 cciss(4), hpsa(4), sd(4), st(4)
156 Documentation/ABI/testing/sysfs-bus-pci-devices-cciss in the Linux ker‐
158 nel source tree.
159
161 This page is part of release 5.02 of the Linux man-pages project. A
162 description of the project, information about reporting bugs, and the
163 latest version of this page, can be found at
164 https://www.kernel.org/doc/man-pages/.
165Linux 2017-10-19 SMARTPQI(4)