| isp.4 (81ae4b8da9920ccfb697984dbb2e8751573d183a) | isp.4 (4c38f2f8bc315d4f505aad43db4634346667a54c) |
|---|---|
| 1.\" $NetBSD: isp.4,v 1.5 1999/12/18 18:33:05 mjacob Exp $ 2.\" 3.\" Copyright (c) 1998, 1999, 2001 4.\" Matthew Jacob, for NASA/Ames Research Center 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: --- 15 unchanged lines hidden (view full) --- 24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27.\" 28.\" Additional Copyright (c) 2006 by Marcus Alves Grando 29.\" 30.\" $FreeBSD$ 31.\" | 1.\" $NetBSD: isp.4,v 1.5 1999/12/18 18:33:05 mjacob Exp $ 2.\" 3.\" Copyright (c) 1998, 1999, 2001 4.\" Matthew Jacob, for NASA/Ames Research Center 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: --- 15 unchanged lines hidden (view full) --- 24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27.\" 28.\" Additional Copyright (c) 2006 by Marcus Alves Grando 29.\" 30.\" $FreeBSD$ 31.\" |
| 32.Dd February 6, 2006 | 32.Dd February 28, 2007 |
| 33.Dt ISP 4 34.Os 35.Sh NAME 36.Nm isp 37.Nd Qlogic based SCSI and FibreChannel SCSI Host Adapters 38.Sh SYNOPSIS 39To compile this driver into the kernel, 40place the following lines in your --- 23 unchanged lines hidden (view full) --- 64ISP12160). 65.Pp 66Fibre Channel support uses FCP SCSI profile for 67.Tn FibreChannel . 68and utilizes Class 3 and Class 2 connections (Qlogic 2100 is Class 693 only, minor patches to the Qlogic 2200 to force Class 2 mode). 70Support is available for Public and Private loops, and for 71point-to-point connections (Qlogic 2200 only). | 33.Dt ISP 4 34.Os 35.Sh NAME 36.Nm isp 37.Nd Qlogic based SCSI and FibreChannel SCSI Host Adapters 38.Sh SYNOPSIS 39To compile this driver into the kernel, 40place the following lines in your --- 23 unchanged lines hidden (view full) --- 64ISP12160). 65.Pp 66Fibre Channel support uses FCP SCSI profile for 67.Tn FibreChannel . 68and utilizes Class 3 and Class 2 connections (Qlogic 2100 is Class 693 only, minor patches to the Qlogic 2200 to force Class 2 mode). 70Support is available for Public and Private loops, and for 71point-to-point connections (Qlogic 2200 only). |
| 72The newer 2-Gigabit cards (2300, 2312) are also supported. | 72The newer 2-Gigabit cards (2300, 2312, 2322) and 4-Gigabit(2422, 2432) 73are also supported. |
| 73Command tagging is 74supported for all (in fact, 75.Tn FibreChannel 76requires tagging). | 74Command tagging is 75supported for all (in fact, 76.Tn FibreChannel 77requires tagging). |
| 77Fabric support is enabled by default (but may 78be contingent upon the correct firmware being loaded). | 78Fabric support is enabled by default for other than 2100 cards. Fabric 79support for 2100 cards has been so problematic and these cards are so 80old now that it's just not worth your time to try it. |
| 79.Sh FIRMWARE 80Firmware is available if the 81.Xr ispfw 4 82module is loaded during bootstrap (q.v.). 83.Pp | 81.Sh FIRMWARE 82Firmware is available if the 83.Xr ispfw 4 84module is loaded during bootstrap (q.v.). 85.Pp |
| 84It is very strongly recommended that you use the firmware available | 86It is 87.Ar strongly 88recommended that you use the firmware available |
| 85from 86.Xr ispfw 4 87as it is the most likely to have been tested with this driver. 88.Sh HARDWARE 89Cards supported by the 90.Nm 91driver include: 92.Pp --- 27 unchanged lines hidden (view full) --- 120cards (single, dual, quad). 121.It Qlogic 2300 122Qlogic 2300 Optical Fibre Channel PCI cards. 123.It Qlogic 2312 124Qlogic 2312 Optical Fibre Channel PCI cards. 125.It Qlogic 234X 126Qlogic 234X Optical Fibre Channel PCI cards (2312 chipset, single and dual attach). 127.It Qlogic 2322 | 89from 90.Xr ispfw 4 91as it is the most likely to have been tested with this driver. 92.Sh HARDWARE 93Cards supported by the 94.Nm 95driver include: 96.Pp --- 27 unchanged lines hidden (view full) --- 124cards (single, dual, quad). 125.It Qlogic 2300 126Qlogic 2300 Optical Fibre Channel PCI cards. 127.It Qlogic 2312 128Qlogic 2312 Optical Fibre Channel PCI cards. 129.It Qlogic 234X 130Qlogic 234X Optical Fibre Channel PCI cards (2312 chipset, single and dual attach). 131.It Qlogic 2322 |
| 128Qlogic 2322 Optical Fibre Channel PCI cards. | 132Qlogic 2322 Optical Fibre Channel PCIe cards. |
| 129.It Qlogic 200 130Dell Branded version of the QLogic 2312 Fibre Channel PCI cards. | 133.It Qlogic 200 134Dell Branded version of the QLogic 2312 Fibre Channel PCI cards. |
| 135.It Qlogic 2422 136Qlogic 2422 Optical Fibre Channel PCI cards (4 Gigabit) 137.It Qlogic 2432 138Qlogic 2432 Optical Fibre Channel PCIe cards (4 Gigabit) |
|
| 131.El 132.Sh CONFIGURATION OPTIONS 133.Pp 134Target mode support may be enabled with the 135.Pp 136.Cd options ISP_TARGET_MODE 137.Pp 138option. --- 35 unchanged lines hidden (view full) --- 174.El 175.It Va hint.isp.0.portwwn 176This should be the full 64 bit World Wide Port Name you would like 177to use, overriding the value in NVRAM for the card. 178.It Va hint.isp.0.nodewwn 179This should be the full 64 bit World Wide Node Name you would like 180to use, overriding the value in NVRAM for the card. 181.It Va hint.isp.0.iid | 139.El 140.Sh CONFIGURATION OPTIONS 141.Pp 142Target mode support may be enabled with the 143.Pp 144.Cd options ISP_TARGET_MODE 145.Pp 146option. --- 35 unchanged lines hidden (view full) --- 182.El 183.It Va hint.isp.0.portwwn 184This should be the full 64 bit World Wide Port Name you would like 185to use, overriding the value in NVRAM for the card. 186.It Va hint.isp.0.nodewwn 187This should be the full 64 bit World Wide Node Name you would like 188to use, overriding the value in NVRAM for the card. 189.It Va hint.isp.0.iid |
| 182A hint to override or set the Initiator ID (principally for SPI SCSI). | 190A hint to override or set the Initiator ID or Loop ID. For Fibre Channel 191cards in Local Loop topologies it is 192.Ar strongly 193recommended that you set this value to non-zero. |
| 183.It Va hint.isp.0.role 184A hint to define default role for isp instance (target, initiator, both). 185.It Va hint.isp.0.debug | 194.It Va hint.isp.0.role 195A hint to define default role for isp instance (target, initiator, both). 196.It Va hint.isp.0.debug |
| 186A hint value for a driver debug level (values from 0 through 7). 187Default is 0. | 197A hint value for a driver debug level (see the file 198.Pa /usr/src/sys/dev/isp/ispvar.h 199for the values. |
| 188.El | 200.El |
| 201.Sh SYSCTL OPTIONS 202.Pp 203.Bl -tag -width indent 204.It Va dev.isp.N.loop_down_limit 205This value says how long to wait in seconds after loop has gone down before 206giving up and expiring all of the devices that were visible. The default is 207300 seconds (5 minutes). A seperate (nonadjustable) timeout is used when 208booting to not stop booting on lack of FC connectivity. 209.It Va dev.isp.N.gone_device_time 210This value says how long to wait for devices to reappear if they (temporarily) 211disappear due to loop or fabric events. While this timeout is running, I/O 212to those devices will simply be held. 213.It Va dev.isp.N.wwnn 214This is the readonly World Wide Node Name value for this port. 215.It Va dev.isp.N.wwpn 216This is the readonly World Wide Port Name value for this port. 217.El |
|
| 189.Sh SEE ALSO 190.Xr da 4 , 191.Xr intro 4 , 192.Xr ispfw 4 , 193.Xr sa 4 , 194.Xr scsi 4 195.Sh AUTHORS 196The 197.Nm | 218.Sh SEE ALSO 219.Xr da 4 , 220.Xr intro 4 , 221.Xr ispfw 4 , 222.Xr sa 4 , 223.Xr scsi 4 224.Sh AUTHORS 225The 226.Nm |
| 198driver was written by Matthew Jacob for NASA/Ames Research Center. | 227driver was written by Matthew Jacob originally for NetBSD at 228NASA/Ames Research Center. |
| 199.Sh BUGS 200The driver currently ignores some NVRAM settings. 201.Pp | 229.Sh BUGS 230The driver currently ignores some NVRAM settings. 231.Pp |
| 202The driver currently does not do error recovery for timed out commands 203very gracefully. 204.Pp 205Target mode support is not completely debugged yet. | 232Target mode support is not completely reliable yet. |
| 206It works reasonably 207well for Fibre Channel, somewhat well for Qlogic 1040 cards, but 208does not yet work for the other cards (due to last minute unannounced 209changes in firmware interfaces). | 233It works reasonably 234well for Fibre Channel, somewhat well for Qlogic 1040 cards, but 235does not yet work for the other cards (due to last minute unannounced 236changes in firmware interfaces). |
| 210.Pp 211Sometimes, when booting, the driver gets stuck waiting for the 212Fibre Channel f/w to tell it that the loop port database is ready, 213or waiting for a good loop to be seen (this does not yet support 214booting without being connected to a fibre channel device). 215To 216unwedge the system, unplug and replug the fibre channel connection, 217or otherwise cause a LIP (Loop Initialization Primitive sequence)- 218this will kick the f/w into getting unstuck. 219.Pp 220QLogic 2322 support is limited to platforms where the BIOS can 221enable firmware as there is no code yet to do the 3 stage loading 222for 2322 firmware. | |