Manual Pages for UNIX Operating System command usage for man glm

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 sup-
     ports these properties which can be modified  by  the  user:
     scsi-options,    target-scsi-options,   scsi-reset-delay,
     scsi-tag-age-limit, scsi-watchdog-tick, and  scsi-initiator-
     id.


     target-scsi-options overrides the  scsi-options  property
     value  for target.  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 circu-
     lar  fashion. After finding the same tag ID in use scsi-tag-
     age-limit times, no more commands will be submitted to  this
     target until all outstanding commands complete or timeout.


     Refer to scsi_hba_attach(9F).

EXAMPLES




SunOS 5.11          Last change: 15 Nov 2005                    1






Devices                                                   glm(7D)



     Example 1 Using the glm Configuration File


     Create a file called  /kernel/drv/glm.conf and add the  fol-
     lowing 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 prefer-
     able 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 dev-
     ice 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.



SunOS 5.11          Last change: 15 Nov 2005                    2






Devices                                                   glm(7D)



     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  pre-
     cedence,  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:   synchro-
     nous,  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  capa-
     bilities  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 cannot be modified.





SunOS 5.11          Last change: 15 Nov 2005                    3






Devices                                                   glm(7D)



     Whenever there is a conflict  between  the  value  of  scsi-
     options and a capability, the value set in scsi-options pre-
     vails. 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            32-bit ELF kernel module (x86).


     /kernel/drv/amd64/glm      64-bit ELF kernel module (x86).


     /kernel/drv/sparcv9/glm    64-bit ELF kernel module (SPARC).


     /kernel/drv/glm.conf       Optional configuration file


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |     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),





SunOS 5.11          Last change: 15 Nov 2005                    4






Devices                                                   glm(7D)



     LSI Logi Inc (formerly Symbios Logic Inc.):

         o    SYM53c810 PCI-SCSI I/O processor with Narrow opera-
              tion

         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 dev-
         ice.


     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 regis-
         ters. Check for bad hardware. SCSI devices will be inac-
         cessible.


     attach failed

         The driver was unable to  attach;  usually  preceded  by
         another  warning that indicates why attach failed. These



SunOS 5.11          Last change: 15 Nov 2005                    5






Devices                                                   glm(7D)



         can be considered hardware 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 .

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


     Disconnected tagged cmd(s) () timeout for Target
     .

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


     Connected command timeout for Target .

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


     Target  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.



SunOS 5.11          Last change: 15 Nov 2005                    6






Devices                                                   glm(7D)



     Target  reverting to async. mode

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


     Target  disabled wide SCSI mode

         A second data phase hang was detected for  this  target.
         The  driver  attempts to eliminate this problem by disa-
         bling 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 (.)

         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 x4422a card uses an OBP (forth) firmware and is incompa-
     tible  with x86 BIOS. As a result, the x4422a cannot be used
     as a boot device on x86.


     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



SunOS 5.11          Last change: 15 Nov 2005                    7






Devices                                                   glm(7D)



              MB/sec.


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

       scsi, instance #0
           Driver properties:
               name  length <4>
                   value <0x00000000>.
               name  length <4>
                   value <0x00000000>.
               name  length <4>
                   value <0x00002710>.
               name  length <4>
                   value <0x00000001>.
               name  length <4>
                   value <0x00000000>.
               name  length <4>
                   value <0x00002710>.
               name  length <4>
                   value <0x00000001>.
               name  length <4>
                   value <0x00000001>.
               name  length <4>
                   value <0x00009c40>.
               name  length <4>
                   value <0x000007f8>.
               name  length <4>
                   value <0x0000000a>.
               name  length <4>
                   value <0x00000002>.
               name  length <4>
                   value <0x00000bb8>.
               name  length <4>
                   value <0x00000088>.
               name  length <4>
                   value <0x00000010>.








SunOS 5.11          Last change: 15 Nov 2005                    8