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: src/share/man/man4/mpt.4,v 1.22 2011/07/23 22:55:32 gjb Exp $
  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
 138 .Tn SAS
 139 controller chips are also present on many new AMD/Opteron based systems,
 140 like the Sun 4100.
 141 Note that this controller can drive both SAS and SATA
 142 drives or a mix of them at the same time.
 143 The Integrated Raid Mirroring
 144 available for these controllers is poorly supported at best.
 145 .Pp
 146 The
 147 .Tn Fibre Channel
 148 controller chipset are supported by a broad variety of speeds and systems.
 149 The
 150 .Tn Apple
 151 Fibre Channel HBA is in fact the
 152 .Tn FC949ES
 153 card.
 154 .Pp
 155 This driver also supports target mode for Fibre Channel cards.
 156 This support may be enabled by setting the desired role of the core via
 157 the LSI Logic firmware utility that establishes what roles the card
 158 can take on - no separate compilation is required.
 159 .Sh SEE ALSO
 160 .Xr cd 4 ,
 161 .Xr ch 4 ,
 162 .Xr da 4 ,
 163 .\".Xr mps 4 ,
 164 .Xr pci 4 ,
 165 .Xr sa 4 ,
 166 .Xr scsi 4 ,
 167 .Xr mptutil 8
 168 .Rs
 169 .%T "LSI Logic Website"
 170 .%O http://www.lsi.com/
 171 .Re
 172 .Sh HISTORY
 173 The
 174 .Nm
 175 driver first appeared in
 176 .Fx 4.6 .
 177 .Sh AUTHORS
 178 .An -nosplit
 179 The
 180 .Nm
 181 driver was originally written for
 182 .Fx
 183 by
 184 .An Greg Ansley
 185 and marginally improved upon
 186 by
 187 .An Matt Jacob Aq mjacob@FreeBSD.org .
 188 .Pp
 189 .An Justin Gibbs Aq gibbs@FreeBSD.org
 190 and
 191 .An Scott Long Aq scottl@FreeBSD.org
 192 have made more substantial improvements.