242 lines
7.7 KiB
Groff
242 lines
7.7 KiB
Groff
.\" $NetBSD: isp.4,v 1.5 1999/12/18 18:33:05 mjacob Exp $
|
|
.\"
|
|
.\" Copyright (c) 1998, 1999, 2001
|
|
.\" 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 without 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.
|
|
.\"
|
|
.\" Additional Copyright (c) 2006 by Marcus Alves Grando
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd February 28, 2007
|
|
.Dt ISP 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm isp
|
|
.Nd Qlogic based SCSI and FibreChannel SCSI Host Adapters
|
|
.Sh SYNOPSIS
|
|
To compile this driver into the kernel,
|
|
place the following lines in your
|
|
kernel configuration file:
|
|
.Bd -ragged -offset indent
|
|
.Cd "device scbus"
|
|
.Cd "device isp"
|
|
.Ed
|
|
.Pp
|
|
Alternatively, to load the driver as a
|
|
module at boot time, place the following line in
|
|
.Xr loader.conf 5 :
|
|
.Bd -literal -offset indent
|
|
isp_load="YES"
|
|
.Ed
|
|
.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).
|
|
The newer 2-Gigabit cards (2300, 2312, 2322) and 4-Gigabit (2422, 2432)
|
|
are also supported.
|
|
Command tagging is
|
|
supported for all (in fact,
|
|
.Tn FibreChannel
|
|
requires tagging).
|
|
Fabric support is enabled by default for other than 2100 cards.
|
|
Fabric
|
|
support for 2100 cards has been so problematic and these cards are so
|
|
old now that it is just not worth your time to try it.
|
|
.Sh FIRMWARE
|
|
Firmware is available if the
|
|
.Xr ispfw 4
|
|
module is loaded during bootstrap (q.v.).
|
|
.Pp
|
|
It is
|
|
.Ar strongly
|
|
recommended that you use the firmware available
|
|
from
|
|
.Xr ispfw 4
|
|
as it is the most likely to have been tested with this driver.
|
|
.Sh HARDWARE
|
|
Cards supported by the
|
|
.Nm
|
|
driver include:
|
|
.Pp
|
|
.Bl -tag -width xxxxxx -offset indent
|
|
.It ISP1000
|
|
SBus Fast Wide, Ultra Fast Wide cards, Single Ended or Differential
|
|
cards.
|
|
.It ISP1020
|
|
Qlogic 1020 Fast Wide and Differential Fast Wide PCI cards.
|
|
.It ISP1040
|
|
Qlogic 1040 Ultra Wide and Differential Ultra Wide PCI cards.
|
|
Also known as the DEC KZPBA-CA (single ended) and KZPBA-CB (HVD differential).
|
|
.It Qlogic 1240
|
|
Qlogic 1240 Dual Bus Ultra Wide and Differential Ultra Wide PCI
|
|
cards.
|
|
.It Qlogic 1020
|
|
Qlogic 1020 SCSI cards.
|
|
.It Qlogic 1040
|
|
Qlogic 1040 Ultra SCSI 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 210X
|
|
Qlogic 2100 and 2100A Copper and Optical Fibre Channel Arbitrated
|
|
Loop (single, dual).
|
|
.It Qlogic 220X
|
|
Qlogic 2200 Copper and Optical Fibre Channel Arbitrated Loop PCI
|
|
cards (single, dual, quad).
|
|
.It Qlogic 2300
|
|
Qlogic 2300 Optical Fibre Channel PCI cards.
|
|
.It Qlogic 2312
|
|
Qlogic 2312 Optical Fibre Channel PCI cards.
|
|
.It Qlogic 234X
|
|
Qlogic 234X Optical Fibre Channel PCI cards (2312 chipset, single and dual attach).
|
|
.It Qlogic 2322
|
|
Qlogic 2322 Optical Fibre Channel PCIe cards.
|
|
.It Qlogic 200
|
|
Dell Branded version of the QLogic 2312 Fibre Channel PCI cards.
|
|
.It Qlogic 2422
|
|
Qlogic 2422 Optical Fibre Channel PCI cards (4 Gigabit)
|
|
.It Qlogic 2432
|
|
Qlogic 2432 Optical Fibre Channel PCIe cards (4 Gigabit)
|
|
.El
|
|
.Sh CONFIGURATION OPTIONS
|
|
.Pp
|
|
Target mode support may be enabled with the
|
|
.Pp
|
|
.Cd options ISP_TARGET_MODE
|
|
.Pp
|
|
option.
|
|
.Sh BOOT OPTIONS
|
|
The following options are switchable by setting values in
|
|
.Pa /boot/device.hints .
|
|
.Pp
|
|
They are:
|
|
.Bl -tag -width indent
|
|
.It Va hint.isp.0.disable
|
|
A hint value to disable driver in kernel.
|
|
.It Va hint.isp.0.fwload_disable
|
|
A hint value to disable loading of firmware
|
|
.Xr ispfw 4 .
|
|
.It Va hint.isp.0.prefer_memmap
|
|
A hint value to use PCI memory space instead of I/O space
|
|
access for.
|
|
.It Va hint.isp.0.prefer_iomap
|
|
A hint value to use PCI I/O space instead of Memory space
|
|
access for.
|
|
.It Va hint.isp.0.ignore_nvram
|
|
A hint value to ignore board NVRAM settings for.
|
|
Otherwise use NVRAM settings.
|
|
.It Va hint.isp.0.fullduplex
|
|
A hint value to set full duplex mode.
|
|
.It Va hint.isp.0.topology
|
|
A hint value to select topology of connection.
|
|
Supported values are:
|
|
.Pp
|
|
.Bl -tag -width ".Li lport-only" -compact
|
|
.It Li lport
|
|
Prefer loopback and fallback to point to point.
|
|
.It Li nport
|
|
Prefer point to point and fallback to loopback.
|
|
.It Li lport-only
|
|
Loopback only.
|
|
.It Li nport-only
|
|
Point to point only.
|
|
.El
|
|
.It Va hint.isp.0.portwwn
|
|
This should be the full 64 bit World Wide Port Name you would like
|
|
to use, overriding the value in NVRAM for the card.
|
|
.It Va hint.isp.0.nodewwn
|
|
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 Va hint.isp.0.iid
|
|
A hint to override or set the Initiator ID or Loop ID.
|
|
For Fibre Channel
|
|
cards in Local Loop topologies it is
|
|
.Ar strongly
|
|
recommended that you set this value to non-zero.
|
|
.It Va hint.isp.0.role
|
|
A hint to define default role for isp instance (target, initiator, both).
|
|
.It Va hint.isp.0.debug
|
|
A hint value for a driver debug level (see the file
|
|
.Pa /usr/src/sys/dev/isp/ispvar.h
|
|
for the values.
|
|
.El
|
|
.Sh SYSCTL OPTIONS
|
|
.Pp
|
|
.Bl -tag -width indent
|
|
.It Va dev.isp.N.loop_down_limit
|
|
This value says how long to wait in seconds after loop has gone down before
|
|
giving up and expiring all of the devices that were visible.
|
|
The default is 300 seconds (5 minutes).
|
|
A separate (nonadjustable) timeout is used when
|
|
booting to not stop booting on lack of FC connectivity.
|
|
.It Va dev.isp.N.gone_device_time
|
|
This value says how long to wait for devices to reappear if they (temporarily)
|
|
disappear due to loop or fabric events.
|
|
While this timeout is running, I/O
|
|
to those devices will simply be held.
|
|
.It Va dev.isp.N.wwnn
|
|
This is the readonly World Wide Node Name value for this port.
|
|
.It Va dev.isp.N.wwpn
|
|
This is the readonly World Wide Port Name value for this port.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr da 4 ,
|
|
.Xr intro 4 ,
|
|
.Xr ispfw 4 ,
|
|
.Xr sa 4 ,
|
|
.Xr scsi 4 ,
|
|
.Xr gmultipath 8
|
|
.Sh AUTHORS
|
|
The
|
|
.Nm
|
|
driver was written by Matthew Jacob originally for NetBSD at
|
|
NASA/Ames Research Center.
|
|
.Sh BUGS
|
|
The driver currently ignores some NVRAM settings.
|
|
.Pp
|
|
Target mode support is not completely reliable yet.
|
|
It works reasonably
|
|
well for Fibre Channel, somewhat well for Qlogic 1040 cards, but
|
|
does not yet work for the other cards (due to last minute unannounced
|
|
changes in firmware interfaces).
|