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 MultiMaster "W" Series Host Adapters:
  55 .Bl -column "BT-956CD " "ISA " "Commands " "Description"
  56 .Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
  57 BT-948  PCI     192     Ultra SCSI-3
  58 BT-958  PCI     192     Wide Ultra SCSI-3
  59 BT-958D PCI     192     Wide Differential Ultra SCSI-3
  60 .El
  61 .Pp
  62 MultiMaster "C" Series Host Adapters:
  63 .Bl -column "BT-956CD " "ISA " "Commands " "Description"
  64 .Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
  65 BT-946C PCI     100     Fast SCSI-2
  66 BT-956C PCI     100     Wide Fast SCSI-2
  67 BT-956CD        PCI     100     Wide Differential Fast SCSI-2
  68 BT-445C VLB     100     Fast SCSI-2
  69 BT-747C EISA    100     Fast SCSI-2
  70 BT-757C EISA    100     Wide Fast SCSI-2
  71 BT-757CD        EISA    100     Wide Differential Fast SCSI-2
  72 BT-545C ISA     50      Fast SCSI-2
  73 BT-540CF        ISA     50      Fast SCSI-2
  74 .El
  75 .Pp
  76 MultiMaster "S" Series Host Adapters:
  77 .Bl -column "BT-956CD " "ISA " "Commands " "Description"
  78 .Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
  79 BT-445S VLB     30      Fast SCSI-2
  80 BT-747S EISA    30      Fast SCSI-2
  81 BT-747D EISA    30      Differential Fast SCSI-2
  82 BT-757S EISA    30      Wide Fast SCSI-2
  83 BT-757D EISA    30      Wide Differential Fast SCSI-2
  84 BT-545S ISA     30      Fast SCSI-2
  85 BT-542D ISA     30      Differential Fast SCSI-2
  86 BT-742A EISA    30      SCSI-2 (742A revision H)
  87 BT-542B ISA     30      SCSI-2 (542B revision H)
  88 .El
  89 .Pp
  90 MultiMaster "A" Series Host Adapters:
  91 .Bl -column "BT-956CD " "ISA " "Commands " "Description"
  92 .Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
  93 BT-742A EISA    30      SCSI-2 (742A revisions A - G)
  94 BT-542B ISA     30      SCSI-2 (542B revisions A - G)
  95 .El
  96 .Ed
  97 .Pp
  98 Tagged queueing is supported on 'W' series adapters, 'C' series adapters
  99 with firmware of rev 4.42 and higher, and 'S' series adapters with firmware
 100 of rev 3.35 and higher.
 101 .Pp
 102 Boards with certain firmware revisions may lock up under heavy load to
 103 certain devices, especially if tagged queueing is used.
 104 Should you encounter
 105 a problem with your adapter, contact Mylex technical support and ensure you
 106 have the latest firmware for your controller.
 107 .Sh HARDWARE
 108 The
 109 .Nm
 110 driver supports the following BusLogic MultiMaster
 111 .Dq W ,
 112 .Dq C ,
 113 .Dq S ,
 114 and
 115 .Dq A
 116 series and compatible SCSI host adapters:
 117 .Pp
 118 .Bl -bullet -compact
 119 .It
 120 BusLogic BT-445C
 121 .It
 122 BusLogic BT-445S
 123 .It
 124 BusLogic BT-540CF
 125 .It
 126 BusLogic BT-542B
 127 .It
 128 BusLogic BT-542B
 129 .It
 130 BusLogic BT-542D
 131 .It
 132 BusLogic BT-545C
 133 .It
 134 BusLogic BT-545S
 135 .It
 136 BusLogic/BusTek BT-640
 137 .It
 138 BusLogic BT-742A
 139 .It
 140 BusLogic BT-742A
 141 .It
 142 BusLogic BT-747C
 143 .It
 144 BusLogic BT-747D
 145 .It
 146 BusLogic BT-747S
 147 .It
 148 BusLogic BT-757C
 149 .It
 150 BusLogic BT-757CD
 151 .It
 152 BusLogic BT-757D
 153 .It
 154 BusLogic BT-757S
 155 .It
 156 BusLogic BT-946C
 157 .It
 158 BusLogic BT-948
 159 .It
 160 BusLogic BT-956C
 161 .It
 162 BusLogic BT-956CD
 163 .It
 164 BusLogic BT-958
 165 .It
 166 BusLogic BT-958D
 167 .It
 168 Storage Dimensions SDC3211B / SDC3211F
 169 .El
 170 .Pp
 171 AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones
 172 are also supported by the
 173 .Nm
 174 driver.
 175 .Sh SEE ALSO
 176 .Xr cd 4 ,
 177 .Xr da 4 ,
 178 .Xr sa 4 ,
 179 .Xr scsi 4
 180 .Sh HISTORY
 181 The
 182 .Nm
 183 driver first appeared in the
 184 .Bx 386
 185 patch kit.
 186 .Sh AUTHORS
 187 .An -nosplit
 188 .An Julian Elischer
 189 wrote a driver for the Multimaster cards that appeared in the
 190 .Bx 386
 191 patch kit.
 192 The driver was rewritten by
 193 .An Justin T. Gibbs
 194 to take advantage of new board features and work with the CAM SCSI framework in
 195 .Fx 3.0 .
 196 .Pp
 197 Special thanks to
 198 .An Leonard N. Zubkoff
 199 for writing such a complete and well documented Mylex/BusLogic MultiMaster
 200 driver for Linux.
 201 Support in this driver for the wide range of MultiMaster
 202 controllers and firmware revisions, with their otherwise undocumented quirks,
 203 would not have been possible without his efforts.