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