share/man/man4/bt.4

   1 .\"
   2 .\" Copyright (c) 1994 Jordan Hubbard
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. The name of the author may not be used to endorse or promote products
  14 .\"    derived from this software without specific prior written permission
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  17 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  18 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  19 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  20 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  21 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  22 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  23 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  25 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .\" $FreeBSD$
  28 .\"
  29 .Dd June 18, 2006
  30 .Dt BT 4
  31 .Os
  32 .Sh NAME
  33 .Nm bt
  34 .Nd Buslogic/Mylex MultiMaster SCSI host adapter driver
  35 .Sh SYNOPSIS
  36 To compile this driver into the kernel,
  37 place the following lines in your
  38 kernel configuration file:
  39 .Bd -ragged -offset indent
  40 .Cd "device isa"
  41 .Cd "device scbus"
  42 .Cd "device bt"
  43 .Pp
  44 In
  45 .Pa /boot/device.hints :
  46 .Cd hint.bt.0.at="isa"
  47 .Cd hint.bt.0.port="0x330"
  48 .Ed
  49 .Sh DESCRIPTION
  50 This driver provides access to the
  51 .Tn SCSI
  52 bus connected to a Buslogic/Mylex MultiMaster or compatible controller:
  53 .Bd -ragged -offset indent
  54 .Bl -column "BT-956CD " "ISA " "Commands " Description
  55 MultiMaster "W" Series Host Adapters:
  56 .Pp
  57 .Em "Adapter   Bus   Commands  Description"
  58 BT-948    PCI     192     Ultra SCSI-3
  59 BT-958    PCI     192     Wide Ultra SCSI-3
  60 BT-958D   PCI     192     Wide Differential Ultra SCSI-3
  61 .El
  62 .Bl -column "BT-956CD " "ISA " "Commands " Description
  63 MultiMaster "C" Series Host Adapters:
  64 .Pp
  65 .Em "Adapter   Bus   Commands  Description"
  66 BT-946C   PCI     100     Fast SCSI-2
  67 BT-956C   PCI     100     Wide Fast SCSI-2
  68 BT-956CD  PCI     100     Wide Differential Fast SCSI-2
  69 BT-445C   VLB     100     Fast SCSI-2
  70 BT-747C   EISA    100     Fast SCSI-2
  71 BT-757C   EISA    100     Wide Fast SCSI-2
  72 BT-757CD  EISA    100     Wide Differential Fast SCSI-2
  73 BT-545C   ISA      50     Fast SCSI-2
  74 BT-540CF  ISA      50     Fast SCSI-2
  75 .El
  76 .Bl -column "BT-956CD " "ISA " "Commands " Description
  77 MultiMaster "S" Series Host Adapters:
  78 .Pp
  79 .Em "Adapter   Bus   Commands  Description"
  80 BT-445S   VLB      30     Fast SCSI-2
  81 BT-747S   EISA     30     Fast SCSI-2
  82 BT-747D   EISA     30     Differential Fast SCSI-2
  83 BT-757S   EISA     30     Wide Fast SCSI-2
  84 BT-757D   EISA     30     Wide Differential Fast SCSI-2
  85 BT-545S   ISA      30     Fast SCSI-2
  86 BT-542D   ISA      30     Differential Fast SCSI-2
  87 BT-742A   EISA     30     SCSI-2 (742A revision H)
  88 BT-542B   ISA      30     SCSI-2 (542B revision H)
  89 .El
  90 .Bl -column "BT-956CD " "ISA " "Commands " Description
  91 MultiMaster "A" Series Host Adapters:
  92 .Pp
  93 .Em "Adapter   Bus   Commands  Description"
  94 BT-742A   EISA     30     SCSI-2 (742A revisions A - G)
  95 BT-542B   ISA      30     SCSI-2 (542B revisions A - G)
  96 .El
  97 .Ed
  98 .Pp
  99 Tagged queueing is supported on 'W' series adapters, 'C' series adapters
 100 with firmware of rev 4.42 and higher, and 'S' series adapters with firmware
 101 of rev 3.35 and higher.
 102 .Pp
 103 Boards with certain firmware revisions may lock up under heavy load to
 104 certain devices, especially if tagged queueing is used.
 105 Should you encounter
 106 a problem with your adapter, contact Mylex technical support and ensure you
 107 have the latest firmware for your controller.
 108 .Sh HARDWARE
 109 The
 110 .Nm
 111 driver supports the following BusLogic MultiMaster
 112 .Dq W ,
 113 .Dq C ,
 114 .Dq S ,
 115 and
 116 .Dq A
 117 series and compatible SCSI host adapters:
 118 .Pp
 119 .Bl -bullet -compact
 120 .It
 121 BusLogic BT-445C
 122 .It
 123 BusLogic BT-445S
 124 .It
 125 BusLogic BT-540CF
 126 .It
 127 BusLogic BT-542B
 128 .It
 129 BusLogic BT-542B
 130 .It
 131 BusLogic BT-542D
 132 .It
 133 BusLogic BT-545C
 134 .It
 135 BusLogic BT-545S
 136 .It
 137 BusLogic/BusTek BT-640
 138 .It
 139 BusLogic BT-742A
 140 .It
 141 BusLogic BT-742A
 142 .It
 143 BusLogic BT-747C
 144 .It
 145 BusLogic BT-747D
 146 .It
 147 BusLogic BT-747S
 148 .It
 149 BusLogic BT-757C
 150 .It
 151 BusLogic BT-757CD
 152 .It
 153 BusLogic BT-757D
 154 .It
 155 BusLogic BT-757S
 156 .It
 157 BusLogic BT-946C
 158 .It
 159 BusLogic BT-948
 160 .It
 161 BusLogic BT-956C
 162 .It
 163 BusLogic BT-956CD
 164 .It
 165 BusLogic BT-958
 166 .It
 167 BusLogic BT-958D
 168 .It
 169 Storage Dimensions SDC3211B / SDC3211F
 170 .El
 171 .Pp
 172 AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones
 173 are also supported by the
 174 .Nm
 175 driver.
 176 .Sh SEE ALSO
 177 .Xr cd 4 ,
 178 .Xr da 4 ,
 179 .Xr sa 4 ,
 180 .Xr scsi 4
 181 .Sh HISTORY
 182 The
 183 .Nm
 184 driver first appeared in the
 185 .Bx 386
 186 patch kit.
 187 .Sh AUTHORS
 188 .An -nosplit
 189 .An Julian Elischer
 190 wrote a driver for the Multimaster cards that appeared in the
 191 .Bx 386
 192 patch kit.
 193 The driver was rewritten by
 194 .An Justin T. Gibbs
 195 to take advantage of new board features and work with the CAM SCSI framework in
 196 .Fx 3.0 .
 197 .Pp
 198 Special thanks to
 199 .An Leonard N. Zubkoff
 200 for writing such a complete and well documented Mylex/BusLogic MultiMaster
 201 driver for Linux.
 202 Support in this driver for the wide range of MultiMaster
 203 controllers and firmware revisions, with their otherwise undocumented quirks,
 204 would not have been possible without his efforts.