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