Devices mpt(7D)
NAME
mpt - SCSI host bus adapter driver
SYNOPSIS
scsi@unit-address
DESCRIPTION
The mpt host bus adapter driver is a SCSA compliant nexus
driver that supports the LSI 53C1030 SCSI, SAS1064, SAS1068and Dell SAS 6i/R controllers.
The mpt driver supports the standard functions provided by
the SCSA interface, including tagged and untagged queuing,Narrow/Wide/Fast/Ultra SCSI/Ultra SCSI 2/Ultra SCSI 3/Ultra
SCSI 4, and auto request sense. The mpt driver does not sup-
port linked commands. The mpt driver also supports SATA and
Serial-Attached SCSI devices when connected to LSI SAS1064
(PCI-X), SAS1068 and Dell SAS 6i/R (PCI-Express) controll-
ers. DRIVER CONFIGURATIONThe mpt driver obtains configuration parameters from the
/kernel/drv/mpt.conf file. These parameters can override
global SCSI settings. The following configurable properties are applicable forparallel SCSI controllers and devices: scsi-options,
target
-scsi-options, scsi-reset-delay, scsi-tag-age- limit, scsi-watchdog-tick, and scsi-initiator-id.
The property target
options property value for target-scsi-options overrides the scsi- , where can vary from decimal 0 to 15 for parallel SCSI operations. The mpt
driver supports the following parallel 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. To view the
numeric values of these options, see /usr/include/sys/scsi/conf/autoconf.h.The scsi-reset-delay and scsi-watchdog-tick properties are
applicable for Serial-Attached SCSI (SAS) controllers and
SAS or SATA devices.SunOS 5.11 Last change: 24 Nov 2008 1
Devices mpt(7D)
After periodic interval scsi-watchdog-tick, the mpt driver
searches through all current and disconnected commands for timeouts.The scsi-tag-age-limit property is ignored by mpt, regard-
less of controller or devices type. Refer toscsi_hba_attach_setup(9F) for more details of parallel SCSI
properties and flags.When supported, multipath-capable storage is attached with
Serial-Attached SCSI or SATA. Solaris I/O Multipathing may
be enabled for mpt instances. This feature is configured
with the mpxio-disable property in the mpt.conf file. To
perform mutipathing tasks, we recommend that you usestmsboot(1M). Specifying mpxio-disable="no" enables the
feature, while specifying mpxio-disable="yes" disables the
feature. Solaris I/O Multipathing may be enabled or disabled
on a per-controller basis. The following example shows how
to disable multipathing on a controller whose parent is/pci@7c0/pci@0/pci@9 and unit-address is 0:
name="mpt" parent="/pci@7c0/pci@0/pci@9" unit-address="0" mpxio-disable="yes";
Currently, mpt supports the mpt_offline_delay property. This
property delays the offlining of a device until the timer has expired. The default value is 20 seconds.mpt supports the mpt-on-bus-time property, which controls a
timer that resets a bus when a bus connection exceeds thetimer value. The default value of mpt-on-bus-time is 15
seconds. A value of 0 disables this feature. The propertycan be configured in /kernel/drv/mpt.conf as mpt-on-bus-
time. In the following example, the timeout is disabled for unit 4 and set to two minutes for unit 4,1:name="mpt" parent="/pci@1d,700000"
unit-address="4"
mpt-on-bus-time=0;
name="mpt" parent="/pci@1d,700000"
unit-address="4,1"
mpt-on-bus-time=120;
Values have the following effect: No property configured: Default, 15 second timeout n = 0: Disables bus timeout feature 0 < n <= 15: Minimum (and default), 15 secondsSunOS 5.11 Last change: 24 Nov 2008 2
Devices mpt(7D)
15 < n <= 3435: The actual value in seconds 3435 < n: Maximum, 3435 secondsEXAMPLES
Example 1 Using the mpt Configuration File
Create a file called /kernel/drv/mpt.conf, then add the fol-
lowing line:scsi-options=0x78;
The above example disables tagged queuing, Fast/Ultra SCSI,
and wide mode for all mpt instances. The property value is
calculated by or-ing the individual SCSI_OPTIONS_xxx values
defined in /usr/include/sys/scsi/conf/autoconf.h. The following example disables an option for one specificparallel SCSI 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 is 7 and that the change to ID 6 occurs at attach time. It may be preferable to change the initiator ID with eeprom(1M).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 byusing the /devices tree or by following the link of the log-
ical device name:# ls -l /dev/rdsk/c0t0d0s0
SunOS 5.11 Last change: 24 Nov 2008 3
Devices mpt(7D)
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 andthe unit-address is 3.
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 exceptionof one specific disk type for which scsi-options is 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 mpt instances) per bus have the lowest
precedence.You must reboot the system for the specified scsi-options to
take effect. SCSI Transport Capabilities SCSI transport capabilities as set by the target driver. The following capabilities can be queried and modified by thetarget driver: synchronous, tagged-qing, wide-xfer, auto-
rqsense, qfull-retries, and qfull-retry-interval. All other
capabilities are query only.By default, tagged-qing, auto-rqsense, and wide-xfer capa-
bilities are disabled, while disconnect, synchronous, anduntagged-qing are enabled. These capabilities can only have
binary values (0 or 1).The default value for qfull-retries
SunOS 5.11 Last change: 24 Nov 2008 4
Devices mpt(7D)
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 supported in the scsi_ifsetcap(9F) call.
Refer to scsi_ifsetcap(9F) and scsi_ifgetcap(9F) for
details. FILES/kernel/drv/mpt 32-bit ELF kernel module
/kernel/drv/sparcv9/mpt 64-bit SPARC ELF kernel module
/kernel/drv/amd64/mpt 64-bit x86 ELF kernel module
/kernel/drv/mpt.conf Optional configuration file
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
bute:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| ____________________________|_____________________________|_
| Architecture | x86, SPARC (Limited to sys-|
| | tems with LSI Fusion family|| | SCSI I/O processors). |
|_____________________________|_____________________________|
SEE ALSO
eeprom(1M), prtconf(1M), stmsboot(1M), driver.conf(4),pci(4), attributes(5), scsi_vhci(7D), scsi_abort(9F),
scsi_hba_attach_setup(9F), scsi_ifgetcap(9F),
scsi_ifsetcap(9F), scsi_reset(9F), scsi_sync_pkt(9F),
scsi_transport(9F), scsi_device(9S),
SunOS 5.11 Last change: 24 Nov 2008 5
Devices mpt(7D)
scsi_extended_sense(9S), scsi_inquiry(9S), scsi_pkt(9S)
Writing Device DriversANSI Small Computer System Interface-2 (SCSI-2) (and later
revisions).ANSI Serial-Attached SCSI-2 (SAS2)
SYM53c1030 PCI-SCSI I/O processor Dual Channel Fast-160 -
LSI Logic Inc.LSISASI1064 PCI-X to 4-port 3 Gb/s SAS Controller - LSI
Logic Inc.LSISASI1068/E 4-Port PCI Express to 3 Gb/s SAS Controller -
LSI Logic Inc. Sun StorEdge Traffic Manager Installation and Configuration Guide DIAGNOSTICS 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 thatcannot be used with this mtp driver. Check the PCI dev-
ice. Map setup failed The driver was unable to map device registers; check forbad hardware. Driver did not attach to device; SCSI dev-
ices are inaccessible. Cannot map configuration spaceThe driver was unable to map in the configuration regis-
ters. Check for bad hardware. SCSI devices will be inac-
cessible.SunOS 5.11 Last change: 24 Nov 2008 6
Devices mpt(7D)
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. 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. Targetreverting 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. Targetdisabled 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. NOTESThe mpt driver supports the parallel SCSI LSI 53c1030 con-
troller. The LSI 53c1030 controller series supports Wide, Fast and Ultra SCSI 4 mode. The maximum LVD SCSI bandwidth is 320 MB/sec.The mpt driver exports properties indicating the negotiated
transfer speed per target (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
value indicates the data transfer rate in KB/sec. The-TQ). The sync-speed property target
(to indicate that the corresponding capability is enabled for that target), or 0 (to indicate that the capability is disabled for that target). See prtconf(1M) (verbose option)-TQ and the target -wide property have value 1 for details on viewing the mpt properties.
SunOS 5.11 Last change: 24 Nov 2008 7
Devices mpt(7D)
scsi, instance #4
Driver properties:name='target8-TQ' type=int items=1 dev=none
value=00000001name='target8-wide' type=int items=1 dev=none
value=00000001name='target8-sync-speed' type=int items=1 dev=none
value=00013880name='target5-TQ' type=int items=1 dev=none
value=00000001name='target5-wide' type=int items=1 dev=none
value=00000001name='target5-sync-speed' type=int items=1 dev=none
value=00013880name='target4-TQ' type=int items=1 dev=none
value=00000001name='target4-wide' type=int items=1 dev=none
value=00000001name='target4-sync-speed' type=int items=1 dev=none
value=00013880name='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=000000faname='scsi-options' type=int items=1 dev=(238,0)
value=00103ff8name='scsi-watchdog-tick' type=int items=1 dev=(238,0)
value=0000000aname='scsi-tag-age-limit' type=int items=1 dev=(238,0)
value=00000002name='scsi-reset-delay' type=int items=1 dev=(238,0)
value=00000bb8SunOS 5.11 Last change: 24 Nov 2008 8