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