Commit | Line | Data |
---|---|---|
249d29c8 SW |
1 | .\" Copyright (c) 2006 Scott Long |
2 | .\" All rights reserved. | |
3 | .\" | |
4 | .\" Redistribution and use in source and binary forms, with or without | |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" | |
13 | .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND | |
14 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
15 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
16 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE | |
17 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
18 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
19 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
20 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
21 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
22 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
23 | .\" SUCH DAMAGE. | |
24 | .\" | |
25 | .\" $FreeBSD: src/share/man/man4/mfi.4,v 1.13 2010/05/12 17:12:38 brueffer Exp $ | |
26 | .\" | |
26595b18 | 27 | .Dd November 28, 2014 |
249d29c8 SW |
28 | .Dt MFI 4 |
29 | .Os | |
30 | .Sh NAME | |
31 | .Nm mfi | |
32 | .Nd "LSI MegaRAID SAS driver" | |
33 | .Sh SYNOPSIS | |
34 | To compile this driver into the kernel, | |
35 | place the following lines in your | |
36 | kernel configuration file: | |
37 | .Bd -ragged -offset indent | |
38 | .Cd "device pci" | |
39 | .Cd "device mfi" | |
40 | .Ed | |
41 | .Pp | |
42 | Alternatively, to load the driver as a | |
43 | module at boot time, place the following line in | |
44 | .Xr loader.conf 5 : | |
45 | .Bd -literal -offset indent | |
46 | mfi_load="YES" | |
47 | .Ed | |
48 | .Sh DESCRIPTION | |
49 | This driver is for LSI's next generation PCI Express SAS RAID controllers. | |
50 | Access to RAID arrays (logical disks) from this driver is provided via | |
51 | .Pa /dev/mfid? | |
17566092 SW |
52 | and access to JBOD disks is provided via |
53 | .Pa /dev/mfisyspd? | |
249d29c8 SW |
54 | device nodes. |
55 | A simple management interface is also provided on a per-controller basis via | |
56 | the | |
57 | .Pa /dev/mfi? | |
58 | device node. | |
59 | .Pp | |
60 | The | |
61 | .Nm | |
62 | name is derived from the phrase "MegaRAID Firmware Interface", which is | |
63 | substantially different than the old "MegaRAID" interface and thus requires | |
64 | a new driver. | |
6d743f04 | 65 | .Pp |
249d29c8 SW |
66 | Older SCSI and SATA MegaRAID cards are supported by |
67 | .Xr amr 4 | |
68 | and will not work with this driver. | |
6d743f04 SW |
69 | Likewise, newer LSI MegaRAID SAS controllers are supported by |
70 | .Xr mrsas 4 | |
71 | and will not work with this driver. | |
249d29c8 | 72 | .Pp |
17566092 SW |
73 | 3 Gb/s and 6 Gb/s support both initiator target (IT) and integrated RAID (IR) |
74 | firmware (see | |
75 | .Pa http://kb.lsi.com/KnowledgebaseArticle16266.aspx ) . | |
76 | The | |
77 | .Nm | |
78 | driver supports controllers with an IR image. | |
79 | At least some cards (such as the | |
80 | .Tn IBM ServeRAID M1015 ) | |
81 | will attach to the | |
82 | .Xr mps 4 | |
83 | driver when IT firmware is used. | |
84 | .Pp | |
249d29c8 SW |
85 | Two sysctls are provided to tune the |
86 | .Nm | |
87 | driver's behavior when a request is made to remove a mounted volume. | |
88 | By default the driver will disallow any requests to remove a mounted volume. | |
89 | If the sysctl | |
90 | .Va dev.mfi.%d.delete_busy_volumes | |
91 | is set to 1, | |
92 | then the driver will allow mounted volumes to be removed. | |
26595b18 SW |
93 | To not detach the mfid device for a busy volume that is deleted, set the |
94 | sysctl | |
95 | .Va dev.mfi.%d.keep_deleted_volumes | |
96 | to 1. | |
5cee4cf5 SW |
97 | .Sh LOADER TUNABLES |
98 | .Bl -tag -width indent | |
99 | .It Va hw.mfi.msi.enable | |
100 | By default, the driver will use MSI if it is supported. | |
101 | This behavior can be turned off by setting this tunable to 0. | |
102 | .El | |
249d29c8 SW |
103 | .Sh HARDWARE |
104 | The | |
105 | .Nm | |
106 | driver supports the following hardware: | |
107 | .Pp | |
108 | .Bl -bullet -compact | |
109 | .It | |
110 | LSI MegaRAID SAS 1078 | |
111 | .It | |
112 | LSI MegaRAID SAS 8408E | |
113 | .It | |
114 | LSI MegaRAID SAS 8480E | |
115 | .It | |
17566092 SW |
116 | LSI MegaRAID SAS 9240-4i |
117 | .It | |
118 | LSI MegaRAID SAS 9240-8i | |
119 | .It | |
120 | LSI MegaRAID SAS 9260-4i | |
121 | .It | |
122 | LSI MegaRAID SAS 9260-8i | |
123 | .It | |
124 | LSI MegaRAID SAS 9260DE-8i | |
125 | .It | |
126 | LSI MegaRAID SAS 9260-16i | |
127 | .It | |
128 | LSI MegaRAID SAS 9261-8i | |
129 | .It | |
130 | LSI MegaRAID SAS 9280-4i4e | |
131 | .It | |
132 | LSI MegaRAID SAS 9280-8e | |
133 | .It | |
134 | LSI MegaRAID SAS 9280DE-8e | |
135 | .It | |
136 | LSI MegaRAID SAS 9280-16i4e | |
137 | .It | |
138 | LSI MegaRAID SAS 9280-24i4e | |
249d29c8 SW |
139 | .It |
140 | Dell PERC5 | |
141 | .It | |
142 | Dell PERC6 | |
143 | .It | |
590ba11d SW |
144 | Dell PERC H710 Embedded |
145 | .It | |
146 | Dell PERC H710 Adapter | |
147 | .It | |
148 | Dell PERC H710 Mini (blades) | |
149 | .It | |
150 | Dell PERC H710 Mini (monolithics) | |
151 | .It | |
152 | Dell PERC H710P Adapter | |
153 | .It | |
154 | Dell PERC H710P Mini (blades) | |
155 | .It | |
156 | Dell PERC H710P Mini (monolithics) | |
157 | .It | |
158 | Dell PERC H810 Adapter | |
159 | .It | |
17566092 SW |
160 | IBM ServeRAID M1015 SAS/SATA |
161 | .It | |
249d29c8 SW |
162 | IBM ServeRAID M5015 SAS/SATA |
163 | .It | |
164 | IBM ServeRAID-MR10i | |
165 | .It | |
166 | Intel RAID Controller SROMBSAS18E | |
590ba11d SW |
167 | .It |
168 | Intel RAID Controller RS25DB080 | |
169 | .It | |
170 | Intel RAID Controller RS25NB008 | |
249d29c8 SW |
171 | .El |
172 | .Sh FILES | |
17566092 | 173 | .Bl -tag -width ".Pa /dev/mfisyspd?" -compact |
249d29c8 SW |
174 | .It Pa /dev/mfid? |
175 | array/logical disk interface | |
17566092 SW |
176 | .It Pa /dev/mfisyspd? |
177 | JBOD disk interface | |
249d29c8 SW |
178 | .It Pa /dev/mfi? |
179 | management interface | |
180 | .El | |
181 | .Sh DIAGNOSTICS | |
182 | .Bl -diag | |
183 | .It "mfid%d: Unable to delete busy device" | |
184 | An attempt was made to remove a mounted volume. | |
17566092 SW |
185 | .It "mfisyspd%d: Unable to delete busy device" |
186 | dito for JBOD disks | |
249d29c8 SW |
187 | .El |
188 | .Sh SEE ALSO | |
189 | .Xr amr 4 , | |
17566092 | 190 | .Xr mps 4 , |
6d743f04 | 191 | .Xr mrsas 4 , |
249d29c8 SW |
192 | .Xr pci 4 , |
193 | .Xr mfiutil 8 | |
194 | .Sh HISTORY | |
195 | The | |
196 | .Nm | |
197 | driver first appeared in | |
198 | .Fx 6.1 . | |
199 | .Sh AUTHORS | |
200 | The | |
201 | .Nm | |
202 | driver and this manual page were written by | |
b2a6f486 | 203 | .An Scott Long Aq Mt scottl@FreeBSD.org . |
17566092 SW |
204 | .\".Sh BUGS |
205 | .\"The driver does not support big-endian architectures at this time. |