fb6a449c3ac44d008ec584282492bf3f289639c7
[dragonfly.git] / share / man / man4 / mpt.4
1 .\"     $NetBSD: mpt.4,v 1.1 2003/04/16 22:32:15 thorpej Exp $
2 .\"
3 .\" Copyright (c) 2003 Wasabi Systems, Inc.
4 .\" All rights reserved.
5 .\"
6 .\" Written by Jason R. Thorpe for Wasabi Systems, Inc.
7 .\"
8 .\" Redistribution and use in source and binary forms, with or without
9 .\" modification, are permitted provided that the following conditions
10 .\" are met:
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\"    notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\"    notice, this list of conditions and the following disclaimer in the
15 .\"    documentation and/or other materials provided with the distribution.
16 .\" 3. All advertising materials mentioning features or use of this software
17 .\"    must display the following acknowledgement:
18 .\"     This product includes software developed for the NetBSD Project by
19 .\"     Wasabi Systems, Inc.
20 .\" 4. The name of Wasabi Systems, Inc. may not be used to endorse
21 .\"    or promote products derived from this software without specific prior
22 .\"    written permission.
23 .\"
24 .\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
26 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
27 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
28 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34 .\" POSSIBILITY OF SUCH DAMAGE.
35 .\"
36 .\" $FreeBSD: head/share/man/man4/mpt.4 236623 2012-06-05 17:49:11Z obrien $
37 .\"
38 .Dd July 21, 2012
39 .Dt MPT 4
40 .Os
41 .Sh NAME
42 .Nm mpt
43 .Nd LSI Fusion-MPT SCSI/Fibre Channel driver
44 .Sh SYNOPSIS
45 To compile this driver into the kernel,
46 place the following lines in your
47 kernel configuration file:
48 .Bd -ragged -offset indent
49 .Cd "device scbus"
50 .Cd "device mpt"
51 .Ed
52 .Pp
53 Alternatively, to load the driver as a
54 module at boot time, place the following line in
55 .Xr loader.conf 5 :
56 .Bd -literal -offset indent
57 mpt_load="YES"
58 .Ed
59 .Sh DESCRIPTION
60 The
61 .Nm
62 driver provides support
63 for the LSI Logic Fusion-MPT family of
64 .Tn SCSI ,
65 .Tn Fibre Channel
66 and
67 .Tn SAS
68 controllers.
69 .Sh LOADER TUNABLES
70 .Bl -tag -width indent
71 .It Va hw.mpt.msi.enable
72 This tunable specifies whether MSI will be used or not, provided the
73 controller supports it.
74 By default, the driver will use MSI for SAS adapters.
75 .El
76 .Sh HARDWARE
77 The following controllers are supported by the
78 .Nm
79 driver:
80 .Pp
81 .Bl -bullet -compact
82 .It
83 LSI Logic 53c1030,
84 LSI Logic LSI2x320-X
85 (Single and Dual Ultra320
86 .Tn SCSI )
87 .It
88 LSI Logic AS1064,
89 LSI Logic AS1068
90 .Pq Tn SAS/SATA
91 .It
92 LSI Logic FC909
93 (1Gb/s
94 .Tn Fibre Channel )
95 .It
96 LSI Logic FC909A
97 (Dual 1Gb/s
98 .Tn Fibre Channel )
99 .It
100 LSI Logic FC919,
101 LSI Logic 7102XP-LC
102 (Single 2Gb/s
103 .Tn Fibre Channel )
104 .It
105 LSI Logic FC929,
106 LSI Logic FC929X,
107 LSI Logic 7202XP-LC
108 (Dual 2Gb/s
109 .Tn Fibre Channel )
110 .It
111 LSI Logic FC949X
112 (Dual 4Gb/s
113 .Tn Fibre Channel )
114 .It
115 LSI Logic FC949E,
116 LSI Logic FC949ES
117 (Dual 4Gb/s
118 .Tn Fibre Channel PCI-Express)
119 .El
120 .Pp
121 The
122 .Tn Ultra 320 SCSI
123 controller chips supported by the
124 .Nm
125 driver can be found onboard on many systems including:
126 .Pp
127 .Bl -bullet -compact
128 .It
129 Dell PowerEdge 1750 thru 2850
130 .It
131 IBM eServer xSeries 335
132 .El
133 .Pp
134 These systems also contain Integrated RAID Mirroring and Integrated
135 RAID Mirroring Enhanced which this driver also supports.
136 .Pp
137 The 53c1030 is also available in
138 .Tn VMware
139 products.
140 .Pp
141 The
142 .Tn SAS
143 controller chips are also present on many new AMD/Opteron based systems,
144 like the Sun 4100.
145 Note that this controller can drive both SAS and SATA
146 drives or a mix of them at the same time.
147 The Integrated RAID Mirroring
148 available for these controllers is poorly supported at best.
149 .Pp
150 The
151 .Tn Fibre Channel
152 controller chipset are supported by a broad variety of speeds and systems.
153 The
154 .Tn Apple
155 Fibre Channel HBA is in fact the
156 .Tn FC949ES
157 card.
158 .Pp
159 This driver also supports target mode for Fibre Channel cards.
160 This support may be enabled by setting the desired role of the core via
161 the LSI Logic firmware utility that establishes what roles the card
162 can take on - no separate compilation is required.
163 .Sh SEE ALSO
164 .Xr cd 4 ,
165 .Xr ch 4 ,
166 .Xr da 4 ,
167 .Xr mps 4 ,
168 .Xr pci 4 ,
169 .Xr sa 4 ,
170 .Xr scsi 4 ,
171 .Xr targ 4 ,
172 .Xr mptutil 8
173 .Rs
174 .%T "LSI Logic Website"
175 .%O http://www.lsi.com/
176 .Re
177 .Sh HISTORY
178 The
179 .Nm
180 driver first appeared in
181 .Fx 4.6 .
182 .Sh AUTHORS
183 .An -nosplit
184 The
185 .Nm
186 driver was originally written for
187 .Fx
188 by
189 .An Greg Ansley
190 and marginally improved upon
191 by
192 .An Matt Jacob Aq Mt mjacob@FreeBSD.org .
193 .Pp
194 .An Justin Gibbs Aq Mt gibbs@FreeBSD.org
195 and
196 .An Scott Long Aq Mt scottl@FreeBSD.org
197 have made more substantial improvements.