Update the bt(4) man page for CAM.

Reviewed by:	ken
Submitted by:	gibbs

1 files changed, 92 insertions, 24 deletions

diff --git a/share/man/man4/bt.4 b/share/man/man4/bt.4
index 39cb891..a575695 100644
--- a/share/man/man4/bt.4
+++ b/share/man/man4/bt.4
@@ -24,44 +24,112 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\"	$Id: bt.4,v 1.4 1997/03/07 02:49:45 jmg Exp $
+.\"	$Id: bt.4,v 1.5 1998/03/12 07:30:30 charnier Exp $
 .\"
-.Dd August 31, 1994
+.Dd October 16, 1998
 .Dt BT 4 i386
 .Os FreeBSD
 .Sh NAME
 .Nm bt
-.Nd Buslogic SCSI host adapter driver
+.Nd Buslogic/Mylex MultiMaster SCSI host adapter driver
 .Sh SYNOPSIS
-.Cd "controller bt0 at isa? port IO_BT0 bio irq ? vector btintr"
+.Cd "controller bt0 at isa? port ? cam irq ?"
 .Cd controller scbus0 at bt0
 .Sh DESCRIPTION
 This driver provides access to the
 .Tn SCSI
-bus connected to a Buslogic 
-545, 445, 742, 747 or 946 host adapter. 
-.\"
-.\" .Sh DIAGNOSTICS
-.\"
+bus connected to a Buslogic/Mylex MultiMaster or compatible controller:
+.Pp
+.Bd -filled -offset indent
+.Bl -column "BT-956CD " "ISA " "Commands " Description
+MultiMaster "W" Series Host Adapters:
+.Pp
+.Em "Adapter   Bus   Commands  Description"
+BT-948    PCI     192     ULtra SCSI-3
+BT-958    PCI     192     Wide ULtra SCSI-3
+BT-958D   PCI     192     Wide Differential ULtra SCSI-3
+.El
+.Bl -column "BT-956CD " "ISA " "Commands " Description
+MultiMaster "C" Series Host Adapters:
+.Pp
+.Em "Adapter   Bus   Commands  Description"
+BT-946C   PCI     100     Fast SCSI-2
+BT-956C   PCI     100     Wide Fast SCSI-2
+BT-956CD  PCI     100     Wide Differential Fast SCSI-2
+BT-445C   VLB     100     Fast SCSI-2
+BT-747C   EISA    100     Fast SCSI-2
+BT-757C   EISA    100     Wide Fast SCSI-2
+BT-757CD  EISA    100     Wide Differential Fast SCSI-2
+BT-545C   ISA      50     Fast SCSI-2
+BT-540CF  ISA      50     Fast SCSI-2
+.El
+.Bl -column "BT-956CD " "ISA " "Commands " Description
+MultiMaster "S" Series Host Adapters:
+.Pp
+.Em "Adapter   Bus   Commands  Description"
+BT-445S   VLB      30     Fast SCSI-2
+BT-747S   EISA     30     Fast SCSI-2
+BT-747D   EISA     30     Differential Fast SCSI-2
+BT-757S   EISA     30     Wide Fast SCSI-2
+BT-757D   EISA     30     Wide Differential Fast SCSI-2
+BT-545S   ISA      30     Fast SCSI-2
+BT-542D   ISA      30     Differential Fast SCSI-2
+BT-742A   EISA     30     SCSI-2 (742A revision H)
+BT-542B   ISA      30     SCSI-2 (542B revision H)
+.El
+.Bl -column "BT-956CD " "ISA " "Commands " Description
+MultiMaster "A" Series Host Adapters:
+.Pp
+.Em "Adapter   Bus   Commands  Description"
+BT-742A   EISA     30     SCSI-2 (742A revisions A - G)
+BT-542B   ISA      30     SCSI-2 (542B revisions A - G)
+.El
+.Ed
+.Pp
+AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones are also
+supported by this driver.
+.Pp
+Tagged queueing is supported on 'W' series adapters, 'C' series adapters
+with firmware of rev 4.42 and higher, and 'S' series adapters with firmware
+of rev 3.35 and higher.
+.Pp
+Boards with certain firmware revisions may lock up under heavy load to
+certain devices, especially if tagged queueing is used.  Should you encounter
+a problem with your adapter, contact Mylex technical support and ensure you
+have the latest firmware for your controller.
 .Sh SEE ALSO
 .Xr cd 4 ,
 .Xr scsi 4 ,
-.Xr sd 4 ,
-.Xr st 4
+.Xr da 4 ,
+.Xr sa 4
 .Sh AUTHORS
-The
-.Nm
-driver was written by
 .An Julian Elischer
-for use with
-.Tn Mach
-2.5.  The interface for the
-.Tn PCI
-and
-.Tn EISA
-busses was written by
-.An Justin Gibbs .
+wrote a driver for the Multimaster cards that appeared in the 386BSD
+patch kit.  The driver was rewritten by
+.An Justin T. Gibbs
+to take advantage of new board features and work with the CAM SCSI framework
+in FreeBSD 3.0R.
+.Pp
+Special thanks to Leonard N. Zubkoff
+for writing such a complete and well documented Mylex/BusLogic MultiMaster
+driver for Linux.  Support in this driver for the wide range of MultiMaster
+controllers and firmware revisions, with their otherwise undocumented quirks,
+would not have been possible without his efforts.  
+.Sh FILES
+.Bl -tag -width /usr/share/man0/template.doc -compact
+.It Pa sys/dev/buslogic/bt.c
+Core Driver Implementation
+.It Pa sys/dev/buslogic/btreg.h
+MultiMaster Register Set and Core Driver Data Structures
+.It Pa sys/pci/bt_pci.c
+PCI Bus Driver Attachment
+.It Pa sys/i386/eisa/bt_eisa.c
+EISA Bus Driver Attachment
+.It Pa sys/i386/isa/bt_isa.c
+ISA/VL Bus Driver Attachment
+.El
 .Sh HISTORY
-We're not sure when the
+The
 .Nm
-driver first appeared.
+driver first appeared in the 386BSD patch kit.
+