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