mpt(7D) 																   mpt(7D)

NAME

       mpt - SCSI host bus adapter driver

SYNOPSIS

       scsi@unit-address

       The mpt host bus adapter driver is a SCSA compliant nexus driver that supports the LSI 53C1030 SCSI and SAS1064 chips.

       The  mpt  driver  supports  the	standard  functions  provided  by  the	SCSA  interface,  including  tagged  and  untagged  queuing,  Nar-
       row/Wide/Fast/Ultra SCSI/Ultra SCSI 2/Ultra SCSI 3/Ultra SCSI 4, and auto request sense. The mpt driver does not support linked commands.

DRIVER CONFIGURATION

       You configure the mpt driver by defining properties in mpt.conf. These properties override the global SCSI settings. The  mpt  driver  sup-
       ports  these  modifiable  properties:  scsi-options,  target<n>-scsi-options, scsi-reset-delay, scsi-tag-age-limit, scsi-watchdog-tick, and
       scsi-initiator-id.

       The property target<n>-scsi-options overrides the scsi-options property value for target<n>, where <n> can vary from decimal 0 to  15.  The
       mpt driver supports the following SCSI options: SCSI_OPTIONS_DR, SCSI_OPTIONS_SYNC, SCSI_OPTIONS_TAG, SCSI_OPTIONS_FAST, SCSI_OPTIONS_WIDE,
       SCSI_OPTIONS_FAST20, SCSI_OPTIONS_FAST40, SCSI_OPTIONS_FAST80, SCSI_OPTIONS_FAST160, and SCSI_OPTIONS_QAS.

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

       The scsi-tag-age-limit property represents the number of times that the mpt driver attempts to allocate a tag ID that is currently  in  use
       after going through all tag IDs in a circular fashion.  When encountering the same tag ID used scsi-tag-age-limit times, no additional com-
       mands are submitted to the target until all outstanding commands complete or timeout.

       Refer to scsi_hba_attach(9F) for details.

       Example 1: Example 1: Using the mpt Configuration File

       Create a file called /kernel/drv/mpt.conf, then add the following line:

       scsi-options=0x78;

       The above example disables tagged queuing, Fast/Ultra SCSI, and wide mode for all mpt instances.

       The following example disables an option for one specific mpt device. See driver.conf(4) and pci(4) for more details.

	name="mpt" 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 occurs at attach time. It may be preferable to change  the  ini-
       tiator ID in OBP.

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

       You can determine the physical path name of the parent by using the /devices tree or by 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

       As in the previous example, 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, do the following:

       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. All other targets on the SCSI bus are set to 0x3f8 (with the exception of one specific
       disk type for which scsi-options is 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
       mpt instances) per bus have the lowest precedence.

       You must reboot the system for the specified scsi-options to take effect.

   Driver Capabilities
       To  enable  some  driver features, the target driver must set capabilities in the mpt driver. The following capabilities can be queried and
       modified by the target driver: synchronous, tagged-qing, wide-xfer, auto-rqsense, qfull-retries, and qfull-retry-interval. All other  capa-
       bilities are query only.

       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, while  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 must enable tagged-qing and wide-xfer explicitly. The	untagged-qing capability is always enabled and its value cannot be
       modified.

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

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

       /kernel/drv/mpt	       32-bit ELF kernel module

       /kernel/drv/sparcv9/mpt 64-bit SPARC ELF kernel module

       /kernel/drv/amd64/mpt   64-bit  ELF kernel module

       /kernel/drv/mpt.conf    optional configuration file

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Architecture		     |, SPARC (see below)	   |
       +-----------------------------+-----------------------------+

       This driver is limited to systems with LSI Fusion family SCSI I/O processors.

       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)

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

       SYM53c1030 PCI-SCSI I/O processor Dual Channel Fast-160 -- LSI Logic Inc.

       The messages described below are logged and may also appear on the system console.

       Device is using a hilevel intr

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

       Map setup failed

	   The driver was unable to map device registers; check for bad hardware. Driver did not attach to device; SCSI devices are 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 hardware
	   failures.

       Connected command timeout for Target <id>.

	   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.

       The mpt driver supports LSI 53c1030 chips. The LSI 53c1030 chip series support Wide, Fast and Ultra SCSI 4 mode. The maximum LVD SCSI band-
       width is 320 MB/sec.

       The mpt driver exports properties indicating the negotiated transfer speed per target (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 indicates 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 for that target), or 0 (to indicate that the capability is disabled for that target). See prt-
       conf(1M) (verbose option) for details on viewing the mpt properties.

       scsi, instance #4
	   Driver properties:
	       name='target8-TQ' type=int items=1 dev=none
		   value=00000001
	       name='target8-wide' type=int items=1 dev=none
		   value=00000001
	       name='target8-sync-speed' type=int items=1 dev=none
		   value=00013880
	       name='target5-TQ' type=int items=1 dev=none
		   value=00000001
	       name='target5-wide' type=int items=1 dev=none
		   value=00000001
	       name='target5-sync-speed' type=int items=1 dev=none
		   value=00013880
	       name='target4-TQ' type=int items=1 dev=none
		   value=00000001
	       name='target4-wide' type=int items=1 dev=none
		   value=00000001
	       name='target4-sync-speed' type=int items=1 dev=none
		   value=00013880
	       name='pm-components' type=string items=3 dev=none
		   value='NAME=mpt4' + '0=Off (PCI D3 State)' + '3=On (PCI 
		   D0 State)'
	       name='scsi-selection-timeout' type=int items=1 dev=(238,0)
		   value=000000fa
	       name='scsi-options' type=int items=1 dev=(238,0)
		   value=00103ff8
	       name='scsi-watchdog-tick' type=int items=1 dev=(238,0)
		   value=0000000a
	       name='scsi-tag-age-limit' type=int items=1 dev=(238,0)
		   value=00000002
	       name='scsi-reset-delay' type=int items=1 dev=(238,0)
		   value=00000bb8

								   2 April 2005 							   mpt(7D)