xref: /illumos-gate/usr/src/uts/common/io/fibre-channel/fca/emlxs/emlxs.conf (revision 46b592853d0f4f11781b6b0a7533f267c6aee132)
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# Copyright 2009 Emulex.  All rights reserved.
22# Use is subject to License terms.
23#
24#
25#
26#
27# Solaris LightPulse emlxs driver: global initialized data.
28#
29
30
31# console-notices:  Sets the verbose level for driver notices to the console.
32# console-warnings: Sets the verbose level for driver warnings to the console.
33# console-errors:   Sets the verbose level for driver errors to the console.
34#
35# log-notices:  Sets the verbose level for driver notices to the system log file*.
36# log-warnings: Sets the verbose level for driver warnings to the system log file*.
37# log-errors:   Sets the verbose level for driver errors to the system log file*.
38#
39#       *NOTE:  The system log file is normally found at /var/adm/messages.
40#
41# Each parameter is a bit mask that enables/disables specific types of messages.
42# If the bit is set, then the messages of that type are enabled.
43#
44# The available message types are listed below:
45#
46# LOG_MISC        0x00000001     /* Misc events */
47# LOG_DRIVER      0x00000002     /* Driver attach and detach events */
48# LOG_INIT        0x00000004     /* HBA initialization events */
49# LOG_MEM         0x00000008     /* Memory managment events */
50# LOG_SLI         0x00000010     /* Service Level Interface (SLI) events */
51# LOG_MBOX        0x00000020     /* Mailbox events */
52# LOG_NODE        0x00000040     /* Node events */
53# LOG_LINK        0x00000080     /* Link events */
54# LOG_ELS         0x00000100     /* ELS events */
55# LOG_PKT         0x00000200     /* General I/O packet events */
56# LOG_FCP         0x00000400     /* FCP traffic events */
57# LOG_TGTM        0x00000800     /* FCP target mode events */
58# LOG_IP          0x00001000     /* IP traffic events */
59# LOG_SFS         0x00002000     /* SFS events */
60# LOG_IOCTL       0x00004000     /* IOCtl events */
61# LOG_FIRMWARE    0x00008000     /* Firmware download events */
62# LOG_CT          0x00010000     /* CT events */
63# LOG_FCSP        0x00020000     /* FCSP events */
64# LOG_RESERVED    0xfffc0000     /* Reserved for future use */
65#
66# Range:  Min:0  Max:0xffffffff
67#
68# console-notices  = 0;  (Default)
69# console-warnings = 0;  (Default)
70# console-errors   = 0;  (Default)
71#
72# log-notices  = 0xffffffff;  (Default)
73# log-warnings = 0xffffffff;  (Default)
74# log-errors   = 0xffffffff;  (Default)
75#
76console-notices=0;
77console-warnings=0;
78console-errors=0;
79log-notices=0xffffffff;
80log-warnings=0xffffffff;
81log-errors=0xffffffff;
82
83
84# num-iocbs:  Sets the number of iocb buffers to allocate.
85#
86# Range:  Min:128  Max:10240  Default:1024
87#
88num-iocbs=1024;
89
90
91# max-xfer-size:  Sets the maximum SCSI transfer size in bytes per IO
92# This parameter is only used by the driver on i386 platforms.
93# The driver does not limit transfer size on SPARC platforms.
94#
95# This parameter determines the scatter gather list buffer size.
96# A pool of buffers is reallocated by the driver during boot.
97# A larger transfer size requires a larger memory allocation.
98#
99#       Memory_model       max-xfer-size
100#     ----------------------------------------
101#       Small              131072 - 339968
102#       Medium             339969 - 688128
103#       Large              688129 - 1388544
104#
105# Range:  Min:131072   Max:1388544   Default:339968
106#
107max-xfer-size=339968;
108
109
110# ub-bufs:  Sets the number of unsolicited buffers to be allocated.
111#
112# Range:  Min:40  Max:16320  Default:1000
113#
114ub-bufs=1000;
115
116
117#
118# +++ Variables relating to IP networking support. +++
119#
120
121# network-on:  Enable/Disable IP networking support in the driver.
122#
123# 0 = Disables IP networking support in the driver.
124# 1 = Enables IP networking in the driver.
125#
126# Range:  Min:0  Max:1  Default:1
127#
128network-on=1;
129
130
131#
132# +++ Fibre Channel specific parameters +++
133#
134# topology:  link topology for initializing the Fibre Channel connection.
135#
136#          0 = attempt loop mode, if it fails attempt point-to-point mode
137#          2 = attempt point-to-point mode only
138#          4 = attempt loop mode only
139#          6 = attempt point-to-point mode, if it fails attempt loop mode
140#
141# Set point-to-point mode if you want to run as an N_Port.
142# Set loop mode if you want to run as an NL_Port.
143#
144# Range:  Min:0  Max:6  Default:0
145#
146topology=0;
147
148
149# link-speed:  Sets the link speed setting for initializing the Fibre Channel
150#              connection.
151#
152#  0 = auto select
153#  1 = 1 Gigabaud
154#  2 = 2 Gigabaud
155#  4 = 4 Gigabaud
156#  8 = 8 Gigabaud
157#
158# Range:  Min:0  Max:8  Default:0
159#
160link-speed=0;
161
162# ack0: Determines if ACK0 is used instead of ACK1 for class 2
163#       acknowledgement.
164#
165# 0 = The driver will use ACK1 for class 2 acknowledgement.
166# 1 = The driver will use ACK0 for class 2 acknowledgement.
167#
168# Range:  Min:0  Max:1  Default:0
169#
170ack0=0;
171
172
173# cr-delay: Sets the coalesce response delay in the adapter.
174#
175# This value specifies a count of milliseconds after which an interrupt
176# response is generated if cr-count has not been satisfied. This value is
177# set to 0 to disable the Coalesce Response feature as default.
178#
179# Range:  Min:0  Max:63  Default:0
180#
181cr-delay=0;
182
183
184# cr-count: Sets the coalesce response count in the adapter.
185#
186# This value specifies a count of I/O completions after which an interrupt
187# response is generated. This feature is disabled if cr-delay is set to 0.
188#
189# Range:  Min:1  Max:255  Default:1
190#
191cr-count=1;
192
193
194# assign-alpa: Sets a preferred ALPA for the adapter.
195#
196# This is only valid if topology is loop. A zero setting means no preference.
197# If multiple adapter instances on the same host are on the same loop,
198# you will want to set this value differently for each adapter.
199#
200# For example: emlxs0-assign-alpa=0x01;  assigns ALPA 0x01 to adapter 0
201#              emlxs1-assign-alpa=0x02;  assigns ALPA 0x02 to adapter 1
202#              emlxs2-assign-alpa=0x04;  assigns ALPA 0x04 to adapter 2
203#
204# Range:  Min:0x00  Max:0xef  Default:0x00  (valid ALPA's only)
205#
206assign-alpa=0x00;
207
208
209# adisc-support:  Sets the ADISC login support level.
210#
211# This sets the level of driver support for the Fibre Channel ADISC
212# login I/O recovery method.
213#
214# 0 = No support. Flush active I/O's for all FCP target devices at link down.
215# 1 = Partial support. Flush I/O's for non-FCP2 target devices at link down.
216# 2 = Full support. Hold active I/O's for all devices at link down.
217#
218# Range:  Min:0  Max:2  Default:1
219#
220adisc-support=1;
221
222
223# pm-support:  Enable/Disable power management support in the driver.
224#
225# 0 = Disables power management support in the driver.
226# 1 = Enables power management support in the driver.
227#
228# Range:  Min:0  Max:1  Default:0
229#
230pm-support=0;
231
232
233# num-nodes:  Number of fibre channel nodes (NPorts) the driver will support.
234#
235# 0 = Indicates auto detect limit of adapter.
236#
237# Range:  Min:0  Max:4096  Default:0
238#
239num-nodes=0;
240
241
242# pci-max-read:  Sets the PCI-X max memory read byte count on the adapter.
243#
244# This value controls the adapter's max PCI-X memory read count.
245# On Sunfire x4100/4200 systems this parameter must be changed to
246# 1024 bytes.  Currently, this parameter should only be modified on
247# Sunfire x4100/4200 systems due to the unique nature of the PCI-X bus
248# on these systems, otherwise it should be left as default.
249#
250# Options:  512, 1024, 2048, 4096
251#
252# Range:  Min:512  Max:4096  Default:2048
253#
254# *Uncomment this parameter for Sunfire x4100/4200 systems only
255#pci-max-read=1024;
256
257
258# linkup-delay:  Sets the linkup delay period (seconds) after initialization.
259#
260# This value controls how long the driver waits for the Fibre Channel
261# link to come up after an adapter reset before continuing normal operation.
262#
263# Range:  Min:0  Max:60  Default:10
264#
265linkup-delay=10;
266
267
268# enable-npiv:  Enables NPIV support in the driver.
269#
270# Requires SLI3 mode support in the adapter firmware.
271#
272# Range:  Min:0  Max:1  Default:0
273#
274enable-npiv=0;
275
276
277# vport-restrict-login:  Restricts login to virtual ports to conserve resources.
278#
279# Requires SLI3 mode support in the adapter firmware.
280# Requires enable-npiv parameter to be set to 1.
281#
282# Range:  Min:0  Max:1  Default:1
283#
284vport-restrict-login=1;
285
286
287# enable-auth:  Enables DHCHAP support in the driver.
288#
289# Range:  Min:0  Max:1  Default:0
290#
291enable-auth=0;
292
293
294# target-mode:  Controls COMSTAR target mode support for an adapter port.
295#
296# 0 = Disables target mode support. Enables  initiator mode support.
297# 1 = Enables  target mode support. Disables initiator mode support.
298#
299# Usage examples:
300#     target-mode=1;          Sets global default for target mode
301#     emlxs0-target-mode=0;   emlxs0 will be an initiator port
302#     emlxs1-target-mode=1;   emlxs1 will be a target port
303#
304# Range:  Min:0  Max:1  Default:0
305#
306target-mode=0;
307
308
309# ddi-forceattach:  Force driver attach during system boot.
310#
311# 0 = Disables forced driver attach during system boot. (Default)
312# 1 = Enables forced driver attach during system boot.
313#
314# This parameter is required if you enable target-mode.
315# If target mode is enabled the emlxs driver MUST be force attached
316# at system boot to ensure remote initiators will be able to
317# discover it.
318#
319# Range:  Min:0  Max:1  Default:0
320#
321# *Uncomment this parameter when target-mode is enabled
322#ddi-forceattach=1
323
324
325# fct-bufpool:  Controls buffer pool used by COMSTAR for FCP IOs
326#               This should ONLY be used if target-mode is enabled
327#
328#    Each entry consists of "Size:Count" where:
329#    Size is the decimal size, in bytes, of this buffer pool
330#    Count is the decimal number of buffers of this corresponding size
331#    There can be at most 16 different types of entries
332#
333#    The default behavior for a target port is
334#    fct-bufpool="512:256",
335#                "8192:128",
336#                "65536:64",
337#                "131072:64";
338#
339# Usage examples:
340#     fct-bufpool          Sets global default for buffer pool
341#     emlxs0-fct-bufpool   Sets buffer pool for emlxs0
342#     emlxs1-fct-bufpool   Sets buffer pool for emlxs1
343#
344
345
346# fct-queue-depth:  Controls the queue depth for a COMSTAR target port
347#                   This should ONLY be used if target-mode is enabled
348#
349#    By default, the max number of simultaneous IOs a target port can handle
350#    is equal to the HBA throttle. The HBA throttle varies by adapter model
351#    but usually represents approximately 2000 simultaneous IOs.  With this
352#    parameter, the user can limit the number of simultaneous IOs to a
353#    smaller value.
354#
355# Usage examples:
356#     fct-queue-depth=256;          Sets global default for a target port queue
357#                                   depth to 256 IOs.
358#     emlxs0-fct-queue-depth=256;   emlxs0 will limit its target queue depth to
359#                                   256 IOs
360#
361
362
363# ddi-forceload:  Allows the firmware module to be loaded early enough in the
364#                 boot to be available for the emlxs root instance to use.
365#                 This value should not be modified by the user.
366#
367ddi-forceload = "misc/emlxs/emlxs_fw";
368