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 .\"
  29 .Dd November 29, 2012
  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 scbus"
  41 .Cd "device bt"
  42 .Ed
  43 .Sh DESCRIPTION
  44 This driver provides access to the
  45 .Tn SCSI
  46 bus connected to a Buslogic/Mylex MultiMaster or compatible controller:
  47 .Bd -ragged -offset indent
  48 MultiMaster "W" Series Host Adapters:
  49 .Bl -column "BT-956CD " "PCI " "Commands " "Description"
  50 .Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
  51 BT-948  PCI     192     Ultra SCSI-3
  52 BT-958  PCI     192     Wide Ultra SCSI-3
  53 BT-958D PCI     192     Wide Differential Ultra SCSI-3
  54 .El
  55 .Pp
  56 MultiMaster "C" Series Host Adapters:
  57 .Bl -column "BT-956CD " "PCI " "Commands " "Description"
  58 .Em "Adapter" Ta Em "Bus" Ta Em "Commands" Ta Em "Description"
  59 BT-946C PCI     100     Fast SCSI-2
  60 BT-956C PCI     100     Wide Fast SCSI-2
  61 BT-956CD        PCI     100     Wide Differential Fast SCSI-2
  62 .El
  63 .Ed
  64 .Pp
  65 AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones are also
  66 supported by this driver.
  67 .Pp
  68 Tagged queueing is supported on 'W' series adapters and 'C' series adapters
  69 with firmware of rev 4.42 and higher.
  70 .Pp
  71 Boards with certain firmware revisions may lock up under heavy load to
  72 certain devices, especially if tagged queueing is used.
  73 Should you encounter
  74 a problem with your adapter, contact Mylex technical support and ensure you
  75 have the latest firmware for your controller.
  76 .Sh FILES
  77 .Bl -tag -width /usr/share/man0/template.doc -compact
  78 .It Pa /sys/dev/disk/buslogic/bt.c
  79 Core Driver Implementation
  80 .It Pa /sys/dev/disk/buslogic/btreg.h
  81 MultiMaster Register Set and Core Driver Data Structures
  82 .It Pa /sys/dev/disk/buslogic/bt_pci.c
  83 PCI Bus Driver Attachment
  84 .El
  85 .Sh SEE ALSO
  86 .Xr cd 4 ,
  87 .Xr da 4 ,
  88 .Xr sa 4 ,
  89 .Xr scsi 4
  90 .Sh HISTORY
  91 The
  92 .Nm
  93 driver first appeared in the
  94 .Bx 386
  95 patch kit.
  96 .Sh AUTHORS
  97 .An -nosplit
  98 .An Julian Elischer
  99 wrote a driver for the Multimaster cards that appeared in the
 100 .Bx 386
 101 patch kit.
 102 The driver was rewritten by
 103 .An Justin T. Gibbs
 104 to take advantage of new board features and work with the CAM SCSI framework in
 105 .Fx 3.0 .
 106 .Pp
 107 Special thanks to
 108 .An Leonard N. Zubkoff
 109 for writing such a complete and well documented Mylex/BusLogic MultiMaster
 110 driver for Linux.
 111 Support in this driver for the wide range of MultiMaster
 112 controllers and firmware revisions, with their otherwise undocumented quirks,
 113 would not have been possible without his efforts.