xref: /illumos-gate/usr/src/uts/common/io/fibre-channel/fca/qlc/qlc.conf (revision 8159a906dbf7d5466ef599875f165fe944ed07e7)
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License (the "License").
6# You may not use this file except in compliance with the License.
7#
8# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9# or http://www.opensolaris.org/os/licensing.
10# See the License for the specific language governing permissions
11# and limitations under the License.
12#
13# When distributing Covered Code, include this CDDL HEADER in each
14# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15# If applicable, add the following below this CDDL HEADER, with the
16# fields enclosed by brackets "[]" replaced with your own identifying
17# information: Portions Copyright [yyyy] [name of copyright owner]
18#
19# CDDL HEADER END
20#
21
22# Copyright 2008 QLogic Corporation
23
24#
25# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
26# Use is subject to license terms.
27#
28# Qlogic Fibre Channel Adapter driver configuration
29#
30#ident	"Copyright 2007 QLogic Corporation; ql.conf"
31#
32
33#
34# Copyright (C) QLogic Corporation 1998-2007. All rights reserved.
35#
36
37#   File is setup as the default parameters for all adapters in the
38#   system.
39#   If a parameter needs to be changed for a particular adapter,
40#   make a copy of the parameter. Then change the hba number
41#   (decimal) in the parameter to match the adapter instance number
42#   that is displayed during the boot process. Now alter the
43#   parameter for the adapter.
44#
45#   example:
46#       Setting hard address of 124 and 125 for adapter
47#       instance 3 and 4 respectively.
48#
49#       Before:
50#           enable-adapter-hard-loop-ID=0;
51#
52#           adapter-hard-loop-ID=0;
53#
54#       After:
55#           enable-adapter-hard-loop-ID=0;
56#           hba3-enable-adapter-hard-loop-ID=1;
57#           hba4-enable-adapter-hard-loop-ID=1;
58#
59#           adapter-hard-loop-ID=0;
60#           hba3-adapter-hard-loop-ID=124;
61#           hba4-adapter-hard-loop-ID=125;
62#
63
64#Name:  Maximum frame length
65#Type:  Integer, bytes;  Range: 512, 1024, 2048
66#       Default: 2048
67#Usage: This field specifies the frame payload length (in bytes) used by
68#       the ISP2xxx firmware.
69#NOTE:  The minimum value is 512 bytes; if this variable is not equal to
70#       512, 1024 or 2048, the ISP2xxx defaults to values specified
71#       above.
72max-frame-length=2048;
73
74#Name:  Execution throttle
75#Type:  Integer, commands; Range: 1 - 65535; Default: 32
76#Usage: This field specifies the maximum number of commands sent per LUN
77#       by the ISP2xxx firmware.
78#NOTE:  Exceeding device capabilities causes unneeded command retries
79#       that impact performance.
80execution-throttle=32;
81
82#Name:  Login timeout
83#Type:  Integer, count; Range: 0 - 255; Default: 3
84#Usage: This field specifies the maximum number seconds to
85#       wait for the login of a device to complete.
86#NOTE:  Large values may cause long delays during initialization
87#       and device reconfiguration.
88login-timeout=3;
89
90#Name:  Login retry count
91#Type:  Integer, count; Range: 0 - 255; Default: 4
92#Usage: This field specifies the maximum number of retry attempts
93#       for the firmware when the login into a device fails.
94#NOTE:  Large values may cause long delays during initialization
95#       and device reconfiguration.
96login-retry-count=4;
97
98#Name:  Enable adapter hard loop ID
99#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
100#Usage: This field allows the setting of adapters hard loop ID on the
101#       fibre channel bus.
102#NOTE:  May be necessary on some bus configurations where devices fail to
103#       appear.
104enable-adapter-hard-loop-ID=0;
105
106#Name:  Adapter hard loop ID
107#Type:  Integer, ID; Range: 0-125; Default: 0
108#Usage: This field specifies the adapters hard loop ID to be used on the
109#       Fibre Channel bus.
110#NOTE:  This field takes effect only when adapter hard loop ID is enabled.
111adapter-hard-loop-ID=0;
112
113#Name:  Enable LIP reset on bus reset
114#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
115#Usage: This field enables the adapter to issue a LIP reset during Fibre
116#       Channel reset.
117enable-LIP-reset-on-bus-reset=0;
118
119#Name:  Enable LIP full login on bus reset
120#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
121#Usage: This field enables the adapter to issue a LIP full login reset
122#       during Fibre Channel reset.
123enable-LIP-full-login-on-bus-reset=1;
124
125#Name:  Enable target reset on bus reset
126#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
127#Usage: This field enables the adapter to issue a LIP target reset during
128#       Fibre Channel reset.
129enable-target-reset-on-bus-reset=0;
130
131#Name:  Reset delay
132#Type:  Integer, seconds; Range: 1 - 255; Default: 5
133#Usage: This field specifies the delay after a reset before sending
134#       commands to the devices on the Fibre Channel bus.
135reset-delay=5;
136
137#Name:  Port down retry count
138#Type:  Integer, count; Range: 0 - 255; Default: 8
139#Usage: This field specifies the amount of command retries to be done
140#       when devices are not responding on the Fibre Channel bus.
141#NOTE:  Large values may cause long delays for failover software to
142#       detect a failing device.
143port-down-retry-count=8;
144
145#Name:  Port down retry delay
146#Type:  Integer, count; Range 0 - 255 seconds. Default: 2
147#Usage: Amount of time to delay between port down retries.
148#NOTE:  Large values may cause long delays for failover software to
149#       detect a failing device. May also cause upper layer driver
150#       or applications to timeout the IO's.
151port-down-retry-delay=2;
152
153#Name:  Queue full retry count
154#Type:  Integer, count. Range: 0 - 255. Default: 16
155#Usage: This field specified the number of times to retry a SCSI
156#       queue full error.
157queue-full-retry-count=16;
158
159#Name:  Queue full retry delay
160#Type:  Integer, seconds. Range: 0 - 255 seconds. Default: 2
161#Usage: This field specifies the amount of time to delay after a SCSI
162#       queue full error before starting any new I/O commands.
163queue-full-retry-delay=2;
164
165#Name:  Connection options
166#Type:  Integer, mode; Range: 0 - 2; Default: 2
167#       0 = loop only
168#       1 = point-to-point only
169#       2 = loop preferred, else point-to-point
170#Usage: This field specifies the connection mode the driver firmware
171#       uses. When connecting the HBA to a switch port with auto-
172#       mode sensing capability (a G port), it is recommended that this
173#       parameter be set to either 0 or 1, not 2. Setting this
174#       parameter to 2 when connected to a G port on a switch may
175#       result in device lost or system hang.
176connection-options=2;
177
178#Name:  Enable FCP 2 Error Recovery
179#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
180#Usage: This field enables/disables the Fibre Channel FCP 2 error
181#       recovery support.
182enable-FCP-2-error-recovery=1;
183
184#Name:  Fibre Channel Data Rate Option
185#Type:  Integer, mode; Range: 0-4; Default: 2
186#       0 = 1 gigabit/second
187#       1 = 2 gigabit/second
188#       2 = Auto-negotiate
189#       3 = 4 gigabit/second
190#       4 = 8 gigabit/second
191#Usage: This field specifies the data rate which the driver uses.
192fc-data-rate=2;
193
194#Name:  Link down timeout
195#Type:  Integer, seconds; Range: 0 - 240; Default: 0
196#Usage: This field specifies the amount of time the driver waits for
197#       a Fibre Channel loop to come up before reporting the failure.
198#NOTE:  Small values may report transient errors that should be ignored.
199link-down-timeout=0;
200
201#Name:  Link down error
202#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 1
203#Usage: This field disables the driver error reporting during link down
204#       conditions.
205enable-link-down-error=1;
206
207#Name:  Enable extended logging
208#Type:  Integer, flag; Range: 0 (disable), 1 (enable); Default: 0
209#Usage: This field enables logging of driver detected events occurring
210#       either in the driver or fibre channel bus. Events are logged
211#       in Solaris /var/adm/messages file.
212extended-logging=0;
213
214#Name:  Firmware Dump Flags
215#Type:  Integer, flag bits; Range: 0 (disable), 1 (enable); Default: 0
216#Usage: These flags are used to force a firmware dump when the flag
217#       condition occurs. More than one flag bit can be combined to
218#       obtain the desired result.
219#       TAKE_FW_DUMP_ON_MAILBOX_TIMEOUT         1
220#       TAKE_FW_DUMP_ON_ISP_SYSTEM_ERROR        2
221#       TAKE_FW_DUMP_ON_DRIVER_COMMAND_TIMEOUT  4
222#       TAKE_FW_DUMP_ON_LOOP_OFFLINE_TIMEOUT    8
223firmware-dump-flags=0;
224
225#Name:  PCI max read request override
226#Type:  Integer, bytes; Range: 128, 256, 512, 1024, 2048, 4096
227#Usage: This field specifies the value to be used for the PCI max read
228#       request setting, overriding the default value or the value programmed
229#       by the system.
230#NOTE:  The minimum value is 128 bytes on PCI Express and 512 on PCI; if
231#       this variable does not exist or is not equal to 128, 256, 512,
232#       1024, 2048 or 4096, the ISP2xxx uses the default or the value
233#       specified by the system.
234pci-max-read-request=2048;
235
236#Name:	DDI Force Attach
237#Type:	Interger, byte; Range: 0, 1
238#Usage:	This field specifies to the Solaris kernel during boot to always
239#	load all instances of the driver regardless of system events or
240#	conditions.
241ddi-forceattach=1;
242
243#Name:	Init Loop Sync Time
244#Type:  Integer, seconds; Range: 1 - 240; Default: 10
245#Usage:	This field specific the time the driver will wait for the
246#	switch and the HBA firmware to sync during boot or the
247#	initial loading of the driver.
248init-loop-sync-wait=10;
249
250#Name:  DDI Force Load
251#Type:  String List
252#Usage: This field declares firmware module paths so that they get
253#       loaded early enough to be available for qlc root instance to
254#       use.  Correct operation depends on the value of 'ddi-forceload';
255#       this value should not be changed by the user.
256ddi-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";
257
258