xref: /freebsd/share/man/man4/mpt.4 (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
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$
37.\"
38.Dd January 16, 2021
39.Dt MPT 4
40.Os
41.Sh NAME
42.Nm mpt
43.Nd LSI Fusion-MPT SCSI/Fibre Channel driver
44.Sh SYNOPSIS
45To compile this driver into the kernel,
46place the following lines in your
47kernel configuration file:
48.Bd -ragged -offset indent
49.Cd "device scbus"
50.Cd "device mpt"
51.Ed
52.Pp
53Alternatively, to load the driver as a
54module at boot time, place the following line in
55.Xr loader.conf 5 :
56.Bd -literal -offset indent
57mpt_load="YES"
58.Ed
59.Sh DESCRIPTION
60The
61.Nm
62driver provides support
63for the LSI Logic Fusion-MPT family of
64.Tn SCSI ,
65.Tn Fibre Channel
66and
67.Tn SAS
68controllers.
69.Sh HARDWARE
70The following controllers are supported by the
71.Nm
72driver:
73.Pp
74.Bl -bullet -compact
75.It
76LSI Logic 53c1030,
77LSI Logic LSI2x320-X
78(Single and Dual Ultra320
79.Tn SCSI )
80.It
81LSI Logic AS1064,
82LSI Logic AS1068
83.Pq Tn SAS/SATA
84.It
85LSI Logic FC909
86(1Gb/s
87.Tn Fibre Channel )
88.It
89LSI Logic FC909A
90(Dual 1Gb/s
91.Tn Fibre Channel )
92.It
93LSI Logic FC919,
94LSI Logic 7102XP-LC
95(Single 2Gb/s
96.Tn Fibre Channel )
97.It
98LSI Logic FC929,
99LSI Logic FC929X,
100LSI Logic 7202XP-LC
101(Dual 2Gb/s
102.Tn Fibre Channel )
103.It
104LSI Logic FC949X
105(Dual 4Gb/s
106.Tn Fibre Channel )
107.It
108LSI Logic FC949E,
109LSI Logic FC949ES
110(Dual 4Gb/s
111.Tn Fibre Channel PCI-Express)
112.El
113.Pp
114The
115.Tn Ultra 320 SCSI
116controller chips supported by the
117.Nm
118driver can be found onboard on many systems including:
119.Pp
120.Bl -bullet -compact
121.It
122Dell PowerEdge 1750 through 2850
123.It
124IBM eServer xSeries 335
125.El
126.Pp
127These systems also contain Integrated RAID Mirroring and Integrated
128RAID Mirroring Enhanced which this driver also supports.
129.Pp
130The
131.Tn SAS
132controller chips are also present on many new AMD/Opteron based systems,
133like the Sun 4100.
134Note that this controller can drive both SAS and SATA
135drives or a mix of them at the same time.
136The Integrated RAID Mirroring
137available for these controllers is poorly supported at best.
138.Pp
139The
140.Tn Fibre Channel
141controller chipset are supported by a broad variety of speeds and systems.
142The
143.Tn Apple
144Fibre Channel HBA is in fact the
145.Tn FC949ES
146card.
147.Pp
148This driver also supports target mode for Fibre Channel cards.
149This support may be enabled by setting the desired role of the core via
150the LSI Logic firmware utility that establishes what roles the card
151can take on - no separate compilation is required.
152.Sh WARNINGS
153Most controllers supported by the
154.Nm
155driver suffer from limitations on supported disk size (mostly <2TB).
156While most controllers will truncate usable disk size, others might
157behave unexpectedly and can cause severe data loss.
158Refer to the datasheet of the chipset and firmware version for information
159about supported disk size and limitations.
160.Sh SEE ALSO
161.Xr cd 4 ,
162.Xr ch 4 ,
163.Xr da 4 ,
164.Xr mps 4 ,
165.Xr pci 4 ,
166.Xr sa 4 ,
167.Xr scsi 4 ,
168.Xr targ 4 ,
169.Xr gmultipath 8 ,
170.Xr mptutil 8
171.Rs
172.%T "LSI Logic Website"
173.%U http://www.lsi.com/
174.Re
175.Sh HISTORY
176The
177.Nm
178driver first appeared in
179.Fx 4.6 .
180.Sh AUTHORS
181.An -nosplit
182The
183.Nm
184driver was originally written for
185.Fx
186by
187.An Greg Ansley
188and marginally improved upon
189by
190.An Matt Jacob Aq Mt mjacob@FreeBSD.org .
191.Pp
192.An Justin Gibbs Aq Mt gibbs@FreeBSD.org
193and
194.An Scott Long Aq Mt scottl@FreeBSD.org
195have made more substantial improvements.
196