]>
Commit | Line | Data |
---|---|---|
f8f39c1e MK |
1 | .\" Copyright (C) 2011, Hewlett-Packard Development Company, L.P. |
2 | .\" Written by Stephen M. Cameron <scameron@beardog.cce.hp.com> | |
2297bf0e | 3 | .\" |
c850ff7e | 4 | .\" SPDX-License-Identifier: GPL-2.0-only |
1976f57a | 5 | .\" |
b9d931bb SC |
6 | .\" shorthand for double quote that works everywhere. |
7 | .ds q \N'34' | |
ab47278f | 8 | .TH HPSA 4 (date) "Linux man-pages (unreleased)" |
b9d931bb SC |
9 | .SH NAME |
10 | hpsa \- HP Smart Array SCSI driver | |
11 | .SH SYNOPSIS | |
12 | .nf | |
13 | modprobe hpsa [ hpsa_allow_any=1 ] | |
14 | .fi | |
15 | .SH DESCRIPTION | |
16 | .B hpsa | |
17 | is a SCSI driver for HP Smart Array RAID controllers. | |
b3acff55 MK |
18 | .SS Options |
19 | .IR "hpsa_allow_any=1" : | |
b9d931bb | 20 | This option allows the driver to attempt to operate on |
32627bf7 MK |
21 | any HP Smart Array hardware RAID controller, |
22 | even if it is not explicitly known to the driver. | |
23 | This allows newer hardware to work with older drivers. | |
24 | Typically this is used to allow installation of | |
9b892397 | 25 | operating systems from media that predates the |
32627bf7 MK |
26 | RAID controller, though it may also be used to enable |
27 | .B hpsa | |
28 | to drive older controllers that would normally be handled by the | |
b3acff55 MK |
29 | .BR cciss (4) |
30 | driver. | |
31 | These older boards have not been tested and are | |
32 | not supported with | |
33 | .BR hpsa , | |
34 | and | |
35 | .BR cciss (4) | |
36 | should still be used for these. | |
c634028a | 37 | .SS Supported hardware |
b9d931bb SC |
38 | The |
39 | .B hpsa | |
40 | driver supports the following Smart Array boards: | |
bdd915e2 | 41 | .PP |
b9d931bb | 42 | .nf |
b3acff55 MK |
43 | Smart Array P700M |
44 | Smart Array P212 | |
45 | Smart Array P410 | |
46 | Smart Array P410i | |
47 | Smart Array P411 | |
48 | Smart Array P812 | |
49 | Smart Array P712m | |
50 | Smart Array P711m | |
51 | StorageWorks P1210m | |
b9d931bb | 52 | .fi |
70d6fc4c ES |
53 | .PP |
54 | .\" commit 135ae6edeb51979d0998daf1357f149a7d6ebb08 | |
bc4590d9 | 55 | Since Linux 4.14, the following Smart Array boards are also supported: |
70d6fc4c ES |
56 | .PP |
57 | .nf | |
58 | Smart Array 5300 | |
59 | Smart Array 5312 | |
60 | Smart Array 532 | |
61 | Smart Array 5i | |
62 | Smart Array 6400 | |
63 | Smart Array 6400 EM | |
64 | Smart Array 641 | |
65 | Smart Array 642 | |
66 | Smart Array 6i | |
67 | Smart Array E200 | |
68 | Smart Array E200i | |
69 | Smart Array E200i | |
70 | Smart Array E200i | |
71 | Smart Array E200i | |
72 | Smart Array E500 | |
73 | Smart Array P400 | |
74 | Smart Array P400i | |
75 | Smart Array P600 | |
76 | Smart Array P700m | |
77 | Smart Array P800 | |
78 | .fi | |
c634028a | 79 | .SS Configuration details |
9b892397 MK |
80 | To configure HP Smart Array controllers, |
81 | use the HP Array Configuration Utility (either | |
32627bf7 MK |
82 | .BR hpacuxe (8) |
83 | or | |
84 | .BR hpacucli (8)) | |
85 | or the Offline ROM-based Configuration Utility (ORCA) | |
b9d931bb SC |
86 | run from the Smart Array's option ROM at boot time. |
87 | .SH FILES | |
c634028a | 88 | .SS Device nodes |
32627bf7 MK |
89 | Logical drives are accessed via the SCSI disk driver |
90 | .RB ( sd (4)), | |
91 | tape drives via the SCSI tape driver | |
92 | .RB ( st (4)), | |
93 | and | |
94 | the RAID controller via the SCSI generic driver | |
95 | .RB ( sg (4)), | |
96 | with device nodes named | |
c367cd59 | 97 | .IR /dev/sd* , |
b3acff55 MK |
98 | .IR /dev/st* , |
99 | and | |
100 | .IR /dev/sg* , | |
101 | respectively. | |
c634028a | 102 | .SS HPSA-specific host attribute files in /sys |
b3acff55 MK |
103 | .TP |
104 | .I /sys/class/scsi_host/host*/rescan | |
32627bf7 | 105 | This is a write-only attribute. |
9b892397 | 106 | Writing to this attribute will cause the driver to scan for |
d1f84ed7 | 107 | new, changed, or removed devices (e.g., hot-plugged tape drives, |
9b892397 MK |
108 | or newly configured or deleted logical drives, etc.) |
109 | and notify the SCSI midlayer of any changes detected. | |
32627bf7 MK |
110 | Normally a rescan is triggered automatically |
111 | by HP's Array Configuration Utility (either the GUI or the | |
112 | command-line variety); | |
113 | thus, for logical drive changes, the user should not | |
114 | normally have to use this attribute. | |
115 | This attribute may be useful when hot plugging devices like tape drives, | |
080e0035 | 116 | or entire storage boxes containing preconfigured logical drives. |
b3acff55 MK |
117 | .TP |
118 | .I /sys/class/scsi_host/host*/firmware_revision | |
32627bf7 | 119 | This attribute contains the firmware version of the Smart Array. |
5b539973 | 120 | .IP |
b9d931bb | 121 | For example: |
5b539973 | 122 | .IP |
bdd915e2 MK |
123 | .in +4n |
124 | .EX | |
125 | # \fBcd /sys/class/scsi_host/host4\fP | |
126 | # \fBcat firmware_revision\fP | |
127 | 7.14 | |
128 | .EE | |
129 | .in | |
130 | .\" | |
c634028a | 131 | .SS HPSA-specific disk attribute files in /sys |
b3acff55 MK |
132 | .TP |
133 | .I /sys/class/scsi_disk/c:b:t:l/device/unique_id | |
9b892397 | 134 | This attribute contains a 32 hex-digit unique ID for each logical drive. |
bdd915e2 | 135 | .IP |
b9d931bb | 136 | For example: |
bdd915e2 MK |
137 | .IP |
138 | .in +4n | |
139 | .EX | |
140 | # \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP | |
141 | # \fBcat unique_id\fP | |
142 | 600508B1001044395355323037570F77 | |
143 | .EE | |
144 | .in | |
b3acff55 MK |
145 | .TP |
146 | .I /sys/class/scsi_disk/c:b:t:l/device/raid_level | |
32627bf7 | 147 | This attribute contains the RAID level of each logical drive. |
bdd915e2 | 148 | .IP |
b9d931bb | 149 | For example: |
bdd915e2 MK |
150 | .IP |
151 | .in +4n | |
152 | .EX | |
153 | # \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP | |
154 | # \fBcat raid_level\fP | |
155 | RAID 0 | |
156 | .EE | |
157 | .in | |
b3acff55 MK |
158 | .TP |
159 | .I /sys/class/scsi_disk/c:b:t:l/device/lunid | |
9b892397 MK |
160 | This attribute contains the 16 hex-digit (8 byte) LUN ID |
161 | by which a logical drive or physical device can be addressed. | |
32627bf7 | 162 | .IR c : b : t : l |
a797afac | 163 | are the controller, bus, target, and lun of the device. |
bdd915e2 | 164 | .PP |
b9d931bb | 165 | For example: |
bdd915e2 MK |
166 | .IP |
167 | .in +4n | |
168 | .EX | |
169 | # \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP | |
170 | # \fBcat lunid\fP | |
171 | 0x0000004000000000 | |
172 | .EE | |
173 | .in | |
174 | .\" | |
b3acff55 | 175 | .SS Supported ioctl() operations |
32627bf7 MK |
176 | For compatibility with applications written for the |
177 | .BR cciss (4) | |
178 | driver, many, but | |
179 | not all of the ioctls supported by the | |
180 | .BR cciss (4) | |
181 | driver are also supported by the | |
182 | .B hpsa | |
183 | driver. | |
184 | The data structures used by these ioctls are described in | |
66a9882e | 185 | the Linux kernel source file |
b3acff55 MK |
186 | .IR include/linux/cciss_ioctl.h . |
187 | .TP | |
188 | .BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD | |
32627bf7 | 189 | These three ioctls all do exactly the same thing, |
b3acff55 MK |
190 | which is to cause the driver to rescan for new devices. |
191 | This does exactly the same thing as writing to the | |
192 | hpsa-specific host "rescan" attribute. | |
193 | .TP | |
194 | .B CCISS_GETPCIINFO | |
735334d4 | 195 | Returns PCI domain, bus, device, and function and "board ID" (PCI subsystem ID). |
b3acff55 MK |
196 | .TP |
197 | .B CCISS_GETDRIVVER | |
b9d931bb | 198 | Returns driver version in three bytes encoded as: |
bdd915e2 MK |
199 | .IP |
200 | .in +4n | |
201 | .EX | |
202 | (major_version << 16) | (minor_version << 8) | | |
203 | (subminor_version) | |
204 | .EE | |
205 | .in | |
b3acff55 MK |
206 | .TP |
207 | .BR CCISS_PASSTHRU ", " CCISS_BIG_PASSTHRU | |
b9d931bb | 208 | Allows "BMIC" and "CISS" commands to be passed through to the Smart Array. |
9b892397 | 209 | These are used extensively by the HP Array Configuration Utility, |
f78ed33a | 210 | SNMP storage agents, and so on. |
b3acff55 | 211 | See |
32627bf7 MK |
212 | .I cciss_vol_status |
213 | at | |
608bf950 SK |
214 | .UR http://cciss.sf.net |
215 | .UE | |
b3acff55 | 216 | for some examples. |
47297adb | 217 | .SH SEE ALSO |
b3acff55 MK |
218 | .BR cciss (4), |
219 | .BR sd (4), | |
220 | .BR st (4), | |
221 | .BR cciss_vol_status (8), | |
222 | .BR hpacucli (8), | |
ab59d225 | 223 | .BR hpacuxe (8) |
5b539973 | 224 | .PP |
608bf950 SK |
225 | .UR http://cciss.sf.net |
226 | .UE , | |
4eaa04c5 | 227 | and |
b3acff55 MK |
228 | .I Documentation/scsi/hpsa.txt |
229 | and | |
b49c2acb | 230 | .I Documentation/ABI/testing/sysfs\-bus\-pci\-devices\-cciss |
173fe7e7 | 231 | in the Linux kernel source tree |
2df38100 MK |
232 | .\" .SH AUTHORS |
233 | .\" Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel | |
234 | .\" and probably some other people. |