xref: /onnv-gate/usr/src/uts/common/io/fibre-channel/fca/qlc/qlc.conf (revision 11924:ba3f66213a3a)
17836SJohn.Forte@Sun.COM#
27836SJohn.Forte@Sun.COM# CDDL HEADER START
37836SJohn.Forte@Sun.COM#
47836SJohn.Forte@Sun.COM# The contents of this file are subject to the terms of the
57836SJohn.Forte@Sun.COM# Common Development and Distribution License (the "License").
67836SJohn.Forte@Sun.COM# You may not use this file except in compliance with the License.
77836SJohn.Forte@Sun.COM#
87836SJohn.Forte@Sun.COM# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97836SJohn.Forte@Sun.COM# or http://www.opensolaris.org/os/licensing.
107836SJohn.Forte@Sun.COM# See the License for the specific language governing permissions
117836SJohn.Forte@Sun.COM# and limitations under the License.
127836SJohn.Forte@Sun.COM#
137836SJohn.Forte@Sun.COM# When distributing Covered Code, include this CDDL HEADER in each
147836SJohn.Forte@Sun.COM# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157836SJohn.Forte@Sun.COM# If applicable, add the following below this CDDL HEADER, with the
167836SJohn.Forte@Sun.COM# fields enclosed by brackets "[]" replaced with your own identifying
177836SJohn.Forte@Sun.COM# information: Portions Copyright [yyyy] [name of copyright owner]
187836SJohn.Forte@Sun.COM#
197836SJohn.Forte@Sun.COM# CDDL HEADER END
207836SJohn.Forte@Sun.COM#
217836SJohn.Forte@Sun.COM
22*11924SDaniel.Beauregard@Sun.COM# Copyright 2010 QLogic Corporation
237836SJohn.Forte@Sun.COM
247836SJohn.Forte@Sun.COM#
257836SJohn.Forte@Sun.COM# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
267836SJohn.Forte@Sun.COM# Use is subject to license terms.
277836SJohn.Forte@Sun.COM#
287836SJohn.Forte@Sun.COM# Qlogic Fibre Channel Adapter driver configuration
297836SJohn.Forte@Sun.COM#
30*11924SDaniel.Beauregard@Sun.COM#ident	"Copyright 2010 QLogic Corporation; ql.conf"
317836SJohn.Forte@Sun.COM#
327836SJohn.Forte@Sun.COM
337836SJohn.Forte@Sun.COM#
34*11924SDaniel.Beauregard@Sun.COM# Copyright (C) QLogic Corporation 1998-2010. All rights reserved.
357836SJohn.Forte@Sun.COM#
367836SJohn.Forte@Sun.COM
377836SJohn.Forte@Sun.COM#   File is setup as the default parameters for all adapters in the
387836SJohn.Forte@Sun.COM#   system.
397836SJohn.Forte@Sun.COM#   If a parameter needs to be changed for a particular adapter,
407836SJohn.Forte@Sun.COM#   make a copy of the parameter. Then change the hba number
417836SJohn.Forte@Sun.COM#   (decimal) in the parameter to match the adapter instance number
427836SJohn.Forte@Sun.COM#   that is displayed during the boot process. Now alter the
437836SJohn.Forte@Sun.COM#   parameter for the adapter.
447836SJohn.Forte@Sun.COM#
457836SJohn.Forte@Sun.COM#   example:
467836SJohn.Forte@Sun.COM#       Setting hard address of 124 and 125 for adapter
477836SJohn.Forte@Sun.COM#       instance 3 and 4 respectively.
487836SJohn.Forte@Sun.COM#
497836SJohn.Forte@Sun.COM#       Before:
507836SJohn.Forte@Sun.COM#           enable-adapter-hard-loop-ID=0;
517836SJohn.Forte@Sun.COM#
527836SJohn.Forte@Sun.COM#           adapter-hard-loop-ID=0;
537836SJohn.Forte@Sun.COM#
547836SJohn.Forte@Sun.COM#       After:
557836SJohn.Forte@Sun.COM#           enable-adapter-hard-loop-ID=0;
567836SJohn.Forte@Sun.COM#           hba3-enable-adapter-hard-loop-ID=1;
577836SJohn.Forte@Sun.COM#           hba4-enable-adapter-hard-loop-ID=1;
587836SJohn.Forte@Sun.COM#
597836SJohn.Forte@Sun.COM#           adapter-hard-loop-ID=0;
607836SJohn.Forte@Sun.COM#           hba3-adapter-hard-loop-ID=124;
617836SJohn.Forte@Sun.COM#           hba4-adapter-hard-loop-ID=125;
627836SJohn.Forte@Sun.COM#
637836SJohn.Forte@Sun.COM
647836SJohn.Forte@Sun.COM#Name:  Maximum frame length
657836SJohn.Forte@Sun.COM#Type:  Integer, bytes;  Range: 512, 1024, 2048
667836SJohn.Forte@Sun.COM#       Default: 2048
677836SJohn.Forte@Sun.COM#Usage: This field specifies the frame payload length (in bytes) used by
687836SJohn.Forte@Sun.COM#       the ISP2xxx firmware.
697836SJohn.Forte@Sun.COM#NOTE:  The minimum value is 512 bytes; if this variable is not equal to
707836SJohn.Forte@Sun.COM#       512, 1024 or 2048, the ISP2xxx defaults to values specified
717836SJohn.Forte@Sun.COM#       above.
727836SJohn.Forte@Sun.COMmax-frame-length=2048;
737836SJohn.Forte@Sun.COM
747836SJohn.Forte@Sun.COM#Name:  Execution throttle
757836SJohn.Forte@Sun.COM#Type:  Integer, commands; Range: 1 - 65535; Default: 32
767836SJohn.Forte@Sun.COM#Usage: This field specifies the maximum number of commands sent per LUN
777836SJohn.Forte@Sun.COM#       by the ISP2xxx firmware.
787836SJohn.Forte@Sun.COM#NOTE:  Exceeding device capabilities causes unneeded command retries
797836SJohn.Forte@Sun.COM#       that impact performance.
807836SJohn.Forte@Sun.COMexecution-throttle=32;
817836SJohn.Forte@Sun.COM
827836SJohn.Forte@Sun.COM#Name:  Login timeout
837836SJohn.Forte@Sun.COM#Type:  Integer, count; Range: 0 - 255; Default: 3
847836SJohn.Forte@Sun.COM#Usage: This field specifies the maximum number seconds to
857836SJohn.Forte@Sun.COM#       wait for the login of a device to complete.
867836SJohn.Forte@Sun.COM#NOTE:  Large values may cause long delays during initialization
877836SJohn.Forte@Sun.COM#       and device reconfiguration.
887836SJohn.Forte@Sun.COMlogin-timeout=3;
897836SJohn.Forte@Sun.COM
907836SJohn.Forte@Sun.COM#Name:  Login retry count
917836SJohn.Forte@Sun.COM#Type:  Integer, count; Range: 0 - 255; Default: 4
927836SJohn.Forte@Sun.COM#Usage: This field specifies the maximum number of retry attempts
937836SJohn.Forte@Sun.COM#       for the firmware when the login into a device fails.
947836SJohn.Forte@Sun.COM#NOTE:  Large values may cause long delays during initialization
957836SJohn.Forte@Sun.COM#       and device reconfiguration.
967836SJohn.Forte@Sun.COMlogin-retry-count=4;
977836SJohn.Forte@Sun.COM
987836SJohn.Forte@Sun.COM#Name:  Enable adapter hard loop ID
997836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
1007836SJohn.Forte@Sun.COM#Usage: This field allows the setting of adapters hard loop ID on the
1017836SJohn.Forte@Sun.COM#       fibre channel bus.
1027836SJohn.Forte@Sun.COM#NOTE:  May be necessary on some bus configurations where devices fail to
1037836SJohn.Forte@Sun.COM#       appear.
1047836SJohn.Forte@Sun.COMenable-adapter-hard-loop-ID=0;
1057836SJohn.Forte@Sun.COM
1067836SJohn.Forte@Sun.COM#Name:  Adapter hard loop ID
1077836SJohn.Forte@Sun.COM#Type:  Integer, ID; Range: 0-125; Default: 0
1087836SJohn.Forte@Sun.COM#Usage: This field specifies the adapters hard loop ID to be used on the
1097836SJohn.Forte@Sun.COM#       Fibre Channel bus.
1107836SJohn.Forte@Sun.COM#NOTE:  This field takes effect only when adapter hard loop ID is enabled.
1117836SJohn.Forte@Sun.COMadapter-hard-loop-ID=0;
1127836SJohn.Forte@Sun.COM
1137836SJohn.Forte@Sun.COM#Name:  Enable LIP reset on bus reset
1147836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
1157836SJohn.Forte@Sun.COM#Usage: This field enables the adapter to issue a LIP reset during Fibre
1167836SJohn.Forte@Sun.COM#       Channel reset.
1177836SJohn.Forte@Sun.COMenable-LIP-reset-on-bus-reset=0;
1187836SJohn.Forte@Sun.COM
1197836SJohn.Forte@Sun.COM#Name:  Enable LIP full login on bus reset
1207836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
1217836SJohn.Forte@Sun.COM#Usage: This field enables the adapter to issue a LIP full login reset
1227836SJohn.Forte@Sun.COM#       during Fibre Channel reset.
1237836SJohn.Forte@Sun.COMenable-LIP-full-login-on-bus-reset=1;
1247836SJohn.Forte@Sun.COM
1257836SJohn.Forte@Sun.COM#Name:  Enable target reset on bus reset
1267836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
1277836SJohn.Forte@Sun.COM#Usage: This field enables the adapter to issue a LIP target reset during
1287836SJohn.Forte@Sun.COM#       Fibre Channel reset.
1297836SJohn.Forte@Sun.COMenable-target-reset-on-bus-reset=0;
1307836SJohn.Forte@Sun.COM
1317836SJohn.Forte@Sun.COM#Name:  Reset delay
1327836SJohn.Forte@Sun.COM#Type:  Integer, seconds; Range: 1 - 255; Default: 5
1337836SJohn.Forte@Sun.COM#Usage: This field specifies the delay after a reset before sending
1347836SJohn.Forte@Sun.COM#       commands to the devices on the Fibre Channel bus.
1357836SJohn.Forte@Sun.COMreset-delay=5;
1367836SJohn.Forte@Sun.COM
1377836SJohn.Forte@Sun.COM#Name:  Port down retry count
1387836SJohn.Forte@Sun.COM#Type:  Integer, count; Range: 0 - 255; Default: 8
1397836SJohn.Forte@Sun.COM#Usage: This field specifies the amount of command retries to be done
1407836SJohn.Forte@Sun.COM#       when devices are not responding on the Fibre Channel bus.
1417836SJohn.Forte@Sun.COM#NOTE:  Large values may cause long delays for failover software to
1427836SJohn.Forte@Sun.COM#       detect a failing device.
1437836SJohn.Forte@Sun.COMport-down-retry-count=8;
1447836SJohn.Forte@Sun.COM
1457836SJohn.Forte@Sun.COM#Name:  Port down retry delay
1467836SJohn.Forte@Sun.COM#Type:  Integer, count; Range 0 - 255 seconds. Default: 2
1477836SJohn.Forte@Sun.COM#Usage: Amount of time to delay between port down retries.
1487836SJohn.Forte@Sun.COM#NOTE:  Large values may cause long delays for failover software to
1497836SJohn.Forte@Sun.COM#       detect a failing device. May also cause upper layer driver
1507836SJohn.Forte@Sun.COM#       or applications to timeout the IO's.
1517836SJohn.Forte@Sun.COMport-down-retry-delay=2;
1527836SJohn.Forte@Sun.COM
1537836SJohn.Forte@Sun.COM#Name:  Queue full retry count
1547836SJohn.Forte@Sun.COM#Type:  Integer, count. Range: 0 - 255. Default: 16
1557836SJohn.Forte@Sun.COM#Usage: This field specified the number of times to retry a SCSI
1567836SJohn.Forte@Sun.COM#       queue full error.
1577836SJohn.Forte@Sun.COMqueue-full-retry-count=16;
1587836SJohn.Forte@Sun.COM
1597836SJohn.Forte@Sun.COM#Name:  Queue full retry delay
1607836SJohn.Forte@Sun.COM#Type:  Integer, seconds. Range: 0 - 255 seconds. Default: 2
1617836SJohn.Forte@Sun.COM#Usage: This field specifies the amount of time to delay after a SCSI
1627836SJohn.Forte@Sun.COM#       queue full error before starting any new I/O commands.
1637836SJohn.Forte@Sun.COMqueue-full-retry-delay=2;
1647836SJohn.Forte@Sun.COM
1657836SJohn.Forte@Sun.COM#Name:  Connection options
1667836SJohn.Forte@Sun.COM#Type:  Integer, mode; Range: 0 - 2; Default: 2
1677836SJohn.Forte@Sun.COM#       0 = loop only
1687836SJohn.Forte@Sun.COM#       1 = point-to-point only
1697836SJohn.Forte@Sun.COM#       2 = loop preferred, else point-to-point
1707836SJohn.Forte@Sun.COM#Usage: This field specifies the connection mode the driver firmware
1717836SJohn.Forte@Sun.COM#       uses. When connecting the HBA to a switch port with auto-
1727836SJohn.Forte@Sun.COM#       mode sensing capability (a G port), it is recommended that this
1737836SJohn.Forte@Sun.COM#       parameter be set to either 0 or 1, not 2. Setting this
1747836SJohn.Forte@Sun.COM#       parameter to 2 when connected to a G port on a switch may
1757836SJohn.Forte@Sun.COM#       result in device lost or system hang.
1767836SJohn.Forte@Sun.COMconnection-options=2;
1777836SJohn.Forte@Sun.COM
1787836SJohn.Forte@Sun.COM#Name:  Enable FCP 2 Error Recovery
1797836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
1807836SJohn.Forte@Sun.COM#Usage: This field enables/disables the Fibre Channel FCP 2 error
1817836SJohn.Forte@Sun.COM#       recovery support.
1827836SJohn.Forte@Sun.COMenable-FCP-2-error-recovery=1;
1837836SJohn.Forte@Sun.COM
1847836SJohn.Forte@Sun.COM#Name:  Fibre Channel Data Rate Option
1857836SJohn.Forte@Sun.COM#Type:  Integer, mode; Range: 0-4; Default: 2
1867836SJohn.Forte@Sun.COM#       0 = 1 gigabit/second
1877836SJohn.Forte@Sun.COM#       1 = 2 gigabit/second
1887836SJohn.Forte@Sun.COM#       2 = Auto-negotiate
1897836SJohn.Forte@Sun.COM#       3 = 4 gigabit/second
1907836SJohn.Forte@Sun.COM#       4 = 8 gigabit/second
1917836SJohn.Forte@Sun.COM#Usage: This field specifies the data rate which the driver uses.
1927836SJohn.Forte@Sun.COMfc-data-rate=2;
1937836SJohn.Forte@Sun.COM
1947836SJohn.Forte@Sun.COM#Name:  Link down timeout
1957836SJohn.Forte@Sun.COM#Type:  Integer, seconds; Range: 0 - 240; Default: 0
1967836SJohn.Forte@Sun.COM#Usage: This field specifies the amount of time the driver waits for
1977836SJohn.Forte@Sun.COM#       a Fibre Channel loop to come up before reporting the failure.
1987836SJohn.Forte@Sun.COM#NOTE:  Small values may report transient errors that should be ignored.
1997836SJohn.Forte@Sun.COMlink-down-timeout=0;
2007836SJohn.Forte@Sun.COM
2017836SJohn.Forte@Sun.COM#Name:  Link down error
2027836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
2037836SJohn.Forte@Sun.COM#Usage: This field disables the driver error reporting during link down
2047836SJohn.Forte@Sun.COM#       conditions.
2057836SJohn.Forte@Sun.COMenable-link-down-error=1;
2067836SJohn.Forte@Sun.COM
2077836SJohn.Forte@Sun.COM#Name:  Enable extended logging
2087836SJohn.Forte@Sun.COM#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
2097836SJohn.Forte@Sun.COM#Usage: This field enables logging of driver detected events occurring
2107836SJohn.Forte@Sun.COM#       either in the driver or fibre channel bus. Events are logged
2117836SJohn.Forte@Sun.COM#       in Solaris /var/adm/messages file.
2127836SJohn.Forte@Sun.COMextended-logging=0;
2137836SJohn.Forte@Sun.COM
2147836SJohn.Forte@Sun.COM#Name:  Firmware Dump Flags
2157836SJohn.Forte@Sun.COM#Type:  Integer, flag bits; Range: 0 (disable), 1 (enable); Default: 0
2167836SJohn.Forte@Sun.COM#Usage: These flags are used to force a firmware dump when the flag
2177836SJohn.Forte@Sun.COM#       condition occurs. More than one flag bit can be combined to
2187836SJohn.Forte@Sun.COM#       obtain the desired result.
2197836SJohn.Forte@Sun.COM#       TAKE_FW_DUMP_ON_MAILBOX_TIMEOUT         1
2207836SJohn.Forte@Sun.COM#       TAKE_FW_DUMP_ON_ISP_SYSTEM_ERROR        2
2217836SJohn.Forte@Sun.COM#       TAKE_FW_DUMP_ON_DRIVER_COMMAND_TIMEOUT  4
2227836SJohn.Forte@Sun.COM#       TAKE_FW_DUMP_ON_LOOP_OFFLINE_TIMEOUT    8
2237836SJohn.Forte@Sun.COMfirmware-dump-flags=0;
2247836SJohn.Forte@Sun.COM
2257836SJohn.Forte@Sun.COM#Name:  PCI max read request override
2267836SJohn.Forte@Sun.COM#Type:  Integer, bytes; Range: 128, 256, 512, 1024, 2048, 4096
2277836SJohn.Forte@Sun.COM#Usage: This field specifies the value to be used for the PCI max read
2287836SJohn.Forte@Sun.COM#       request setting, overriding the default value or the value programmed
2297836SJohn.Forte@Sun.COM#       by the system.
2307836SJohn.Forte@Sun.COM#NOTE:  The minimum value is 128 bytes on PCI Express and 512 on PCI; if
231*11924SDaniel.Beauregard@Sun.COM#       this variable does not exist or is not equal to 128, 256, 512,
2327836SJohn.Forte@Sun.COM#       1024, 2048 or 4096, the ISP2xxx uses the default or the value
2337836SJohn.Forte@Sun.COM#       specified by the system.
2347836SJohn.Forte@Sun.COMpci-max-read-request=2048;
2357836SJohn.Forte@Sun.COM
2367836SJohn.Forte@Sun.COM#Name:	DDI Force Attach
2377836SJohn.Forte@Sun.COM#Type:	Interger, byte; Range: 0, 1
2387836SJohn.Forte@Sun.COM#Usage:	This field specifies to the Solaris kernel during boot to always
2397836SJohn.Forte@Sun.COM#	load all instances of the driver regardless of system events or
2407836SJohn.Forte@Sun.COM#	conditions.
2417836SJohn.Forte@Sun.COMddi-forceattach=1;
2427836SJohn.Forte@Sun.COM
2437836SJohn.Forte@Sun.COM#Name:	Init Loop Sync Time
2447836SJohn.Forte@Sun.COM#Type:  Integer, seconds; Range: 1 - 240; Default: 10
2457836SJohn.Forte@Sun.COM#Usage:	This field specific the time the driver will wait for the
2467836SJohn.Forte@Sun.COM#	switch and the HBA firmware to sync during boot or the
2477836SJohn.Forte@Sun.COM#	initial loading of the driver.
2487836SJohn.Forte@Sun.COMinit-loop-sync-wait=10;
2497836SJohn.Forte@Sun.COM
2507836SJohn.Forte@Sun.COM#Name:  DDI Force Load
2517836SJohn.Forte@Sun.COM#Type:  String List
2527836SJohn.Forte@Sun.COM#Usage: This field declares firmware module paths so that they get
2537836SJohn.Forte@Sun.COM#       loaded early enough to be available for qlc root instance to
2547836SJohn.Forte@Sun.COM#       use.  Correct operation depends on the value of 'ddi-forceload';
2557836SJohn.Forte@Sun.COM#       this value should not be changed by the user.
256*11924SDaniel.Beauregard@Sun.COMddi-forceload = "misc/qlc/qlc_fw_2200", "misc/qlc/qlc_fw_2300", "misc/qlc/qlc_fw_2400", "misc/qlc/qlc_fw_2500", "misc/qlc/qlc_fw_6322", "misc/qlc/qlc_fw_8100";
2577836SJohn.Forte@Sun.COM
258