[src/trunk]: src/share/man/man4 Update man page and add .Bl section.

[mjacob <mjacob%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/cf87aa7226a6
branches:  trunk
changeset: 479696:cf87aa7226a6
user:      mjacob <mjacob%NetBSD.org@localhost>
date:      Sat Dec 18 18:31:53 1999 +0000

description:
Update man page and add .Bl section.

diffstat:

 share/man/man4/isp.4 |  76 +++++++++++++++++++++++++++++++++++++++++----------
 1 files changed, 60 insertions(+), 16 deletions(-)

diffs (113 lines):

diff -r ae7b7789cbb2 -r cf87aa7226a6 share/man/man4/isp.4
--- a/share/man/man4/isp.4      Sat Dec 18 14:05:37 1999 +0000
+++ b/share/man/man4/isp.4      Sat Dec 18 18:31:53 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: isp.4,v 1.3 1999/03/26 00:47:03 mjacob Exp $
+.\"    $NetBSD: isp.4,v 1.4 1999/12/18 18:31:53 mjacob Exp $
 .\"
 .\" Copyright (c) 1998, 1999
 .\"    Matthew Jacob, for NASA/Ames Research Center
@@ -32,29 +32,26 @@
 .Os
 .Sh NAME
 .Nm isp
-.Nd Qlogic based SCSI or FibreChannel SCSI Host Adapters
+.Nd Qlogic based SCSI and FibreChannel SCSI Host Adapters
 .Sh SYNOPSIS
 .Cd "isp* at pci? dev? function?" Pq PCI
 .Cd "isp* at sbus? slot ? offset ?" Pq SBus
 .Cd scsibus* at isp?
 .Sh DESCRIPTION
-This driver provides access to a
-.Tn SCSI
-bus or a
-.Tn FibreChannel
-connected to
-.Tn Qlogic
-ISP1000 (SBus), ISP1020 (PCI), ISP1040(PCI), ISP1080(PCI),
+This driver provides access to
 .Tn SCSI
-host adapters or ISP2100(PCI)
+or
 .Tn FibreChannel
-host adapters.
+devices.
 .Pp
-Features include support for UltraSCSI and wide mode transactions for
+SCSI features include support for Ultra SCSI and wide mode transactions for
 .Tn SCSI ,
-and LVD (for the ISP1080),
-and the FCP SCSI profile for
+and LVD (for the ISP1080 and ISP1280),
+.Pp
+Fibre Channel support uses FCP SCSI profile for
 .Tn FibreChannel .
+and utilizes Class 3 connections only. Support is available for Public
+and Private loops.
 Command tagging is supported for all (in fact,
 .Tn FibreChannel
 requires tagging).
@@ -65,14 +62,61 @@
 .Tn isp*
 declarations will disable the download of driver f/w, which means you
 use whatever F/W is running on the card. If no firmware is running on the card,
-you will lose.
+the driver cannot operate the card.
+.Pp
+An optional
+.Tn flags 0x40
+appended to the above
+.Tn isp*
+declarations (can be OR'd in with the other config flags option)
+will keep the driver from looking at device or bus NVRAM settings (this
+is in case NVRAM is just wrong and you have the card in a platform where
+it is inconvenient to change NVRAM settings on the card).
+.Sh HARDWARE
+Supported cards include:
+.Pp
+.Bl -tag -width xxxxxx -offset indent
+.It ISP1000
+SBus Fast Wide, Ultra Fast Wide cards, Single Ended or Differential cards.
+.It PTI SBS440
+Perfomance Technology ISP1000 variants.
+.It ISP1020
+Qlogic 1020 Fast Wide and Differential Fast Wide PCI cards.
+.It ISP1040
+Qlogic 1040 Ultra Wide and Differential Ultra Wide PCI cards.
+.It PTI SBS450
+Perfomance Technology ISP1040 variants.
+.It Qlogic 1240
+Qlogic 1240 Dual Bus Ultra Wide and Differential Ultra Wide PCI cards.
+.It Qlogic 1080
+Qlogic 1280 Dual Bus LVD Ultra2 Wide PCI cards.
+.It Qlogic 2100
+Qlogic 2100 and 2100A Copper and Optical Fibre Channel Arbitrated Loop
+.It Qlogic 2102
+Qlogic Dual Loop 2100A Optical Fibre Channel Arbitrated Loop PCI cards.
+.It Qlogic 2200
+Qlogic 2200 Copper and Optical Fibre Channel Arbitrated Loop PCI cards.
+.It Qlogic 2202
+Qlogic 2200 Dual Bus Optical Fibre Channel Arbitrated Loop PCI cards.
+.It PTI SBS470
+Perfomance Technology ISP2100 variants.
+.It Antares P-0033
+Antares Microsystems ISP2100 variants.
+.El
 .Sh BUGS
 The driver currently ignores some NVRAM settings.
 .Pp
 The driver currently doesn't do error recovery for timed out commands
 very gracefully.
 .Pp
-Fabric Support (for FibreChannel) is not supported yet.
+Fabric (public loop) support isn't very well debugged yet.
+.Pp
+Sometimes, when booting, the driver gets stuck waiting for the Fibre Channel
+f/w to tell it that the loop port database is ready. In this case you'll
+see an announcement that the loop state has a value of 0x1. To unwedge
+the system, unplug and replug the fibre channel connection, or otherwise
+cause a LIP (Loop Initialization Primitive sequence)- this will kick the f/w
+into getting unstuck.
 .Sh SEE ALSO
 .Xr intro 4 ,
 .Xr cd 4 ,