1 .. SPDX-License-Identifier: GPL-2.0
2
3 =========================================
4 HPSA - Hewlett Packard Smart Array driver
5 =========================================
6
7 This file describes the hpsa SCSI driver for H
8 The hpsa driver is intended to supplant the cc
9 Smart Array controllers. The hpsa driver is a
10 cciss driver is a "block" driver. Actually cc
11 driver (for logical drives) AND a SCSI driver
12 "split-brained" design of the cciss driver is
13 complexity and eliminating that complexity is
14 for hpsa to exist.
15
16 Supported devices
17 =================
18
19 - Smart Array P212
20 - Smart Array P410
21 - Smart Array P410i
22 - Smart Array P411
23 - Smart Array P812
24 - Smart Array P712m
25 - Smart Array P711m
26 - StorageWorks P1210m
27
28 Additionally, older Smart Arrays may work with
29 boot parameter "hpsa_allow_any=1" is specified
30 nor supported by HP with this driver. For old
31 driver should still be used.
32
33 The "hpsa_simple_mode=1" boot parameter may be
34 putting the controller into "performant" mode.
35 mode, each command completion requires an inte
36 (the default, and ordinarily better performing
37 command completions indicated by a single inte
38
39 HPSA specific entries in /sys
40 =============================
41
42 In addition to the generic SCSI attributes a
43 the following attributes:
44
45 HPSA specific host attributes
46 =============================
47
48 ::
49
50 /sys/class/scsi_host/host*/rescan
51 /sys/class/scsi_host/host*/firmware_revisi
52 /sys/class/scsi_host/host*/resettable
53 /sys/class/scsi_host/host*/transport_mode
54
55 the host "rescan" attribute is a write only
56 attribute will cause the driver to scan for
57 (e.g. hot-plugged tape drives, or newly conf
58 etc.) and notify the SCSI midlayer of any ch
59 triggered automatically by HP's Array Config
60 command line variety) so for logical drive c
61 normally have to use this. It may be useful
62 tape drives, or entire storage boxes contain
63
64 The "firmware_revision" attribute contains t
65 For example::
66
67 root@host:/sys/class/scsi_host/host4#
68 7.14
69
70 The transport_mode indicates whether the con
71 or "simple" mode. This is controlled by the
72 parameter.
73
74 The "resettable" read-only attribute indicat
75 controller is able to honor the "reset_devic
76 device is resettable, this file will contain
77 parameter is used by kdump, for example, to
78 load time to eliminate any outstanding comma
79 controller into a known state so that the kd
80 and not be disrupted in any way by stale com
81 remaining on the controller from the previou
82 kexec tools to warn the user if they attempt
83 unable to honor the reset_devices kernel par
84
85 HPSA specific disk attributes
86 -----------------------------
87
88 ::
89
90 /sys/class/scsi_disk/c:b:t:l/device/unique
91 /sys/class/scsi_disk/c:b:t:l/device/raid_l
92 /sys/class/scsi_disk/c:b:t:l/device/lunid
93
94 (where c:b:t:l are the controller, bus, targ
95
96 For example::
97
98 root@host:/sys/class/scsi_disk/4:0:0:0
99 600508B1001044395355323037570F77
100 root@host:/sys/class/scsi_disk/4:0:0:0
101 0x0000004000000000
102 root@host:/sys/class/scsi_disk/4:0:0:0
103 RAID 0
104
105 HPSA specific ioctls
106 ====================
107
108 For compatibility with applications written
109 not all of the ioctls supported by the cciss
110 hpsa driver. The data structures used by th
111 include/linux/cciss_ioctl.h
112
113 CCISS_DEREGDISK, CCISS_REGNEWDISK, CCISS_REG
114 The above three ioctls all do exactly
115 to rescan for new devices. This does
116 hpsa specific host "rescan" attribute.
117
118 CCISS_GETPCIINFO
119 Returns PCI domain, bus, device and fu
120
121 CCISS_GETDRIVVER
122 Returns driver version in three bytes
123
124 (major_version << 16) | (minor
125
126 CCISS_PASSTHRU, CCISS_BIG_PASSTHRU
127 Allows "BMIC" and "CISS" commands to b
128 These are used extensively by the HP A
129 agents, etc. See cciss_vol_status at
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.