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: src/share/man/man4/bt.4,v 1.10.4.6 2001/10/01 13:07:23 dd Exp $
  28 .\" $DragonFly: src/share/man/man4/bt.4,v 1.5 2008/05/02 02:05:05 swildner Exp $
  29 .\"
  30 .Dd October 16, 1998
  31 .Dt BT 4
  32 .Os
  33 .Sh NAME
  34 .Nm bt
  35 .Nd Buslogic/Mylex MultiMaster SCSI host adapter driver
  36 .Sh SYNOPSIS
  37 .Cd "device bt0 at isa? port ? irq ?"
  38 .Cd device scbus0 at bt0
  39 .Sh DESCRIPTION
  40 This driver provides access to the
  41 .Tn SCSI
  42 bus connected to a Buslogic/Mylex MultiMaster or compatible controller:
  43 .Bd -ragged -offset indent
  44 .Bl -column "BT-956CD " "ISA " "Commands " Description
  45 MultiMaster "W" Series Host Adapters:
  46 .Pp
  47 .Em "Adapter   Bus   Commands  Description"
  48 BT-948    PCI     192     ULtra SCSI-3
  49 BT-958    PCI     192     Wide ULtra SCSI-3
  50 BT-958D   PCI     192     Wide Differential ULtra SCSI-3
  51 .El
  52 .Bl -column "BT-956CD " "ISA " "Commands " Description
  53 MultiMaster "C" Series Host Adapters:
  54 .Pp
  55 .Em "Adapter   Bus   Commands  Description"
  56 BT-946C   PCI     100     Fast SCSI-2
  57 BT-956C   PCI     100     Wide Fast SCSI-2
  58 BT-956CD  PCI     100     Wide Differential Fast SCSI-2
  59 BT-445C   VLB     100     Fast SCSI-2
  60 BT-747C   EISA    100     Fast SCSI-2
  61 BT-757C   EISA    100     Wide Fast SCSI-2
  62 BT-757CD  EISA    100     Wide Differential Fast SCSI-2
  63 BT-545C   ISA      50     Fast SCSI-2
  64 BT-540CF  ISA      50     Fast SCSI-2
  65 .El
  66 .Bl -column "BT-956CD " "ISA " "Commands " Description
  67 MultiMaster "S" Series Host Adapters:
  68 .Pp
  69 .Em "Adapter   Bus   Commands  Description"
  70 BT-445S   VLB      30     Fast SCSI-2
  71 BT-747S   EISA     30     Fast SCSI-2
  72 BT-747D   EISA     30     Differential Fast SCSI-2
  73 BT-757S   EISA     30     Wide Fast SCSI-2
  74 BT-757D   EISA     30     Wide Differential Fast SCSI-2
  75 BT-545S   ISA      30     Fast SCSI-2
  76 BT-542D   ISA      30     Differential Fast SCSI-2
  77 BT-742A   EISA     30     SCSI-2 (742A revision H)
  78 BT-542B   ISA      30     SCSI-2 (542B revision H)
  79 .El
  80 .Bl -column "BT-956CD " "ISA " "Commands " Description
  81 MultiMaster "A" Series Host Adapters:
  82 .Pp
  83 .Em "Adapter   Bus   Commands  Description"
  84 BT-742A   EISA     30     SCSI-2 (742A revisions A - G)
  85 BT-542B   ISA      30     SCSI-2 (542B revisions A - G)
  86 .El
  87 .Ed
  88 .Pp
  89 AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones are also
  90 supported by this driver.
  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.  Should you encounter
  98 a problem with your adapter, contact Mylex technical support and ensure you
  99 have the latest firmware for your controller.
 100 .Sh FILES
 101 .Bl -tag -width /usr/share/man0/template.doc -compact
 102 .It Pa /sys/dev/disk/buslogic/bt.c
 103 Core Driver Implementation
 104 .It Pa /sys/dev/disk/buslogic/btreg.h
 105 MultiMaster Register Set and Core Driver Data Structures
 106 .It Pa /sys/dev/disk/buslogic/bt_pci.c
 107 PCI Bus Driver Attachment
 108 .It Pa /sys/dev/disk/buslogic/bt_eisa.c
 109 EISA Bus Driver Attachment
 110 .It Pa /sys/dev/disk/buslogic/bt_isa.c
 111 ISA/VL Bus Driver Attachment
 112 .El
 113 .Sh SEE ALSO
 114 .Xr cd 4 ,
 115 .Xr da 4 ,
 116 .Xr sa 4 ,
 117 .Xr scsi 4
 118 .Sh HISTORY
 119 The
 120 .Nm
 121 driver first appeared in the
 122 .Bx 386
 123 patch kit.
 124 .Sh AUTHORS
 125 .An -nosplit
 126 .An Julian Elischer
 127 wrote a driver for the Multimaster cards that appeared in the
 128 .Bx 386
 129 patch kit.  The driver was rewritten by
 130 .An Justin T. Gibbs
 131 to take advantage of new board features and work with the CAM SCSI framework in
 132 .Fx 3.0 .
 133 .Pp
 134 Special thanks to
 135 .An Leonard N. Zubkoff
 136 for writing such a complete and well documented Mylex/BusLogic MultiMaster
 137 driver for Linux.  Support in this driver for the wide range of MultiMaster
 138 controllers and firmware revisions, with their otherwise undocumented quirks,
 139 would not have been possible without his efforts.