drivers/scsi/README.BusLogic

   1            BusLogic MultiMaster and FlashPoint SCSI Driver for Linux
   2
   3                          Version 2.0.15 for Linux 2.0
   4                          Version 2.1.15 for Linux 2.1
   5
   6                               PRODUCTION RELEASE
   7
   8                                 17 August 1998
   9
  10                                Leonard N. Zubkoff
  11                                Dandelion Digital
  12                                lnz@dandelion.com
  13
  14          Copyright 1995-1998 by Leonard N. Zubkoff <lnz@dandelion.com>
  15
  16
  17                                  INTRODUCTION
  18
  19 BusLogic, Inc. designed and manufactured a variety of high performance SCSI
  20 host adapters which share a common programming interface across a diverse
  21 collection of bus architectures by virtue of their MultiMaster ASIC technology.
  22 BusLogic was acquired by Mylex Corporation in February 1996, but the products
  23 supported by this driver originated under the BusLogic name and so that name is
  24 retained in the source code and documentation.
  25
  26 This driver supports all present BusLogic MultiMaster Host Adapters, and should
  27 support any future MultiMaster designs with little or no modification.  More
  28 recently, BusLogic introduced the FlashPoint Host Adapters, which are less
  29 costly and rely on the host CPU, rather than including an onboard processor.
  30 Despite not having an onboard CPU, the FlashPoint Host Adapters perform very
  31 well and have very low command latency.  BusLogic has recently provided me with
  32 the FlashPoint Driver Developer's Kit, which comprises documentation and freely
  33 redistributable source code for the FlashPoint SCCB Manager.  The SCCB Manager
  34 is the library of code that runs on the host CPU and performs functions
  35 analogous to the firmware on the MultiMaster Host Adapters.  Thanks to their
  36 having provided the SCCB Manager, this driver now supports the FlashPoint Host
  37 Adapters as well.
  38
  39 My primary goals in writing this completely new BusLogic driver for Linux are
  40 to achieve the full performance that BusLogic SCSI Host Adapters and modern
  41 SCSI peripherals are capable of, and to provide a highly robust driver that can
  42 be depended upon for high performance mission critical applications.  All of
  43 the major performance and error recovery features can be configured from the
  44 Linux kernel command line or at module initialization time, allowing individual
  45 installations to tune driver performance and error recovery to their particular
  46 needs.
  47
  48 The latest information on Linux support for BusLogic SCSI Host Adapters, as
  49 well as the most recent release of this driver and the latest firmware for the
  50 BT-948/958/958D, will always be available from my Linux Home Page at URL
  51 "http://www.dandelion.com/Linux/".
  52
  53 Bug reports should be sent via electronic mail to "lnz@dandelion.com".  Please
  54 include with the bug report the complete configuration messages reported by the
  55 driver and SCSI subsystem at startup, along with any subsequent system messages
  56 relevant to SCSI operations, and a detailed description of your system's
  57 hardware configuration.
  58
  59 Mylex has been an excellent company to work with and I highly recommend their
  60 products to the Linux community.  In November 1995, I was offered the
  61 opportunity to become a beta test site for their latest MultiMaster product,
  62 the BT-948 PCI Ultra SCSI Host Adapter, and then again for the BT-958 PCI Wide
  63 Ultra SCSI Host Adapter in January 1996.  This was mutually beneficial since
  64 Mylex received a degree and kind of testing that their own testing group cannot
  65 readily achieve, and the Linux community has available high performance host
  66 adapters that have been well tested with Linux even before being brought to
  67 market.  This relationship has also given me the opportunity to interact
  68 directly with their technical staff, to understand more about the internal
  69 workings of their products, and in turn to educate them about the needs and
  70 potential of the Linux community.
  71
  72 More recently, Mylex has reaffirmed the company's interest in supporting the
  73 Linux community, and I am now working on a Linux driver for the DAC960 PCI RAID
  74 Controllers.  Mylex's interest and support is greatly appreciated.
  75
  76 Unlike some other vendors, if you contact Mylex Technical Support with a
  77 problem and are running Linux, they will not tell you that your use of their
  78 products is unsupported.  Their latest product marketing literature even states
  79 "Mylex SCSI host adapters are compatible with all major operating systems
  80 including: ... Linux ...".
  81
  82 Mylex Corporation is located at 34551 Ardenwood Blvd., Fremont, California
  83 94555, USA and can be reached at 510/796-6100 or on the World Wide Web at
  84 http://www.mylex.com.  Mylex HBA Technical Support can be reached by electronic
  85 mail at techsup@mylex.com, by Voice at 510/608-2400, or by FAX at 510/745-7715.
  86 Contact information for offices in Europe and Japan is available on the Web
  87 site.
  88
  89
  90                                 DRIVER FEATURES
  91
  92 o Configuration Reporting and Testing
  93
  94   During system initialization, the driver reports extensively on the host
  95   adapter hardware configuration, including the synchronous transfer parameters
  96   requested and negotiated with each target device.  AutoSCSI settings for
  97   Synchronous Negotiation, Wide Negotiation, and Disconnect/Reconnect are
  98   reported for each target device, as well as the status of Tagged Queuing and
  99   Error Recovery.  If the same setting is in effect for all target devices,
 100   then a single word or phrase is used; otherwise, a letter is provided for
 101   each target device to indicate the individual status.  The following examples
 102   should clarify this reporting format:
 103
 104     Synchronous Negotiation: Ultra
 105
 106       Synchronous negotiation is enabled for all target devices and the host
 107       adapter will attempt to negotiate for 20.0 mega-transfers/second.
 108
 109     Synchronous Negotiation: Fast
 110
 111       Synchronous negotiation is enabled for all target devices and the host
 112       adapter will attempt to negotiate for 10.0 mega-transfers/second.
 113
 114     Synchronous Negotiation: Slow
 115
 116       Synchronous negotiation is enabled for all target devices and the host
 117       adapter will attempt to negotiate for 5.0 mega-transfers/second.
 118
 119     Synchronous Negotiation: Disabled
 120
 121       Synchronous negotiation is disabled and all target devices are limited to
 122       asynchronous operation.
 123
 124     Synchronous Negotiation: UFSNUUU#UUUUUUUU
 125
 126       Synchronous negotiation to Ultra speed is enabled for target devices 0
 127       and 4 through 15, to Fast speed for target device 1, to Slow speed for
 128       target device 2, and is not permitted to target device 3.  The host
 129       adapter's SCSI ID is represented by the "#".
 130
 131     The status of Wide Negotiation, Disconnect/Reconnect, and Tagged Queuing
 132     are reported as "Enabled", Disabled", or a sequence of "Y" and "N" letters.
 133
 134     The Error Recovery option is reported as "Default", "Hard Reset",
 135     "Bus Device Reset", "None" or a sequence of "D", "H", "B", and "N" letters.
 136
 137 o Performance Features
 138
 139   BusLogic SCSI Host Adapters directly implement SCSI-2 Tagged Queuing, and so
 140   support has been included in the driver to utilize tagged queuing with any
 141   target devices that report having the tagged queuing capability.  Tagged
 142   queuing allows for multiple outstanding commands to be issued to each target
 143   device or logical unit, and can improve I/O performance substantially.  In
 144   addition, BusLogic's Strict Round Robin Mode is used to optimize host adapter
 145   performance, and scatter/gather I/O can support as many segments as can be
 146   effectively utilized by the Linux I/O subsystem.  Control over the use of
 147   tagged queuing for each target device as well as individual selection of the
 148   tagged queue depth is available through driver options provided on the kernel
 149   command line or at module initialization time.  By default, the queue depth
 150   is determined automatically based on the host adapter's total queue depth and
 151   the number, type, speed, and capabilities of the target devices found.  In
 152   addition, tagged queuing is automatically disabled whenever the host adapter
 153   firmware version is known not to implement it correctly, or whenever a tagged
 154   queue depth of 1 is selected.  Tagged queuing is also disabled for individual
 155   target devices if disconnect/reconnect is disabled for that device.
 156
 157 o Robustness Features
 158
 159   The driver implements extensive error recovery procedures.  When the higher
 160   level parts of the SCSI subsystem request that a timed out command be reset,
 161   a selection is made between a full host adapter hard reset and SCSI bus reset
 162   versus sending a bus device reset message to the individual target device
 163   based on the recommendation of the SCSI subsystem.  Error recovery strategies
 164   are selectable through driver options individually for each target device,
 165   and also include sending a bus device reset to the specific target device
 166   associated with the command being reset, as well as suppressing error
 167   recovery entirely to avoid perturbing an improperly functioning device.  If
 168   the bus device reset error recovery strategy is selected and sending a bus
 169   device reset does not restore correct operation, the next command that is
 170   reset will force a full host adapter hard reset and SCSI bus reset.  SCSI bus
 171   resets caused by other devices and detected by the host adapter are also
 172   handled by issuing a soft reset to the host adapter and re-initialization.
 173   Finally, if tagged queuing is active and more than one command reset occurs
 174   in a 10 minute interval, or if a command reset occurs within the first 10
 175   minutes of operation, then tagged queuing will be disabled for that target
 176   device.  These error recovery options improve overall system robustness by
 177   preventing individual errant devices from causing the system as a whole to
 178   lock up or crash, and thereby allowing a clean shutdown and restart after the
 179   offending component is removed.
 180
 181 o PCI Configuration Support
 182
 183   On PCI systems running kernels compiled with PCI BIOS support enabled, this
 184   driver will interrogate the PCI configuration space and use the I/O port
 185   addresses assigned by the system BIOS, rather than the ISA compatible I/O
 186   port addresses.  The ISA compatible I/O port address is then disabled by the
 187   driver.  On PCI systems it is also recommended that the AutoSCSI utility be
 188   used to disable the ISA compatible I/O port entirely as it is not necessary.
 189   The ISA compatible I/O port is disabled by default on the BT-948/958/958D.
 190
 191 o /proc File System Support
 192
 193   Copies of the host adapter configuration information together with updated
 194   data transfer and error recovery statistics are available through the
 195   /proc/scsi/BusLogic/<N> interface.
 196
 197 o Shared Interrupts Support
 198
 199   On systems that support shared interrupts, any number of BusLogic Host
 200   Adapters may share the same interrupt request channel.
 201
 202
 203                             SUPPORTED HOST ADAPTERS
 204
 205 The following list comprises the supported BusLogic SCSI Host Adapters as of
 206 the date of this document.  It is recommended that anyone purchasing a BusLogic
 207 Host Adapter not in the following table contact the author beforehand to verify
 208 that it is or will be supported.
 209
 210 FlashPoint Series PCI Host Adapters:
 211
 212 FlashPoint LT (BT-930)  Ultra SCSI-3
 213 FlashPoint LT (BT-930R) Ultra SCSI-3 with RAIDPlus
 214 FlashPoint LT (BT-920)  Ultra SCSI-3 (BT-930 without BIOS)
 215 FlashPoint DL (BT-932)  Dual Channel Ultra SCSI-3
 216 FlashPoint DL (BT-932R) Dual Channel Ultra SCSI-3 with RAIDPlus
 217 FlashPoint LW (BT-950)  Wide Ultra SCSI-3
 218 FlashPoint LW (BT-950R) Wide Ultra SCSI-3 with RAIDPlus
 219 FlashPoint DW (BT-952)  Dual Channel Wide Ultra SCSI-3
 220 FlashPoint DW (BT-952R) Dual Channel Wide Ultra SCSI-3 with RAIDPlus
 221
 222 MultiMaster "W" Series Host Adapters:
 223
 224 BT-948      PCI         Ultra SCSI-3
 225 BT-958      PCI         Wide Ultra SCSI-3
 226 BT-958D     PCI         Wide Differential Ultra SCSI-3
 227
 228 MultiMaster "C" Series Host Adapters:
 229
 230 BT-946C     PCI         Fast SCSI-2
 231 BT-956C     PCI         Wide Fast SCSI-2
 232 BT-956CD    PCI         Wide Differential Fast SCSI-2
 233 BT-445C     VLB         Fast SCSI-2
 234 BT-747C     EISA        Fast SCSI-2
 235 BT-757C     EISA        Wide Fast SCSI-2
 236 BT-757CD    EISA        Wide Differential Fast SCSI-2
 237 BT-545C     ISA         Fast SCSI-2
 238 BT-540CF    ISA         Fast SCSI-2
 239
 240 MultiMaster "S" Series Host Adapters:
 241
 242 BT-445S     VLB         Fast SCSI-2
 243 BT-747S     EISA        Fast SCSI-2
 244 BT-747D     EISA        Differential Fast SCSI-2
 245 BT-757S     EISA        Wide Fast SCSI-2
 246 BT-757D     EISA        Wide Differential Fast SCSI-2
 247 BT-545S     ISA         Fast SCSI-2
 248 BT-542D     ISA         Differential Fast SCSI-2
 249 BT-742A     EISA        SCSI-2 (742A revision H)
 250 BT-542B     ISA         SCSI-2 (542B revision H)
 251
 252 MultiMaster "A" Series Host Adapters:
 253
 254 BT-742A     EISA        SCSI-2 (742A revisions A - G)
 255 BT-542B     ISA         SCSI-2 (542B revisions A - G)
 256
 257 AMI FastDisk Host Adapters that are true BusLogic MultiMaster clones are also
 258 supported by this driver.
 259
 260 BusLogic SCSI Host Adapters are available packaged both as bare boards and as
 261 retail kits.  The BT- model numbers above refer to the bare board packaging.
 262 The retail kit model numbers are found by replacing BT- with KT- in the above
 263 list.  The retail kit includes the bare board and manual as well as cabling and
 264 driver media and documentation that are not provided with bare boards.
 265
 266
 267                          FLASHPOINT INSTALLATION NOTES
 268
 269 o RAIDPlus Support
 270
 271   FlashPoint Host Adapters now include RAIDPlus, Mylex's bootable software
 272   RAID.  RAIDPlus is not supported on Linux, and there are no plans to support
 273   it.  The MD driver in Linux 2.0 provides for concatenation (LINEAR) and
 274   striping (RAID-0), and support for mirroring (RAID-1), fixed parity (RAID-4),
 275   and distributed parity (RAID-5) is available separately.  The built-in Linux
 276   RAID support is generally more flexible and is expected to perform better
 277   than RAIDPlus, so there is little impetus to include RAIDPlus support in the
 278   BusLogic driver.
 279
 280 o Enabling UltraSCSI Transfers
 281
 282   FlashPoint Host Adapters ship with their configuration set to "Factory
 283   Default" settings that are conservative and do not allow for UltraSCSI speed
 284   to be negotiated.  This results in fewer problems when these host adapters
 285   are installed in systems with cabling or termination that is not sufficient
 286   for UltraSCSI operation, or where existing SCSI devices do not properly
 287   respond to synchronous transfer negotiation for UltraSCSI speed.  AutoSCSI
 288   may be used to load "Optimum Performance" settings which allow UltraSCSI
 289   speed to be negotiated with all devices, or UltraSCSI speed can be enabled on
 290   an individual basis.  It is recommended that SCAM be manually disabled after
 291   the "Optimum Performance" settings are loaded.
 292
 293
 294                       BT-948/958/958D INSTALLATION NOTES
 295
 296 The BT-948/958/958D PCI Ultra SCSI Host Adapters have some features which may
 297 require attention in some circumstances when installing Linux.
 298
 299 o PCI I/O Port Assignments
 300
 301   When configured to factory default settings, the BT-948/958/958D will only
 302   recognize the PCI I/O port assignments made by the motherboard's PCI BIOS.
 303   The BT-948/958/958D will not respond to any of the ISA compatible I/O ports
 304   that previous BusLogic SCSI Host Adapters respond to.  This driver supports
 305   the PCI I/O port assignments, so this is the preferred configuration.
 306   However, if the obsolete BusLogic driver must be used for any reason, such as
 307   a Linux distribution that does not yet use this driver in its boot kernel,
 308   BusLogic has provided an AutoSCSI configuration option to enable a legacy ISA
 309   compatible I/O port.
 310
 311   To enable this backward compatibility option, invoke the AutoSCSI utility via
 312   Ctrl-B at system startup and select "Adapter Configuration", "View/Modify
 313   Configuration", and then change the "ISA Compatible Port" setting from
 314   "Disable" to "Primary" or "Alternate".  Once this driver has been installed,
 315   the "ISA Compatible Port" option should be set back to "Disable" to avoid
 316   possible future I/O port conflicts.  The older BT-946C/956C/956CD also have
 317   this configuration option, but the factory default setting is "Primary".
 318
 319 o PCI Slot Scanning Order
 320
 321   In systems with multiple BusLogic PCI Host Adapters, the order in which the
 322   PCI slots are scanned may appear reversed with the BT-948/958/958D as
 323   compared to the BT-946C/956C/956CD.  For booting from a SCSI disk to work
 324   correctly, it is necessary that the host adapter's BIOS and the kernel agree
 325   on which disk is the boot device, which requires that they recognize the PCI
 326   host adapters in the same order.  The motherboard's PCI BIOS provides a
 327   standard way of enumerating the PCI host adapters, which is used by the Linux
 328   kernel.  Some PCI BIOS implementations enumerate the PCI slots in order of
 329   increasing bus number and device number, while others do so in the opposite
 330   direction.
 331
 332   Unfortunately, Microsoft decided that Windows 95 would always enumerate the
 333   PCI slots in order of increasing bus number and device number regardless of
 334   the PCI BIOS enumeration, and requires that their scheme be supported by the
 335   host adapter's BIOS to receive Windows 95 certification.  Therefore, the
 336   factory default settings of the BT-948/958/958D enumerate the host adapters
 337   by increasing bus number and device number.  To disable this feature, invoke
 338   the AutoSCSI utility via Ctrl-B at system startup and select "Adapter
 339   Configuration", "View/Modify Configuration", press Ctrl-F10, and then change
 340   the "Use Bus And Device # For PCI Scanning Seq." option to OFF.
 341
 342   This driver will interrogate the setting of the PCI Scanning Sequence option
 343   so as to recognize the host adapters in the same order as they are enumerated
 344   by the host adapter's BIOS.
 345
 346 o Enabling UltraSCSI Transfers
 347
 348   The BT-948/958/958D ship with their configuration set to "Factory Default"
 349   settings that are conservative and do not allow for UltraSCSI speed to be
 350   negotiated.  This results in fewer problems when these host adapters are
 351   installed in systems with cabling or termination that is not sufficient for
 352   UltraSCSI operation, or where existing SCSI devices do not properly respond
 353   to synchronous transfer negotiation for UltraSCSI speed.  AutoSCSI may be
 354   used to load "Optimum Performance" settings which allow UltraSCSI speed to be
 355   negotiated with all devices, or UltraSCSI speed can be enabled on an
 356   individual basis.  It is recommended that SCAM be manually disabled after the
 357   "Optimum Performance" settings are loaded.
 358
 359
 360                                 DRIVER OPTIONS
 361
 362 BusLogic Driver Options may be specified either via the Linux Kernel Command
 363 Line or via the Loadable Kernel Module Installation Facility.  Driver Options
 364 for multiple host adapters may be specified either by separating the option
 365 strings by a semicolon, or by specifying multiple "BusLogic=" strings on the
 366 command line.  Individual option specifications for a single host adapter are
 367 separated by commas.  The Probing and Debugging Options apply to all host
 368 adapters whereas the remaining options apply individually only to the
 369 selected host adapter.
 370
 371 The BusLogic Driver Probing Options comprise the following:
 372
 373 IO:<integer>
 374
 375   The "IO:" option specifies an ISA I/O Address to be probed for a non-PCI
 376   MultiMaster Host Adapter.  If neither "IO:" nor "NoProbeISA" options are
 377   specified, then the standard list of BusLogic MultiMaster ISA I/O Addresses
 378   will be probed (0x330, 0x334, 0x230, 0x234, 0x130, and 0x134).  Multiple
 379   "IO:" options may be specified to precisely determine the I/O Addresses to
 380   be probed, but the probe order will always follow the standard list.
 381
 382 NoProbe
 383
 384   The "NoProbe" option disables all probing and therefore no BusLogic Host
 385   Adapters will be detected.
 386
 387 NoProbeISA
 388
 389   The "NoProbeISA" option disables probing of the standard BusLogic ISA I/O
 390   Addresses and therefore only PCI MultiMaster and FlashPoint Host Adapters
 391   will be detected.
 392
 393 NoProbePCI
 394
 395   The "NoProbePCI" options disables the interrogation of PCI Configuration
 396   Space and therefore only ISA Multimaster Host Adapters will be detected, as
 397   well as PCI Multimaster Host Adapters that have their ISA Compatible I/O
 398   Port set to "Primary" or "Alternate".
 399
 400 NoSortPCI
 401
 402   The "NoSortPCI" option forces PCI MultiMaster Host Adapters to be
 403   enumerated in the order provided by the PCI BIOS, ignoring any setting of
 404   the AutoSCSI "Use Bus And Device # For PCI Scanning Seq." option.
 405
 406 MultiMasterFirst
 407
 408   The "MultiMasterFirst" option forces MultiMaster Host Adapters to be probed
 409   before FlashPoint Host Adapters.  By default, if both FlashPoint and PCI
 410   MultiMaster Host Adapters are present, this driver will probe for
 411   FlashPoint Host Adapters first unless the BIOS primary disk is controlled
 412   by the first PCI MultiMaster Host Adapter, in which case MultiMaster Host
 413   Adapters will be probed first.
 414
 415 FlashPointFirst
 416
 417   The "FlashPointFirst" option forces FlashPoint Host Adapters to be probed
 418   before MultiMaster Host Adapters.
 419
 420 The BusLogic Driver Tagged Queuing Options allow for explicitly specifying
 421 the Queue Depth and whether Tagged Queuing is permitted for each Target
 422 Device (assuming that the Target Device supports Tagged Queuing).  The Queue
 423 Depth is the number of SCSI Commands that are allowed to be concurrently
 424 presented for execution (either to the Host Adapter or Target Device).  Note
 425 that explicitly enabling Tagged Queuing may lead to problems; the option to
 426 enable or disable Tagged Queuing is provided primarily to allow disabling
 427 Tagged Queuing on Target Devices that do not implement it correctly.  The
 428 following options are available:
 429
 430 QueueDepth:<integer>
 431
 432   The "QueueDepth:" or QD:" option specifies the Queue Depth to use for all
 433   Target Devices that support Tagged Queuing, as well as the maximum Queue
 434   Depth for devices that do not support Tagged Queuing.  If no Queue Depth
 435   option is provided, the Queue Depth will be determined automatically based
 436   on the Host Adapter's Total Queue Depth and the number, type, speed, and
 437   capabilities of the detected Target Devices.  For Host Adapters that
 438   require ISA Bounce Buffers, the Queue Depth is automatically set by default
 439   to BusLogic_TaggedQueueDepthBB or BusLogic_UntaggedQueueDepthBB to avoid
 440   excessive preallocation of DMA Bounce Buffer memory.  Target Devices that
 441   do not support Tagged Queuing always have their Queue Depth set to
 442   BusLogic_UntaggedQueueDepth or BusLogic_UntaggedQueueDepthBB, unless a
 443   lower Queue Depth option is provided.  A Queue Depth of 1 automatically
 444   disables Tagged Queuing.
 445
 446 QueueDepth:[<integer>,<integer>...]
 447
 448   The "QueueDepth:[...]" or "QD:[...]" option specifies the Queue Depth
 449   individually for each Target Device.  If an <integer> is omitted, the
 450   associated Target Device will have its Queue Depth selected automatically.
 451
 452 TaggedQueuing:Default
 453
 454   The "TaggedQueuing:Default" or "TQ:Default" option permits Tagged Queuing
 455   based on the firmware version of the BusLogic Host Adapter and based on
 456   whether the Queue Depth allows queuing multiple commands.
 457
 458 TaggedQueuing:Enable
 459
 460   The "TaggedQueuing:Enable" or "TQ:Enable" option enables Tagged Queuing for
 461   all Target Devices on this Host Adapter, overriding any limitation that
 462   would otherwise be imposed based on the Host Adapter firmware version.
 463
 464 TaggedQueuing:Disable
 465
 466   The "TaggedQueuing:Disable" or "TQ:Disable" option disables Tagged Queuing
 467   for all Target Devices on this Host Adapter.
 468
 469 TaggedQueuing:<Target-Spec>
 470
 471   The "TaggedQueuing:<Target-Spec>" or "TQ:<Target-Spec>" option controls
 472   Tagged Queuing individually for each Target Device.  <Target-Spec> is a
 473   sequence of "Y", "N", and "X" characters.  "Y" enables Tagged Queuing, "N"
 474   disables Tagged Queuing, and "X" accepts the default based on the firmware
 475   version.  The first character refers to Target Device 0, the second to
 476   Target Device 1, and so on; if the sequence of "Y", "N", and "X" characters
 477   does not cover all the Target Devices, unspecified characters are assumed
 478   to be "X".
 479
 480 The BusLogic Driver Error Recovery Option allows for explicitly specifying
 481 the Error Recovery action to be performed when BusLogic_ResetCommand is
 482 called due to a SCSI Command failing to complete successfully.  The following
 483 options are available:
 484
 485 ErrorRecovery:Default
 486
 487   The "ErrorRecovery:Default" or "ER:Default" option selects between the Hard
 488   Reset and Bus Device Reset options based on the recommendation of the SCSI
 489   Subsystem.
 490
 491 ErrorRecovery:HardReset
 492
 493   The "ErrorRecovery:HardReset" or "ER:HardReset" option will initiate a Host
 494   Adapter Hard Reset which also causes a SCSI Bus Reset.
 495
 496 ErrorRecovery:BusDeviceReset
 497
 498   The "ErrorRecovery:BusDeviceReset" or "ER:BusDeviceReset" option will send
 499   a Bus Device Reset message to the individual Target Device causing the
 500   error.  If Error Recovery is again initiated for this Target Device and no
 501   SCSI Command to this Target Device has completed successfully since the Bus
 502   Device Reset message was sent, then a Hard Reset will be attempted.
 503
 504 ErrorRecovery:None
 505
 506   The "ErrorRecovery:None" or "ER:None" option suppresses Error Recovery.
 507   This option should only be selected if a SCSI Bus Reset or Bus Device Reset
 508   will cause the Target Device or a critical operation to suffer a complete
 509   and unrecoverable failure.
 510
 511 ErrorRecovery:<Target-Spec>
 512
 513   The "ErrorRecovery:<Target-Spec>" or "ER:<Target-Spec>" option controls
 514   Error Recovery individually for each Target Device.  <Target-Spec> is a
 515   sequence of "D", "H", "B", and "N" characters.  "D" selects Default, "H"
 516   selects Hard Reset, "B" selects Bus Device Reset, and "N" selects None.
 517   The first character refers to Target Device 0, the second to Target Device
 518   1, and so on; if the sequence of "D", "H", "B", and "N" characters does not
 519   cover all the possible Target Devices, unspecified characters are assumed
 520   to be "D".
 521
 522 The BusLogic Driver Miscellaneous Options comprise the following:
 523
 524 BusSettleTime:<seconds>
 525
 526   The "BusSettleTime:" or "BST:" option specifies the Bus Settle Time in
 527   seconds.  The Bus Settle Time is the amount of time to wait between a Host
 528   Adapter Hard Reset which initiates a SCSI Bus Reset and issuing any SCSI
 529   Commands.  If unspecified, it defaults to BusLogic_DefaultBusSettleTime.
 530
 531 InhibitTargetInquiry
 532
 533   The "InhibitTargetInquiry" option inhibits the execution of an Inquire
 534   Target Devices or Inquire Installed Devices command on MultiMaster Host
 535   Adapters.  This may be necessary with some older Target Devices that do not
 536   respond correctly when Logical Units above 0 are addressed.
 537
 538 The BusLogic Driver Debugging Options comprise the following:
 539
 540 TraceProbe
 541
 542   The "TraceProbe" option enables tracing of Host Adapter Probing.
 543
 544 TraceHardwareReset
 545
 546   The "TraceHardwareReset" option enables tracing of Host Adapter Hardware
 547   Reset.
 548
 549 TraceConfiguration
 550
 551   The "TraceConfiguration" option enables tracing of Host Adapter
 552   Configuration.
 553
 554 TraceErrors
 555
 556   The "TraceErrors" option enables tracing of SCSI Commands that return an
 557   error from the Target Device.  The CDB and Sense Data will be printed for
 558   each SCSI Command that fails.
 559
 560 Debug
 561
 562   The "Debug" option enables all debugging options.
 563
 564 The following examples demonstrate setting the Queue Depth for Target Devices
 565 1 and 2 on the first host adapter to 7 and 15, the Queue Depth for all Target
 566 Devices on the second host adapter to 31, and the Bus Settle Time on the
 567 second host adapter to 30 seconds.
 568
 569 Linux Kernel Command Line:
 570
 571   linux BusLogic=QueueDepth:[,7,15];QueueDepth:31,BusSettleTime:30
 572
 573 LILO Linux Boot Loader (in /etc/lilo.conf):
 574
 575   append = "BusLogic=QueueDepth:[,7,15];QueueDepth:31,BusSettleTime:30"
 576
 577 INSMOD Loadable Kernel Module Installation Facility:
 578
 579   insmod BusLogic.o \
 580       'BusLogic_Options="QueueDepth:[,7,15];QueueDepth:31,BusSettleTime:30"'
 581
 582 NOTE: Module Utilities 2.1.71 or later is required for correct parsing
 583       of driver options containing commas.
 584
 585
 586                               DRIVER INSTALLATION
 587
 588 This distribution was prepared for Linux kernel version 2.0.35, but should be
 589 compatible with 2.0.4 or any later 2.0 series kernel.
 590
 591 To install the new BusLogic SCSI driver, you may use the following commands,
 592 replacing "/usr/src" with wherever you keep your Linux kernel source tree:
 593
 594   cd /usr/src
 595   tar -xvzf BusLogic-2.0.15.tar.gz
 596   mv README.* LICENSE.* BusLogic.[ch] FlashPoint.c linux/drivers/scsi
 597   patch -p0 < BusLogic.patch (only for 2.0.33 and below)
 598   cd linux
 599   make config
 600   make depend
 601   make zImage
 602
 603 Then install "arch/i386/boot/zImage" as your standard kernel, run lilo if
 604 appropriate, and reboot.
 605
 606
 607                       BUSLOGIC ANNOUNCEMENTS MAILING LIST
 608
 609 The BusLogic Announcements Mailing List provides a forum for informing Linux
 610 users of new driver releases and other announcements regarding Linux support
 611 for BusLogic SCSI Host Adapters.  To join the mailing list, send a message to
 612 "buslogic-announce-request@dandelion.com" with the line "subscribe" in the
 613 message body.