glm(7D)                                                               Devices                                                              glm(7D)

NAME

       glm - GLM SCSI Host Bus Adapter Driver

SYNOPSIS

       scsi@unit-address

DESCRIPTION

       The  glm Host Bus Adapter driver is a SCSA compliant nexus driver that supports the LSI 53c810,  LSI 53c875, LSI 53c876, LSI 53C896 and LSI
       53C1010 SCSI chips

       It supports the standard functions provided by the SCSA interface. That is, it supports tagged and untagged queuing, Narrow/Wide/Fast/Ultra
       SCSI/Ultra SCSI 2/Ultra SCSI 3, and auto request sense, but it does not support linked commands.

   Driver Configuration
       Configure the glm driver by defining properties in glm.conf. These properties override the global SCSI settings. glm supports these proper-
       ties which can be modified by the user: scsi-options, target<n>-scsi-options, scsi-reset-delay, scsi-tag-age-limit, scsi-watchdog-tick, and
       scsi-initiator-id.

       target<n>-scsi-options  overrides  the   scsi-options  property  value for target<n>. <n> can vary from decimal 0 to 15. glm supports these
       scsi-options:   SCSI_OPTIONS_DR,   SCSI_OPTIONS_SYNC,   SCSI_OPTIONS_TAG,   SCSI_OPTIONS_FAST,   SCSI_OPTIONS_WIDE,    SCSI_OPTIONS_FAST20,
       SCSI_OPTIONS_FAST40 and SCSI_OPTIONS_FAST80.

       After periodic interval scsi-watchdog-tick, the glm driver searches through all current and disconnected commands for timeouts.

       scsi-tag-age-limit is the number of times that the glm driver attempts to allocate a particular tag ID that is currently in use after going
       through all tag IDs in a circular fashion. After finding the same tag ID in use scsi-tag-age-limit times, no more commands will be  submit-
       ted to this target until all outstanding commands complete or timeout.

       Refer to scsi_hba_attach(9F).

EXAMPLES

       Example 1: Using the glm Configuration File

       Create a file called  /kernel/drv/glm.conf and add the following line:

       scsi-options=0x78;

       This disables tagged queuing, Fast/Ultra SCSI and wide mode for all glm instances.

       The following example disables an option for one specific glm (refer to driver.conf(4) and pci(4) for more details):

       name="glm" parent="/pci@1f,4000"
            unit-address="3"
            target1-scsi-options=0x58
            scsi-options=0x178 scsi-initiator-id=6;

       Note  that  the  default initiator ID in OBP is 7 and that the change to ID 6 will occur at attach time. It may be preferable to change the
       initiator ID in OBP.

       The example above sets scsi-options for target 1 to 0x58 and all other targets on this SCSI bus to 0x178.

       The physical pathname of the parent can be determined using the /devices tree or following the link of the logical device name:

        # ls -l /dev/rdsk/c0t0d0s0
        lrwxrwxrwx  1 root   root      45 May 16 10:08 /dev/rdsk/c0t0d0s0 ->
            ../../devices/pci@1f,4000/scsi@3/sd@0,0:a,raw

       In this case, like the example above, the parent is /pci@1f,4000 and the unit-address is the number bound to the scsi@3 node.

       To set scsi-options more specifically per target:

       target1-scsi-options=0x78;
       device-type-scsi-options-list =
            "SEAGATE ST32550W", "seagate-scsi-options" ;
       seagate-scsi-options = 0x58;
       scsi-options=0x3f8;

       The above sets scsi-options for target 1 to 0x78 and for all other targets on this SCSI bus to 0x3f8 except  for  one  specific  disk  type
       which will have   scsi-options set to 0x58.

       scsi-options  specified  per target ID have the highest precedence, followed by scsi-options per device type. Global  scsi-options (for all
       glm instances) per bus have the lowest precedence.

       The system needs to be rebooted before the specified scsi-options take effect.

   Driver Capabilities
       The target driver needs to set capabilities in the  glm driver in order to enable some driver features.  The target driver can   query  and
       modify  these capabilities:  synchronous, tagged-qing, wide-xfer, auto-rqsense, qfull-retries, qfull-retry-interval. All other capabilities
       can only be queried.

       By default, tagged-qing, auto-rqsense, and wide-xfer capabilities are  disabled,  while  disconnect,  synchronous,  and  untagged-qing  are
       enabled.  These  capabilities  can  only  have  binary values (0 or 1). The default value for qfull-retries is 10 and the default value for
       qfull-retry-interval is 100. The qfull-retries capability is a uchar_t  (0  to  255)  while  qfull-retry-interval  is  a   ushort_t  (0  to
       65535).

       The  target driver needs to enable tagged-qing and wide-xfer explicitly.  The untagged-qing capability is always enabled and its value can-
       not be modified.

       Whenever there is a conflict between the value of scsi-options and a capability, the value set in scsi-options prevails. Only whom != 0  is
       supported in the scsi_ifsetcap(9F) call.

       Refer to scsi_ifsetcap(9F) and  scsi_ifgetcap(9F) for details.

FILES

       /kernel/drv/glm         ELF Kernel Module

       /kernel/drv/glm.conf    Optional configuration file

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +------------------------+----------------------------------+
       |ATTRIBUTE TYPE          |         ATTRIBUTE VALUE          |
       +------------------------+----------------------------------+
       |Architecture            |Limited to PCI-based systems with |
       |                        |LSI  53c810,   LSI  53c875,   LSI |
       |                        |53c876,   LSI  53c896   and   LSI |
       |                        |53c1010   SCSI I/O processors     |
       +------------------------+----------------------------------+

SEE ALSO

       prtconf(1M),  driver.conf(4),   pci(4),   attributes(5),   scsi_abort(9F),   scsi_hba_attach(9F),   scsi_ifgetcap(9F),   scsi_ifsetcap(9F),
       scsi_reset(9F), scsi_sync_pkt(9F), scsi_transport(9F), scsi_device(9S), scsi_extended_sense(9S), scsi_inquiry(9S), scsi_pkt(9S)

       Writing Device Drivers

       ANSI Small Computer System Interface-2 (SCSI-2),

       LSI Logi Inc (formerly Symbios Logic Inc.):

         o
            SYM53c810 PCI-SCSI I/O processor with Narrow operation

         o  SYM53c875 PCI-SCSI  I/O  Processor With Fast-20

         o  SYM53c876 PCI-SCSI I/O processor Dual channel Fast-20

         o  SYM53c896 PCI-SCSI I/O processor Dual channel Fast-40

         o  SYM53c1010 PCI-SCSI I/O processor Dual Channel Fast-80

DIAGNOSTICS

       The messages described below are some that may appear on the system console, as well as being logged.

       Device is using a hilevel intr

           The device was configured with an interrupt level that cannot be used with this glm driver.  Check the PCI device.

       map setup failed

           Driver was unable to map device registers; check for bad hardware. Driver did not attach to device; SCSI devices will be inaccessible.

       glm_script_alloc failed

           The driver was unable to load the SCRIPTS for the SCSI processor, check for bad hardware. Driver did not attach to device; SCSI devices
           will be inaccessible.

       cannot map configuration space.

           The driver was unable to map in the configuration registers. Check for bad hardware. SCSI devices will be inaccessible.

       attach failed

           The driver was unable to attach; usually preceded by another warning that indicates why attach failed.  These can be  considered  hard-
           ware failures.

       SCSI bus DATA IN phase parity error

           The driver detected parity errors on the SCSI bus.

       SCSI bus MESSAGE IN phase parity error

           The driver detected parity errors on the SCSI bus.

       SCSI bus STATUS phase parity error

           The driver detected parity errors on the SCSI bus.

       Unexpected bus free

           Target disconnected from the bus without notice. Check for bad hardware.

       Disconnected command timeout for Target <id>.<lun>

           A  timeout  occurred  while target id/lun was disconnected. This is usually a target firmware problem.  For tagged queuing targets, <n>
           commands were outstanding when the timeout was detected.

       Disconnected tagged cmd(s) (<n>) timeout for Target<id>.<lun>

           A timeout occurred while target id/lun was disconnected. This is usually a target firmware problem. For  tagged  queuing  targets,  <n>
           commands were outstanding when the timeout was detected.

       Connected command timeout for Target <id>.<lun>

           This is usually a SCSI bus problem. Check cables and termination.

       Target <id> reducing sync. transfer rate

           A  data  transfer  hang  or DATA-IN phase parity error was detected. The driver attempts to eliminate this problem by reducing the data
           transfer rate.

       Target <id> reverting to async. mode

           A second data transfer hang was detected for this target. The driver attempts to eliminate this problem by reducing the  data  transfer
           rate.

       Target <id> disabled wide SCSI mode

           A second data phase hang was detected for this target. The driver attempts to eliminate this problem by disabling wide SCSI mode.

       auto request sense failed

           An attempt to start an auto request packet failed. Another auto request packet may already be in transport.

       invalid reselection (<id>.<lun>)

           A reselection failed; target accepted abort or reset, but still tries to reconnect. Check for bad hardware.

       invalid intcode

           The SCRIPTS processor generated an invalid SCRIPTS interrupt. Check for bad hardware.

NOTES

       The glm driver supports the following LSI chips:

         o  LSI 53C810, which supports Narrow, Fast SCSI mode. The maximum SCSI bandwidth is 10 MB/sec.

         o
            LSI 53C875, which supports Wide, Fast, and Ultra SCSI mode.  The maximum SCSI bandwidth is 40 MB/sec.

         o  LSI 53C896, which supports Wide, Fast and Ultra SCSI 2 mode.  The maximum LVD SCSI bandwidth is 80 MB/sec.

         o  LSI 53c1010, which supports wide, Fast and Ultra SCSI 3 mode.  The maximum LVD SCSI bandwidth is 160 MB/sec.

       The glm driver exports properties indicating per target the negotiated transfer speed (target<n>-sync-speed), whether wide bus is supported
       (target<n>-wide), for that particular target (target<n>-scsi-options), and whether tagged queuing  has  been  enabled  (target<n>-TQ).  The
       sync-speed  property  value  is the data transfer rate in KB/sec. The target<n>-TQ and the target<n>-wide property have value 1 to indicate
       that the corresponding capability is enabled, or 0 to indicate that the capability is disabled for that target. Refer to prtconf(1M)  (ver-
       bose option) for viewing the glm properties.

       scsi, instance #0
           Driver properties:
               name <target6-TQ> length <4>
                   value <0x00000000>.
               name <target6-wide> length <4>
                   value <0x00000000>.
               name <target6-sync-speed> length <4>
                   value <0x00002710>.
               name <target1-TQ> length <4>
                   value <0x00000001>.
               name <target1-wide> length <4>
                   value <0x00000000>.
               name <target1-sync-speed> length <4>
                   value <0x00002710>.
               name <target0-TQ> length <4>
                   value <0x00000001>.
               name <target0-wide> length <4>
                   value <0x00000001>.
               name <target0-sync-speed> length <4>
                   value <0x00009c40>.
               name <scsi-options> length <4>
                   value <0x000007f8>.
               name <scsi-watchdog-tick> length <4>
                   value <0x0000000a>.
               name <scsi-tag-age-limit> length <4>
                   value <0x00000002>.
               name <scsi-reset-delay> length <4>
                   value <0x00000bb8>.
               name <latency-timer> length <4>
                   value <0x00000088>.
               name <cache-line-size> length <4>
                   value <0x00000010>.

SunOS 5.10                                                          20 Jul 2001                                                            glm(7D)