2020-11-20 01:15:48 +00:00
|
|
|
.\" Copyright (c) 2009-2020 Alexander Motin <mav@FreeBSD.org>
|
2015-11-23 15:49:50 +00:00
|
|
|
.\" Copyright (c) 2006 Marcus Alves Grando
|
|
|
|
.\" Copyright (c) 1998-2001 Matthew Jacob, for NASA/Ames Research Center
|
2000-02-14 23:47:55 +00:00
|
|
|
.\"
|
|
|
|
.\" 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
|
2000-03-24 02:17:04 +00:00
|
|
|
.\" derived from this software without specific prior written permission.
|
2000-02-14 23:47:55 +00:00
|
|
|
.\"
|
|
|
|
.\" 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.
|
|
|
|
.\"
|
2005-02-09 18:07:17 +00:00
|
|
|
.\" $FreeBSD$
|
2000-02-14 23:47:55 +00:00
|
|
|
.\"
|
2020-11-20 01:15:48 +00:00
|
|
|
.Dd November 19, 2020
|
2000-02-14 23:47:55 +00:00
|
|
|
.Dt ISP 4
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm isp
|
2020-11-20 01:15:48 +00:00
|
|
|
.Nd Qlogic FibreChannel SCSI Host Adapters driver
|
2000-02-14 23:47:55 +00:00
|
|
|
.Sh SYNOPSIS
|
2006-05-20 09:39:28 +00:00
|
|
|
To compile this driver into the kernel,
|
|
|
|
place the following lines in your
|
|
|
|
kernel configuration file:
|
|
|
|
.Bd -ragged -offset indent
|
|
|
|
.Cd "device scbus"
|
2000-02-14 23:47:55 +00:00
|
|
|
.Cd "device isp"
|
2016-12-20 21:17:07 +00:00
|
|
|
.Cd "device ispfw"
|
2006-05-20 09:39:28 +00:00
|
|
|
.Ed
|
2000-02-14 23:47:55 +00:00
|
|
|
.Pp
|
2006-05-20 09:39:28 +00:00
|
|
|
Alternatively, to load the driver as a
|
2016-12-20 21:17:07 +00:00
|
|
|
module at boot time, place the following lines in
|
2006-05-20 09:39:28 +00:00
|
|
|
.Xr loader.conf 5 :
|
|
|
|
.Bd -literal -offset indent
|
|
|
|
isp_load="YES"
|
2016-12-20 21:17:07 +00:00
|
|
|
ispfw_load="YES"
|
2006-05-20 09:39:28 +00:00
|
|
|
.Ed
|
2000-02-14 23:47:55 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
This driver provides access to
|
|
|
|
.Tn FibreChannel
|
2015-11-23 15:49:50 +00:00
|
|
|
SCSI devices.
|
2000-02-14 23:47:55 +00:00
|
|
|
.Pp
|
2020-11-20 01:15:48 +00:00
|
|
|
It supports initiator and target modes of FCP SCSI profile,
|
|
|
|
utilizing Class 3 and Class 2 connections.
|
2015-11-23 10:06:19 +00:00
|
|
|
Support is available for Public and Private loops, Point-to-Point
|
|
|
|
and Fabric connections.
|
2016-12-20 21:17:07 +00:00
|
|
|
.Pp
|
2020-11-20 01:15:48 +00:00
|
|
|
Supported FC-Tape functionality is highly recommended for connections
|
|
|
|
to tape drives that support it.
|
2017-03-05 18:00:52 +00:00
|
|
|
It encompasses four elements from the T-10 FCP-4 specification:
|
2016-12-20 21:17:07 +00:00
|
|
|
.Bl -bullet -offset indent
|
|
|
|
.It
|
|
|
|
Precise Delivery of Commands
|
|
|
|
.It
|
|
|
|
Confirmed Completion of FCP I/O Operations
|
|
|
|
.It
|
|
|
|
Retransmission of Unsuccessfully Transmitted IUs
|
|
|
|
.It
|
|
|
|
Task Retry Identification
|
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
Together these features allow for link level error recovery with tape
|
|
|
|
devices.
|
|
|
|
Without it, an initiator cannot, for instance, tell whether a tape write
|
|
|
|
command that has timed out resulted in all, part or none of the data going to
|
|
|
|
the tape drive.
|
|
|
|
FC-Tape is automatically enabled when connecting controller that supports
|
|
|
|
it to a target that supports it.
|
|
|
|
It may be disabled using configuration and hint options described below.
|
2000-07-20 16:11:23 +00:00
|
|
|
.Sh FIRMWARE
|
2015-11-23 10:06:19 +00:00
|
|
|
Firmware loading is supported if the
|
2000-07-20 16:11:23 +00:00
|
|
|
.Xr ispfw 4
|
2015-11-23 10:06:19 +00:00
|
|
|
module is loaded.
|
|
|
|
It is strongly recommended that you use the firmware available from
|
2001-07-26 22:43:40 +00:00
|
|
|
.Xr ispfw 4
|
|
|
|
as it is the most likely to have been tested with this driver.
|
2000-02-14 23:47:55 +00:00
|
|
|
.Sh HARDWARE
|
2004-08-03 20:46:23 +00:00
|
|
|
Cards supported by the
|
|
|
|
.Nm
|
|
|
|
driver include:
|
2000-02-14 23:47:55 +00:00
|
|
|
.Bl -tag -width xxxxxx -offset indent
|
2007-02-28 23:21:51 +00:00
|
|
|
.It Qlogic 2422
|
2020-11-20 01:15:48 +00:00
|
|
|
Optical 4Gb Fibre Channel PCI-X cards.
|
2015-12-10 01:41:05 +00:00
|
|
|
.It Qlogic 246x (aka 2432)
|
2015-11-23 10:06:19 +00:00
|
|
|
Optical 4Gb Fibre Channel PCIe cards.
|
2015-12-10 01:41:05 +00:00
|
|
|
.It Qlogic 256x (aka 2532)
|
2015-11-23 10:06:19 +00:00
|
|
|
Optical 8Gb Fibre Channel PCIe cards.
|
2015-12-10 01:41:05 +00:00
|
|
|
.It Qlogic 267x/836x (aka 2031/8031)
|
|
|
|
Optical 16Gb FC/FCoE PCIe cards.
|
2018-02-28 16:24:32 +00:00
|
|
|
.It Qlogic 2690/2692/2694 (aka 2684/2692)
|
|
|
|
Optical 16Gb Fibre Channel PCIe cards.
|
|
|
|
.It Qlogic 2740/2742/2764 (aka 2722/2714)
|
|
|
|
Optical 32Gb Fibre Channel PCIe cards.
|
2000-02-14 23:47:55 +00:00
|
|
|
.El
|
|
|
|
.Sh CONFIGURATION OPTIONS
|
2015-11-23 15:49:50 +00:00
|
|
|
Target mode support for Fibre Channel adapters may be enabled with the
|
2000-11-10 17:46:15 +00:00
|
|
|
.Pp
|
2000-02-14 23:47:55 +00:00
|
|
|
.Cd options ISP_TARGET_MODE
|
2000-11-10 17:46:15 +00:00
|
|
|
.Pp
|
2000-02-14 23:47:55 +00:00
|
|
|
option.
|
2016-12-20 21:17:07 +00:00
|
|
|
.Pp
|
|
|
|
To disable FC-Tape, use the following configuration option:
|
|
|
|
.Pp
|
|
|
|
.Cd options ISP_FCTAPE_OFF
|
|
|
|
.Pp
|
|
|
|
Note that even if the ISP_FCTAPE_OFF option is used, it may be overridden
|
|
|
|
by the fctape hint described below.
|
2000-02-14 23:47:55 +00:00
|
|
|
.Sh BOOT OPTIONS
|
2006-02-06 19:28:46 +00:00
|
|
|
The following options are switchable by setting values in
|
|
|
|
.Pa /boot/device.hints .
|
|
|
|
.Pp
|
2001-09-04 09:47:40 +00:00
|
|
|
They are:
|
2006-02-06 19:28:46 +00:00
|
|
|
.Bl -tag -width indent
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .msi
|
|
|
|
Limit on number of Message Signaled Interrupts (MSI) to be used.
|
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .msix
|
|
|
|
Limit on number of Extended Message Signaled Interrupts (MSI-X) to be used.
|
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .fwload_disable
|
2006-02-06 19:28:46 +00:00
|
|
|
A hint value to disable loading of firmware
|
2006-09-18 15:24:20 +00:00
|
|
|
.Xr ispfw 4 .
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .ignore_nvram
|
2006-09-18 15:24:20 +00:00
|
|
|
A hint value to ignore board NVRAM settings for.
|
|
|
|
Otherwise use NVRAM settings.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .fullduplex
|
2006-02-06 19:28:46 +00:00
|
|
|
A hint value to set full duplex mode.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .topology
|
2006-09-18 15:24:20 +00:00
|
|
|
A hint value to select topology of connection.
|
|
|
|
Supported values are:
|
2006-02-06 19:28:46 +00:00
|
|
|
.Pp
|
2006-09-18 15:24:20 +00:00
|
|
|
.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
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .portwwn
|
2006-02-06 19:28:46 +00:00
|
|
|
This should be the full 64 bit World Wide Port Name you would like
|
|
|
|
to use, overriding the value in NVRAM for the card.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .nodewwn
|
2000-07-20 16:11:23 +00:00
|
|
|
This should be the full 64 bit World Wide Node Name you would like
|
|
|
|
to use, overriding the value in NVRAM for the card.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .iid
|
2007-03-01 09:07:04 +00:00
|
|
|
A hint to override or set the Initiator ID or Loop ID.
|
|
|
|
For Fibre Channel
|
2007-02-28 23:21:51 +00:00
|
|
|
cards in Local Loop topologies it is
|
|
|
|
.Ar strongly
|
|
|
|
recommended that you set this value to non-zero.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .role
|
2015-11-23 10:06:19 +00:00
|
|
|
A hint to define default role for isp instance (0 -- none, 1 -- target,
|
|
|
|
2 -- initiator, 3 -- both).
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .debug
|
2007-02-28 23:21:51 +00:00
|
|
|
A hint value for a driver debug level (see the file
|
|
|
|
.Pa /usr/src/sys/dev/isp/ispvar.h
|
|
|
|
for the values.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .vports
|
2014-12-01 17:51:16 +00:00
|
|
|
A hint to create specified number of additional virtual ports.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .nofctape
|
2016-12-20 21:17:07 +00:00
|
|
|
Set this to 1 to disable FC-Tape operation on the given isp instance.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va hint.isp. Ns Ar N Ns Va .fctape
|
2016-12-20 21:17:07 +00:00
|
|
|
Set this to 1 to enable FC-Tape operation on the given isp instance for
|
|
|
|
targets that support it.
|
2007-02-28 23:21:51 +00:00
|
|
|
.El
|
|
|
|
.Sh SYSCTL OPTIONS
|
|
|
|
.Bl -tag -width indent
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va dev.isp. Ns Ar N Ns Va .loop_down_limit
|
2007-02-28 23:21:51 +00:00
|
|
|
This value says how long to wait in seconds after loop has gone down before
|
2007-03-01 09:07:04 +00:00
|
|
|
giving up and expiring all of the devices that were visible.
|
|
|
|
The default is 300 seconds (5 minutes).
|
2010-07-30 11:58:18 +00:00
|
|
|
A separate (nonadjustable) timeout is used when
|
2007-02-28 23:21:51 +00:00
|
|
|
booting to not stop booting on lack of FC connectivity.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va dev.isp. Ns Ar N Ns Va .gone_device_time
|
2007-02-28 23:21:51 +00:00
|
|
|
This value says how long to wait for devices to reappear if they (temporarily)
|
2007-03-01 09:07:04 +00:00
|
|
|
disappear due to loop or fabric events.
|
|
|
|
While this timeout is running, I/O
|
2007-02-28 23:21:51 +00:00
|
|
|
to those devices will simply be held.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va dev.isp. Ns Ar N Ns Va .use_gff_id
|
|
|
|
.It Va dev.isp. Ns Ar N Ns Va .use_gft_id
|
2017-07-03 15:56:45 +00:00
|
|
|
Setting those options to 0 allows to disable use of GFF_ID and GFT_ID SNS
|
|
|
|
requests during FC fabric scan.
|
|
|
|
It may be useful if switch does not implement them correctly,
|
|
|
|
preventing some devices from being found.
|
|
|
|
Disabling them may cause unneeded logins to ports not supporting target role
|
|
|
|
or even FCP at all.
|
|
|
|
The default is 1 (enabled).
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va dev.isp. Ns Ar N Ns Va .wwnn
|
2007-02-28 23:21:51 +00:00
|
|
|
This is the readonly World Wide Node Name value for this port.
|
2019-02-28 15:24:00 +00:00
|
|
|
.It Va dev.isp. Ns Ar N Ns Va .wwpn
|
2007-02-28 23:21:51 +00:00
|
|
|
This is the readonly World Wide Port Name value for this port.
|
2000-02-14 23:47:55 +00:00
|
|
|
.El
|
2005-01-21 08:36:40 +00:00
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr da 4 ,
|
|
|
|
.Xr intro 4 ,
|
|
|
|
.Xr ispfw 4 ,
|
|
|
|
.Xr sa 4 ,
|
2009-05-05 13:48:53 +00:00
|
|
|
.Xr scsi 4 ,
|
|
|
|
.Xr gmultipath 8
|
2005-01-21 08:36:40 +00:00
|
|
|
.Sh AUTHORS
|
|
|
|
The
|
|
|
|
.Nm
|
2014-12-21 09:53:29 +00:00
|
|
|
driver was written by
|
|
|
|
.An Matthew Jacob
|
2015-10-29 09:50:48 +00:00
|
|
|
originally for NetBSD at NASA/Ames Research Center.
|
2017-07-03 15:56:45 +00:00
|
|
|
Later improvement was done by
|
2015-10-29 10:31:44 +00:00
|
|
|
.An Alexander Motin Aq Mt mav@FreeBSD.org .
|
2000-02-14 23:47:55 +00:00
|
|
|
.Sh BUGS
|
|
|
|
The driver currently ignores some NVRAM settings.
|