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