mpt(4): Use MSI on SAS adapters that support it.
[dragonfly.git] / share / man / man4 / mpt.4
CommitLineData
22897853 1.\" $NetBSD: mpt.4,v 1.1 2003/04/16 22:32:15 thorpej Exp $
9cca02b8 2.\"
22897853
HP
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.\"
4c42baf4 36.\" $FreeBSD: src/share/man/man4/mpt.4,v 1.22 2011/07/23 22:55:32 gjb Exp $
6d259fc1 37.\"
f0731c1e 38.Dd July 21, 2012
22897853
HP
39.Dt MPT 4
40.Os
41.Sh NAME
42.Nm mpt
43.Nd LSI Fusion-MPT SCSI/Fibre Channel driver
44.Sh SYNOPSIS
1435b4dc
SW
45To compile this driver into the kernel,
46place the following lines in your
47kernel configuration file:
48.Bd -ragged -offset indent
22897853 49.Cd "device scbus"
1435b4dc
SW
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
22897853
HP
59.Sh DESCRIPTION
60The
61.Nm
62driver provides support
63for the LSI Logic Fusion-MPT family of
1435b4dc 64.Tn SCSI ,
22897853 65.Tn Fibre Channel
1435b4dc
SW
66and
67.Tn SAS
68controllers.
f0731c1e
SW
69.Sh LOADER TUNABLES
70.Bl -tag -width indent
71.It Va hw.mpt.msi.enable
72This tunable specifies whether MSI will be used or not, provided the
73controller supports it.
74By default, the driver will use MSI for SAS adapters.
1435b4dc
SW
75.Sh HARDWARE
76The following controllers are supported by the
77.Nm
78driver:
22897853 79.Pp
1435b4dc
SW
80.Bl -bullet -compact
81.It
82LSI Logic 53c1030,
83LSI Logic LSI2x320-X
84(Single and Dual Ultra320
85.Tn SCSI )
22897853 86.It
1435b4dc
SW
87LSI Logic AS1064,
88LSI Logic AS1068
89.Pq Tn SAS/SATA
22897853 90.It
1435b4dc
SW
91LSI Logic FC909
92(1Gb/s
93.Tn Fibre Channel )
22897853 94.It
1435b4dc
SW
95LSI Logic FC909A
96(Dual 1Gb/s
97.Tn Fibre Channel )
22897853 98.It
1435b4dc
SW
99LSI Logic FC919,
100LSI Logic 7102XP-LC
101(Single 2Gb/s
102.Tn Fibre Channel )
22897853 103.It
1435b4dc
SW
104LSI Logic FC929,
105LSI Logic FC929X,
106LSI Logic 7202XP-LC
107(Dual 2Gb/s
108.Tn Fibre Channel )
109.It
110LSI Logic FC949X
111(Dual 4Gb/s
112.Tn Fibre Channel )
113.It
6d259fc1 114LSI Logic FC949E,
1435b4dc
SW
115LSI Logic FC949ES
116(Dual 4Gb/s
117.Tn Fibre Channel PCI-Express)
118.El
119.Pp
120The
121.Tn Ultra 320 SCSI
122controller chips supported by the
123.Nm
124driver can be found onboard on many systems including:
125.Pp
126.Bl -bullet -compact
127.It
128Dell PowerEdge 1750 thru 2850
129.It
130IBM eServer xSeries 335
22897853
HP
131.El
132.Pp
1435b4dc
SW
133These systems also contain Integrated Raid Mirroring and Integrated
134Raid Mirroring Enhanced which this driver also supports.
135.Pp
136The
137.Tn SAS
138controller chips are also present on many new AMD/Opteron based systems,
139like the Sun 4100.
140Note that this controller can drive both SAS and SATA
141drives or a mix of them at the same time.
142The Integrated Raid Mirroring
143available for these controllers is poorly supported at best.
144.Pp
145The
146.Tn Fibre Channel
147controller chipset are supported by a broad variety of speeds and systems.
148The
149.Tn Apple
150Fibre Channel HBA is in fact the
151.Tn FC949ES
152card.
153.Pp
154This driver also supports target mode for Fibre Channel cards.
155This support may be enabled by setting the desired role of the core via
156the LSI Logic firmware utility that establishes what roles the card
157can take on - no separate compilation is required.
22897853
HP
158.Sh SEE ALSO
159.Xr cd 4 ,
160.Xr ch 4 ,
1435b4dc 161.Xr da 4 ,
6d259fc1 162.\".Xr mps 4 ,
22897853 163.Xr pci 4 ,
1435b4dc 164.Xr sa 4 ,
6d259fc1
SW
165.Xr scsi 4 ,
166.Xr mptutil 8
22897853
HP
167.Rs
168.%T "LSI Logic Website"
4c42baf4 169.%O http://www.lsi.com/
22897853
HP
170.Re
171.Sh HISTORY
172The
173.Nm
174driver first appeared in
175.Fx 4.6 .
176.Sh AUTHORS
177.An -nosplit
178The
179.Nm
180driver was originally written for
181.Fx
182by
183.An Greg Ansley
1435b4dc 184and marginally improved upon
22897853
HP
185by
186.An Matt Jacob Aq mjacob@FreeBSD.org .
1435b4dc
SW
187.Pp
188.An Justin Gibbs Aq gibbs@FreeBSD.org
189and
190.An Scott Long Aq scottl@FreeBSD.org
191have made more substantial improvements.