0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 =========================================================
0004 BusLogic MultiMaster and FlashPoint SCSI Driver for Linux
0005 =========================================================
0006
0007 Version 2.0.15 for Linux 2.0
0008
0009 Version 2.1.15 for Linux 2.1
0010
0011 PRODUCTION RELEASE
0012
0013 17 August 1998
0014
0015 Leonard N. Zubkoff
0016
0017 Dandelion Digital
0018
0019 lnz@dandelion.com
0020
0021 Copyright 1995-1998 by Leonard N. Zubkoff <lnz@dandelion.com>
0022
0023
0024 Introduction
0025 ============
0026
0027 BusLogic, Inc. designed and manufactured a variety of high performance SCSI
0028 host adapters which share a common programming interface across a diverse
0029 collection of bus architectures by virtue of their MultiMaster ASIC technology.
0030 BusLogic was acquired by Mylex Corporation in February 1996, but the products
0031 supported by this driver originated under the BusLogic name and so that name is
0032 retained in the source code and documentation.
0033
0034 This driver supports all present BusLogic MultiMaster Host Adapters, and should
0035 support any future MultiMaster designs with little or no modification. More
0036 recently, BusLogic introduced the FlashPoint Host Adapters, which are less
0037 costly and rely on the host CPU, rather than including an onboard processor.
0038 Despite not having an onboard CPU, the FlashPoint Host Adapters perform very
0039 well and have very low command latency. BusLogic has recently provided me with
0040 the FlashPoint Driver Developer's Kit, which comprises documentation and freely
0041 redistributable source code for the FlashPoint SCCB Manager. The SCCB Manager
0042 is the library of code that runs on the host CPU and performs functions
0043 analogous to the firmware on the MultiMaster Host Adapters. Thanks to their
0044 having provided the SCCB Manager, this driver now supports the FlashPoint Host
0045 Adapters as well.
0046
0047 My primary goals in writing this completely new BusLogic driver for Linux are
0048 to achieve the full performance that BusLogic SCSI Host Adapters and modern
0049 SCSI peripherals are capable of, and to provide a highly robust driver that can
0050 be depended upon for high performance mission critical applications. All of
0051 the major performance features can be configured from the Linux kernel command
0052 line or at module initialization time, allowing individual installations to
0053 tune driver performance and error recovery to their particular needs.
0054
0055 The latest information on Linux support for BusLogic SCSI Host Adapters, as
0056 well as the most recent release of this driver and the latest firmware for the
0057 BT-948/958/958D, will always be available from my Linux Home Page at URL
0058 "http://sourceforge.net/projects/dandelion/".
0059
0060 Bug reports should be sent via electronic mail to "lnz@dandelion.com". Please
0061 include with the bug report the complete configuration messages reported by the
0062 driver and SCSI subsystem at startup, along with any subsequent system messages
0063 relevant to SCSI operations, and a detailed description of your system's
0064 hardware configuration.
0065
0066 Mylex has been an excellent company to work with and I highly recommend their
0067 products to the Linux community. In November 1995, I was offered the
0068 opportunity to become a beta test site for their latest MultiMaster product,
0069 the BT-948 PCI Ultra SCSI Host Adapter, and then again for the BT-958 PCI Wide
0070 Ultra SCSI Host Adapter in January 1996. This was mutually beneficial since
0071 Mylex received a degree and kind of testing that their own testing group cannot
0072 readily achieve, and the Linux community has available high performance host
0073 adapters that have been well tested with Linux even before being brought to
0074 market. This relationship has also given me the opportunity to interact
0075 directly with their technical staff, to understand more about the internal
0076 workings of their products, and in turn to educate them about the needs and
0077 potential of the Linux community.
0078
0079 More recently, Mylex has reaffirmed the company's interest in supporting the
0080 Linux community, and I am now working on a Linux driver for the DAC960 PCI RAID
0081 Controllers. Mylex's interest and support is greatly appreciated.
0082
0083 Unlike some other vendors, if you contact Mylex Technical Support with a
0084 problem and are running Linux, they will not tell you that your use of their
0085 products is unsupported. Their latest product marketing literature even states
0086 "Mylex SCSI host adapters are compatible with all major operating systems
0087 including: ... Linux ...".
0088
0089 Mylex Corporation is located at 34551 Ardenwood Blvd., Fremont, California
0090 94555, USA and can be reached at 510/796-6100 or on the World Wide Web at
0091 http://www.mylex.com. Mylex HBA Technical Support can be reached by electronic
0092 mail at techsup@mylex.com, by Voice at 510/608-2400, or by FAX at 510/745-7715.
0093 Contact information for offices in Europe and Japan is available on the Web
0094 site.
0095
0096
0097 Driver Features
0098 ===============
0099
0100 Configuration Reporting and Testing
0101 -----------------------------------
0102
0103 During system initialization, the driver reports extensively on the host
0104 adapter hardware configuration, including the synchronous transfer parameters
0105 requested and negotiated with each target device. AutoSCSI settings for
0106 Synchronous Negotiation, Wide Negotiation, and Disconnect/Reconnect are
0107 reported for each target device, as well as the status of Tagged Queuing.
0108 If the same setting is in effect for all target devices, then a single word
0109 or phrase is used; otherwise, a letter is provided for each target device to
0110 indicate the individual status. The following examples
0111 should clarify this reporting format:
0112
0113 Synchronous Negotiation: Ultra
0114
0115 Synchronous negotiation is enabled for all target devices and the host
0116 adapter will attempt to negotiate for 20.0 mega-transfers/second.
0117
0118 Synchronous Negotiation: Fast
0119
0120 Synchronous negotiation is enabled for all target devices and the host
0121 adapter will attempt to negotiate for 10.0 mega-transfers/second.
0122
0123 Synchronous Negotiation: Slow
0124
0125 Synchronous negotiation is enabled for all target devices and the host
0126 adapter will attempt to negotiate for 5.0 mega-transfers/second.
0127
0128 Synchronous Negotiation: Disabled
0129
0130 Synchronous negotiation is disabled and all target devices are limited to
0131 asynchronous operation.
0132
0133 Synchronous Negotiation: UFSNUUU#UUUUUUUU
0134
0135 Synchronous negotiation to Ultra speed is enabled for target devices 0
0136 and 4 through 15, to Fast speed for target device 1, to Slow speed for
0137 target device 2, and is not permitted to target device 3. The host
0138 adapter's SCSI ID is represented by the "#".
0139
0140 The status of Wide Negotiation, Disconnect/Reconnect, and Tagged Queuing
0141 are reported as "Enabled", Disabled", or a sequence of "Y" and "N" letters.
0142
0143 Performance Features
0144 --------------------
0145
0146 BusLogic SCSI Host Adapters directly implement SCSI-2 Tagged Queuing, and so
0147 support has been included in the driver to utilize tagged queuing with any
0148 target devices that report having the tagged queuing capability. Tagged
0149 queuing allows for multiple outstanding commands to be issued to each target
0150 device or logical unit, and can improve I/O performance substantially. In
0151 addition, BusLogic's Strict Round Robin Mode is used to optimize host adapter
0152 performance, and scatter/gather I/O can support as many segments as can be
0153 effectively utilized by the Linux I/O subsystem. Control over the use of
0154 tagged queuing for each target device as well as individual selection of the
0155 tagged queue depth is available through driver options provided on the kernel
0156 command line or at module initialization time. By default, the queue depth
0157 is determined automatically based on the host adapter's total queue depth and
0158 the number, type, speed, and capabilities of the target devices found. In
0159 addition, tagged queuing is automatically disabled whenever the host adapter
0160 firmware version is known not to implement it correctly, or whenever a tagged
0161 queue depth of 1 is selected. Tagged queuing is also disabled for individual
0162 target devices if disconnect/reconnect is disabled for that device.
0163
0164 Robustness Features
0165 -------------------
0166
0167 The driver implements extensive error recovery procedures. When the higher
0168 level parts of the SCSI subsystem request that a timed out command be reset,
0169 a selection is made between a full host adapter hard reset and SCSI bus reset
0170 versus sending a bus device reset message to the individual target device
0171 based on the recommendation of the SCSI subsystem. Error recovery strategies
0172 are selectable through driver options individually for each target device,
0173 and also include sending a bus device reset to the specific target device
0174 associated with the command being reset, as well as suppressing error
0175 recovery entirely to avoid perturbing an improperly functioning device. If
0176 the bus device reset error recovery strategy is selected and sending a bus
0177 device reset does not restore correct operation, the next command that is
0178 reset will force a full host adapter hard reset and SCSI bus reset. SCSI bus
0179 resets caused by other devices and detected by the host adapter are also
0180 handled by issuing a soft reset to the host adapter and re-initialization.
0181 Finally, if tagged queuing is active and more than one command reset occurs
0182 in a 10 minute interval, or if a command reset occurs within the first 10
0183 minutes of operation, then tagged queuing will be disabled for that target
0184 device. These error recovery options improve overall system robustness by
0185 preventing individual errant devices from causing the system as a whole to
0186 lock up or crash, and thereby allowing a clean shutdown and restart after the
0187 offending component is removed.
0188
0189 PCI Configuration Support
0190 -------------------------
0191
0192 On PCI systems running kernels compiled with PCI BIOS support enabled, this
0193 driver will interrogate the PCI configuration space and use the I/O port
0194 addresses assigned by the system BIOS, rather than the ISA compatible I/O
0195 port addresses. The ISA compatible I/O port address is then disabled by the
0196 driver. On PCI systems it is also recommended that the AutoSCSI utility be
0197 used to disable the ISA compatible I/O port entirely as it is not necessary.
0198 The ISA compatible I/O port is disabled by default on the BT-948/958/958D.
0199
0200 /proc File System Support
0201 -------------------------
0202
0203 Copies of the host adapter configuration information together with updated
0204 data transfer and error recovery statistics are available through the
0205 /proc/scsi/BusLogic/<N> interface.
0206
0207 Shared Interrupts Support
0208 -------------------------
0209
0210 On systems that support shared interrupts, any number of BusLogic Host
0211 Adapters may share the same interrupt request channel.
0212
0213
0214 Supported Host Adapters
0215 =======================
0216
0217 The following list comprises the supported BusLogic SCSI Host Adapters as of
0218 the date of this document. It is recommended that anyone purchasing a BusLogic
0219 Host Adapter not in the following table contact the author beforehand to verify
0220 that it is or will be supported.
0221
0222 FlashPoint Series PCI Host Adapters:
0223
0224 ======================= =============================================
0225 FlashPoint LT (BT-930) Ultra SCSI-3
0226 FlashPoint LT (BT-930R) Ultra SCSI-3 with RAIDPlus
0227 FlashPoint LT (BT-920) Ultra SCSI-3 (BT-930 without BIOS)
0228 FlashPoint DL (BT-932) Dual Channel Ultra SCSI-3
0229 FlashPoint DL (BT-932R) Dual Channel Ultra SCSI-3 with RAIDPlus
0230 FlashPoint LW (BT-950) Wide Ultra SCSI-3
0231 FlashPoint LW (BT-950R) Wide Ultra SCSI-3 with RAIDPlus
0232 FlashPoint DW (BT-952) Dual Channel Wide Ultra SCSI-3
0233 FlashPoint DW (BT-952R) Dual Channel Wide Ultra SCSI-3 with RAIDPlus
0234 ======================= =============================================
0235
0236 MultiMaster "W" Series Host Adapters:
0237
0238 ======= === ==============================
0239 BT-948 PCI Ultra SCSI-3
0240 BT-958 PCI Wide Ultra SCSI-3
0241 BT-958D PCI Wide Differential Ultra SCSI-3
0242 ======= === ==============================
0243
0244 MultiMaster "C" Series Host Adapters:
0245
0246 ======== ==== ==============================
0247 BT-946C PCI Fast SCSI-2
0248 BT-956C PCI Wide Fast SCSI-2
0249 BT-956CD PCI Wide Differential Fast SCSI-2
0250 BT-445C VLB Fast SCSI-2
0251 BT-747C EISA Fast SCSI-2
0252 BT-757C EISA Wide Fast SCSI-2
0253 BT-757CD EISA Wide Differential Fast SCSI-2
0254 ======== ==== ==============================
0255
0256 MultiMaster "S" Series Host Adapters:
0257
0258 ======= ==== ==============================
0259 BT-445S VLB Fast SCSI-2
0260 BT-747S EISA Fast SCSI-2
0261 BT-747D EISA Differential Fast SCSI-2
0262 BT-757S EISA Wide Fast SCSI-2
0263 BT-757D EISA Wide Differential Fast SCSI-2
0264 BT-742A EISA SCSI-2 (742A revision H)
0265 ======= ==== ==============================
0266
0267 MultiMaster "A" Series Host Adapters:
0268
0269 ======= ==== ==============================
0270 BT-742A EISA SCSI-2 (742A revisions A - G)
0271 ======= ==== ==============================
0272
0273 AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones are also
0274 supported by this driver.
0275
0276 BusLogic SCSI Host Adapters are available packaged both as bare boards and as
0277 retail kits. The BT- model numbers above refer to the bare board packaging.
0278 The retail kit model numbers are found by replacing BT- with KT- in the above
0279 list. The retail kit includes the bare board and manual as well as cabling and
0280 driver media and documentation that are not provided with bare boards.
0281
0282
0283 FlashPoint Installation Notes
0284 =============================
0285
0286 RAIDPlus Support
0287 ----------------
0288
0289 FlashPoint Host Adapters now include RAIDPlus, Mylex's bootable software
0290 RAID. RAIDPlus is not supported on Linux, and there are no plans to support
0291 it. The MD driver in Linux 2.0 provides for concatenation (LINEAR) and
0292 striping (RAID-0), and support for mirroring (RAID-1), fixed parity (RAID-4),
0293 and distributed parity (RAID-5) is available separately. The built-in Linux
0294 RAID support is generally more flexible and is expected to perform better
0295 than RAIDPlus, so there is little impetus to include RAIDPlus support in the
0296 BusLogic driver.
0297
0298 Enabling UltraSCSI Transfers
0299 ----------------------------
0300
0301 FlashPoint Host Adapters ship with their configuration set to "Factory
0302 Default" settings that are conservative and do not allow for UltraSCSI speed
0303 to be negotiated. This results in fewer problems when these host adapters
0304 are installed in systems with cabling or termination that is not sufficient
0305 for UltraSCSI operation, or where existing SCSI devices do not properly
0306 respond to synchronous transfer negotiation for UltraSCSI speed. AutoSCSI
0307 may be used to load "Optimum Performance" settings which allow UltraSCSI
0308 speed to be negotiated with all devices, or UltraSCSI speed can be enabled on
0309 an individual basis. It is recommended that SCAM be manually disabled after
0310 the "Optimum Performance" settings are loaded.
0311
0312
0313 BT-948/958/958D Installation Notes
0314 ==================================
0315
0316 The BT-948/958/958D PCI Ultra SCSI Host Adapters have some features which may
0317 require attention in some circumstances when installing Linux.
0318
0319 PCI I/O Port Assignments
0320 ------------------------
0321
0322 When configured to factory default settings, the BT-948/958/958D will only
0323 recognize the PCI I/O port assignments made by the motherboard's PCI BIOS.
0324 The BT-948/958/958D will not respond to any of the ISA compatible I/O ports
0325 that previous BusLogic SCSI Host Adapters respond to. This driver supports
0326 the PCI I/O port assignments, so this is the preferred configuration.
0327 However, if the obsolete BusLogic driver must be used for any reason, such as
0328 a Linux distribution that does not yet use this driver in its boot kernel,
0329 BusLogic has provided an AutoSCSI configuration option to enable a legacy ISA
0330 compatible I/O port.
0331
0332 To enable this backward compatibility option, invoke the AutoSCSI utility via
0333 Ctrl-B at system startup and select "Adapter Configuration", "View/Modify
0334 Configuration", and then change the "ISA Compatible Port" setting from
0335 "Disable" to "Primary" or "Alternate". Once this driver has been installed,
0336 the "ISA Compatible Port" option should be set back to "Disable" to avoid
0337 possible future I/O port conflicts. The older BT-946C/956C/956CD also have
0338 this configuration option, but the factory default setting is "Primary".
0339
0340 PCI Slot Scanning Order
0341 -----------------------
0342
0343 In systems with multiple BusLogic PCI Host Adapters, the order in which the
0344 PCI slots are scanned may appear reversed with the BT-948/958/958D as
0345 compared to the BT-946C/956C/956CD. For booting from a SCSI disk to work
0346 correctly, it is necessary that the host adapter's BIOS and the kernel agree
0347 on which disk is the boot device, which requires that they recognize the PCI
0348 host adapters in the same order. The motherboard's PCI BIOS provides a
0349 standard way of enumerating the PCI host adapters, which is used by the Linux
0350 kernel. Some PCI BIOS implementations enumerate the PCI slots in order of
0351 increasing bus number and device number, while others do so in the opposite
0352 direction.
0353
0354 Unfortunately, Microsoft decided that Windows 95 would always enumerate the
0355 PCI slots in order of increasing bus number and device number regardless of
0356 the PCI BIOS enumeration, and requires that their scheme be supported by the
0357 host adapter's BIOS to receive Windows 95 certification. Therefore, the
0358 factory default settings of the BT-948/958/958D enumerate the host adapters
0359 by increasing bus number and device number. To disable this feature, invoke
0360 the AutoSCSI utility via Ctrl-B at system startup and select "Adapter
0361 Configuration", "View/Modify Configuration", press Ctrl-F10, and then change
0362 the "Use Bus And Device # For PCI Scanning Seq." option to OFF.
0363
0364 This driver will interrogate the setting of the PCI Scanning Sequence option
0365 so as to recognize the host adapters in the same order as they are enumerated
0366 by the host adapter's BIOS.
0367
0368 Enabling UltraSCSI Transfers
0369 ----------------------------
0370
0371 The BT-948/958/958D ship with their configuration set to "Factory Default"
0372 settings that are conservative and do not allow for UltraSCSI speed to be
0373 negotiated. This results in fewer problems when these host adapters are
0374 installed in systems with cabling or termination that is not sufficient for
0375 UltraSCSI operation, or where existing SCSI devices do not properly respond
0376 to synchronous transfer negotiation for UltraSCSI speed. AutoSCSI may be
0377 used to load "Optimum Performance" settings which allow UltraSCSI speed to be
0378 negotiated with all devices, or UltraSCSI speed can be enabled on an
0379 individual basis. It is recommended that SCAM be manually disabled after the
0380 "Optimum Performance" settings are loaded.
0381
0382
0383 Driver Options
0384 ==============
0385
0386 BusLogic Driver Options may be specified either via the Linux Kernel Command
0387 Line or via the Loadable Kernel Module Installation Facility. Driver Options
0388 for multiple host adapters may be specified either by separating the option
0389 strings by a semicolon, or by specifying multiple "BusLogic=" strings on the
0390 command line. Individual option specifications for a single host adapter are
0391 separated by commas. The Probing and Debugging Options apply to all host
0392 adapters whereas the remaining options apply individually only to the
0393 selected host adapter.
0394
0395 The BusLogic Driver Probing Options comprise the following:
0396
0397 NoProbe
0398
0399 The "NoProbe" option disables all probing and therefore no BusLogic Host
0400 Adapters will be detected.
0401
0402 NoProbePCI
0403
0404 The "NoProbePCI" options disables the interrogation of PCI Configuration
0405 Space and therefore only ISA Multimaster Host Adapters will be detected, as
0406 well as PCI Multimaster Host Adapters that have their ISA Compatible I/O
0407 Port set to "Primary" or "Alternate".
0408
0409 NoSortPCI
0410
0411 The "NoSortPCI" option forces PCI MultiMaster Host Adapters to be
0412 enumerated in the order provided by the PCI BIOS, ignoring any setting of
0413 the AutoSCSI "Use Bus And Device # For PCI Scanning Seq." option.
0414
0415 MultiMasterFirst
0416
0417 The "MultiMasterFirst" option forces MultiMaster Host Adapters to be probed
0418 before FlashPoint Host Adapters. By default, if both FlashPoint and PCI
0419 MultiMaster Host Adapters are present, this driver will probe for
0420 FlashPoint Host Adapters first unless the BIOS primary disk is controlled
0421 by the first PCI MultiMaster Host Adapter, in which case MultiMaster Host
0422 Adapters will be probed first.
0423
0424 FlashPointFirst
0425
0426 The "FlashPointFirst" option forces FlashPoint Host Adapters to be probed
0427 before MultiMaster Host Adapters.
0428
0429 The BusLogic Driver Tagged Queuing Options allow for explicitly specifying
0430 the Queue Depth and whether Tagged Queuing is permitted for each Target
0431 Device (assuming that the Target Device supports Tagged Queuing). The Queue
0432 Depth is the number of SCSI Commands that are allowed to be concurrently
0433 presented for execution (either to the Host Adapter or Target Device). Note
0434 that explicitly enabling Tagged Queuing may lead to problems; the option to
0435 enable or disable Tagged Queuing is provided primarily to allow disabling
0436 Tagged Queuing on Target Devices that do not implement it correctly. The
0437 following options are available:
0438
0439 QueueDepth:<integer>
0440
0441 The "QueueDepth:" or QD:" option specifies the Queue Depth to use for all
0442 Target Devices that support Tagged Queuing, as well as the maximum Queue
0443 Depth for devices that do not support Tagged Queuing. If no Queue Depth
0444 option is provided, the Queue Depth will be determined automatically based
0445 on the Host Adapter's Total Queue Depth and the number, type, speed, and
0446 capabilities of the detected Target Devices. Target Devices that
0447 do not support Tagged Queuing always have their Queue Depth set to
0448 BusLogic_UntaggedQueueDepth or BusLogic_UntaggedQueueDepthBB, unless a
0449 lower Queue Depth option is provided. A Queue Depth of 1 automatically
0450 disables Tagged Queuing.
0451
0452 QueueDepth:[<integer>,<integer>...]
0453
0454 The "QueueDepth:[...]" or "QD:[...]" option specifies the Queue Depth
0455 individually for each Target Device. If an <integer> is omitted, the
0456 associated Target Device will have its Queue Depth selected automatically.
0457
0458 TaggedQueuing:Default
0459
0460 The "TaggedQueuing:Default" or "TQ:Default" option permits Tagged Queuing
0461 based on the firmware version of the BusLogic Host Adapter and based on
0462 whether the Queue Depth allows queuing multiple commands.
0463
0464 TaggedQueuing:Enable
0465
0466 The "TaggedQueuing:Enable" or "TQ:Enable" option enables Tagged Queuing for
0467 all Target Devices on this Host Adapter, overriding any limitation that
0468 would otherwise be imposed based on the Host Adapter firmware version.
0469
0470 TaggedQueuing:Disable
0471
0472 The "TaggedQueuing:Disable" or "TQ:Disable" option disables Tagged Queuing
0473 for all Target Devices on this Host Adapter.
0474
0475 TaggedQueuing:<Target-Spec>
0476
0477 The "TaggedQueuing:<Target-Spec>" or "TQ:<Target-Spec>" option controls
0478 Tagged Queuing individually for each Target Device. <Target-Spec> is a
0479 sequence of "Y", "N", and "X" characters. "Y" enables Tagged Queuing, "N"
0480 disables Tagged Queuing, and "X" accepts the default based on the firmware
0481 version. The first character refers to Target Device 0, the second to
0482 Target Device 1, and so on; if the sequence of "Y", "N", and "X" characters
0483 does not cover all the Target Devices, unspecified characters are assumed
0484 to be "X".
0485
0486 The BusLogic Driver Miscellaneous Options comprise the following:
0487
0488 BusSettleTime:<seconds>
0489
0490 The "BusSettleTime:" or "BST:" option specifies the Bus Settle Time in
0491 seconds. The Bus Settle Time is the amount of time to wait between a Host
0492 Adapter Hard Reset which initiates a SCSI Bus Reset and issuing any SCSI
0493 Commands. If unspecified, it defaults to BusLogic_DefaultBusSettleTime.
0494
0495 InhibitTargetInquiry
0496
0497 The "InhibitTargetInquiry" option inhibits the execution of an Inquire
0498 Target Devices or Inquire Installed Devices command on MultiMaster Host
0499 Adapters. This may be necessary with some older Target Devices that do not
0500 respond correctly when Logical Units above 0 are addressed.
0501
0502 The BusLogic Driver Debugging Options comprise the following:
0503
0504 TraceProbe
0505
0506 The "TraceProbe" option enables tracing of Host Adapter Probing.
0507
0508 TraceHardwareReset
0509
0510 The "TraceHardwareReset" option enables tracing of Host Adapter Hardware
0511 Reset.
0512
0513 TraceConfiguration
0514
0515 The "TraceConfiguration" option enables tracing of Host Adapter
0516 Configuration.
0517
0518 TraceErrors
0519
0520 The "TraceErrors" option enables tracing of SCSI Commands that return an
0521 error from the Target Device. The CDB and Sense Data will be printed for
0522 each SCSI Command that fails.
0523
0524 Debug
0525
0526 The "Debug" option enables all debugging options.
0527
0528 The following examples demonstrate setting the Queue Depth for Target Devices
0529 1 and 2 on the first host adapter to 7 and 15, the Queue Depth for all Target
0530 Devices on the second host adapter to 31, and the Bus Settle Time on the
0531 second host adapter to 30 seconds.
0532
0533 Linux Kernel Command Line::
0534
0535 linux BusLogic=QueueDepth:[,7,15];QueueDepth:31,BusSettleTime:30
0536
0537 LILO Linux Boot Loader (in /etc/lilo.conf)::
0538
0539 append = "BusLogic=QueueDepth:[,7,15];QueueDepth:31,BusSettleTime:30"
0540
0541 INSMOD Loadable Kernel Module Installation Facility::
0542
0543 insmod BusLogic.o \
0544 'BusLogic="QueueDepth:[,7,15];QueueDepth:31,BusSettleTime:30"'
0545
0546
0547 .. Note::
0548
0549 Module Utilities 2.1.71 or later is required for correct parsing
0550 of driver options containing commas.
0551
0552
0553 Driver Installation
0554 ===================
0555
0556 This distribution was prepared for Linux kernel version 2.0.35, but should be
0557 compatible with 2.0.4 or any later 2.0 series kernel.
0558
0559 To install the new BusLogic SCSI driver, you may use the following commands,
0560 replacing "/usr/src" with wherever you keep your Linux kernel source tree::
0561
0562 cd /usr/src
0563 tar -xvzf BusLogic-2.0.15.tar.gz
0564 mv README.* LICENSE.* BusLogic.[ch] FlashPoint.c linux/drivers/scsi
0565 patch -p0 < BusLogic.patch (only for 2.0.33 and below)
0566 cd linux
0567 make config
0568 make zImage
0569
0570 Then install "arch/x86/boot/zImage" as your standard kernel, run lilo if
0571 appropriate, and reboot.
0572
0573
0574 BusLogic Announcements Mailing List
0575 ===================================
0576
0577 The BusLogic Announcements Mailing List provides a forum for informing Linux
0578 users of new driver releases and other announcements regarding Linux support
0579 for BusLogic SCSI Host Adapters. To join the mailing list, send a message to
0580 "buslogic-announce-request@dandelion.com" with the line "subscribe" in the
0581 message body.
