diff options
author | mjacob <mjacob@FreeBSD.org> | 2000-02-14 23:47:55 +0000 |
---|---|---|
committer | mjacob <mjacob@FreeBSD.org> | 2000-02-14 23:47:55 +0000 |
commit | c26147aee01ef78226f19f04890243bf11c9cd60 (patch) | |
tree | 844215e732876c92e1cf36ec55a33a798939dc70 /share/man/man4 | |
parent | 4a9fcd0c1f1a775e1a7b042812dc72cb3c9162e8 (diff) | |
download | FreeBSD-src-c26147aee01ef78226f19f04890243bf11c9cd60.zip FreeBSD-src-c26147aee01ef78226f19f04890243bf11c9cd60.tar.gz |
Add (finally) Qlogic man page.
approved: jkh
Diffstat (limited to 'share/man/man4')
-rw-r--r-- | share/man/man4/isp.4 | 208 |
1 files changed, 208 insertions, 0 deletions
diff --git a/share/man/man4/isp.4 b/share/man/man4/isp.4 new file mode 100644 index 0000000..a5e1bd9 --- /dev/null +++ b/share/man/man4/isp.4 @@ -0,0 +1,208 @@ +.\" $FreeBSD$ +.\" $NetBSD: isp.4,v 1.5 1999/12/18 18:33:05 mjacob Exp $ +.\" +.\" Copyright (c) 1998, 1999 +.\" Matthew Jacob, for NASA/Ames Research Center +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software withough specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" +.Dd Feburary 14, 2000 +.Dt ISP 4 +.Os +.Sh NAME +.Nm isp +.Nd Qlogic based SCSI and FibreChannel SCSI Host Adapters +.Sh SYNOPSIS +.Cd "device isp" +.Pp +For one or more SCSI busses: +.Cd device scbus0 +.Sh DESCRIPTION +This driver provides access to +.Tn SCSI +or +.Tn FibreChannel +devices. +.Pp +SCSI features include support for Ultra SCSI and wide mode transactions for +.Tn SCSI , +Ultra2 LVD (for the ISP1080 and ISP1280), and Ultra3 LVD (for the ISP12160). +.Pp +Fibre Channel support uses FCP SCSI profile for +.Tn FibreChannel . +and utilizes Class 3 and Class 2 connections (Qlogic 2100 is Class 3 +only, minor patches to the Qlogic 2200 to force Class 2 mode). +Support is available for Public +and Private loops, and for point-to-point connections (Qlogic 2200 +only). +Command tagging is supported for all (in fact, +.Tn FibreChannel +requires tagging). +.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 LVD Ultra2 Wide PCI cards. +.It Qlogic 1280 +Qlogic 1280 Dual Bus LVD Ultra2 Wide PCI cards. +.It Qlogic 12160 +Qlogic 12160 Dual Bus LVD Ultra3 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 CONFIGURATION OPTIONS +.Pp +General configuration options for all adapters include: +.sp +.Cd options SCSI_ISP_NO_FWLOAD_MASK +.Cd options SCSI_ISP_NO_NVRAM_MASK +.Cd options SCSI_ISP_PREFER_MEM_MAP +.sp +for which the option value is a bit mask of units for which you want this +option to apply. The options are, respectively, for not loading new firmware +at startup, ignoring card NVRAM settings, and preferring memory mapped +versus I/O port PCI access methods. +.Pp +Poorly debugged and prototype target mode support may be enabled with the +.sp +.Cd options ISP_TARGET_MODE +.sp +option. +.Pp +Configuration options that define whether downloadable firmware should be +compiled into the driver are: +.sp +.Cd options ISP_COMPILE_1020_FW +.Cd options ISP_COMPILE_1080_FW +.Cd options ISP_COMPILE_12160_FW +.Cd options ISP_COMPILE_2100_FW +.Cd options ISP_COMPILE_FW +.sp +The above options either select which board's f/w you wish to compile in, +or for the last, to select all. +.Pp +Configuration options specific to Fibre Channel Cards are: +.sp +.Cd options SCSI_ISP_FCDUPLEX +.Cd options SCSI_ISP_FABRIC +.Cd options SCSI_ISP_SCCLUN +.Cd options SCSI_ISP_WWN +.sp +The first option is a bit mask of units for which you want to enable full +duplex mode. This typically would only make sense if fabric support is +enabled and you are directly connected to a switch. +The second defines whether Fibre Channel Fabric support should be enabled. +The third defines whether whether the first level SCC lun support should +be enabled- this converts the normal 16 Logical Unit support to support for +65536 Logical Units. The last option should be a string that defines an +overriding World Wide Node Name (WWNN) should you wish to override NVRAM +settings. It is recommended that you compile in firmware if you select +any of these options. +.Sh BOOT OPTIONS +.Pp +Many of the above options are switchable by setting values in the loader +configuration file (see the +.Xr loader 8 +manual page). They are: +.sp +.Bl -tag -width "isp_no_fwload" -compact +.It isp_disable +A bit mask of units to skip configuration for. +.It isp_mem_map +A bit mask of units to use PCI Memory space instead of I/O +space access for. +.It isp_io_map +A bit mask of units to use PCI I/O space instead of Memory +space access for. +.It isp_no_fwload +A bit mask of units that you wish to skip firmware download for. +.It isp_fwload +A bit mask of units that you wish to *do* firmware download for. +.It isp_no_nvram +A bit mask of units that you wish to ignore board NVRAM settings for. +.It isp_nvram +A bit mask of units that you wish to specifically use board NVRAM settings for. +.It isp_fcduplex +A bit mask of units that you wish to specifically to set into full +duplex mode. +.It isp_no_fcduplex +A bit mask of units that you wish to specifically to not set into full +duplex mode. +.It isp_wwn +This should be the full 64 bit World Wide Node Name you would like to +use, overriding the value in NVRAM for the card. +.It isp_debug +This is a driver debug level- meaningful from 0 through 7. +.It isp_tdebug +This is a driver target mode debug level- meaningful from 0 through 5. +.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 isn't very well debugged yet, and with some switches, +fails to work as well as it should because the driver uses the GET ALL NEXT +Simple Name Server subcommand which some switches don't handle as well +as they should. +.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 scsi 4 , +.Xr da 4 , +.Xr sa 4 +.Sh AUTHOR +The +.Nm +driver was written by Matthew Jacob for NASA/Ames Research Center. |