1 '\" te
   2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   4 .\" or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add
   5 .\" the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH MPT_SAS3 7D "Jun 2, 2014"
   7 .SH NAME
   8 mpt_sas3 \- SAS-3 host bus adapter driver
   9 .SH SYNOPSIS
  10 .sp
  11 .in +2
  12 .nf
  13 scsi@unit-address
  14 .fi
  15 .in -2
  16 
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The \fBmpt_sas3\fR host bus adapter driver is a nexus driver that supports the
  21 LSI SAS300x/3108 series of chips. These chips support SAS/SATA interfaces,
  22 including tagged and untagged queuing, multiple MSI-X interrupts, LSI
  23 fastpath and SATA 3G/6G/12G.
  24 .SS "Configuration"
  25 .sp
  26 .LP
  27 The \fBmpt_sas3\fR driver is configured by defining properties in
  28 \fBmpt_sas3.conf\fR. These properties override the global SCSI settings. The
  29 \fBmpt_sas3\fR driver supports one modifiable property:
  30 .sp
  31 .ne 2
  32 .na
  33 \fB\fBmpxio-disable\fR\fR
  34 .ad
  35 .sp .6
  36 .RS 4n
  37 Solaris I/O multipathing is enabled or disabled on SAS devices with the
  38 \fBmpxio-disable\fR property. Specifying \fBmpxio-disable="no"\fR activates I/O
  39 multipathing, while \fBmpxio-disable="yes"\fR disables I/O multipathing.
  40 .sp
  41 Solaris I/O multipathing can be enabled or disabled on a per port basis. Per
  42 port settings override the global setting for the specified ports.
  43 .sp
  44 The following example shows how to disable multipathing on port 0 whose parent
  45 is \fB/pci@0,0/pci8086,2940@1c/pci1000,90@0\fR:
  46 .sp
  47 .in +2
  48 .nf
  49 name="mpt_sas3"    parent="/pci@0,0/pci8086,2940@1c/pci1000,90@0"
  50 mpxio-disable="yes";
  51 .fi
  52 .in -2
  53 
  54 The \fBmpt_sas3\fR host bus adapter driver is also capable of driving older
  55 SAS2 controllers cards such as 2008 - 2308. Replacing the older mpt_sas driver
  56 with mpt_sas3 will automatically enhance the performance where the card
  57 is capable.
  58 
  59 .RE
  60 
  61 .SH EXAMPLES
  62 .LP
  63 \fBExample 1 \fRUsing the \fBmpt_sas3\fR Configuration File to Disable MPXIO
  64 .sp
  65 .LP
  66 Create a file called \fB/kernel/drv/mpt_sas3.conf\fR and add the following line:
  67 
  68 .sp
  69 .in +2
  70 .nf
  71 name="mpt_sas3"    parent="/pci@0,0/pci8086,2940@1c/pci1000,90@0"
  72 mpxio-disable="yes";
  73 .fi
  74 .in -2
  75 
  76 .SH FILES
  77 .sp
  78 .ne 2
  79 .na
  80 \fB\fB/kernel/drv/mpt_sas3\fR\fR
  81 .ad
  82 .sp .6
  83 .RS 4n
  84 32-bit ELF kernel module
  85 .RE
  86 
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fB/kernel/drv/sparcv9/mpt_sas3\fR\fR
  91 .ad
  92 .sp .6
  93 .RS 4n
  94 64-bit SPARC ELF kernel module
  95 .RE
  96 
  97 .sp
  98 .ne 2
  99 .na
 100 \fB\fB/kernel/drv/amd64/mpt_sas3\fR\fR
 101 .ad
 102 .sp .6
 103 .RS 4n
 104 64-bit x86 ELF kernel module
 105 .RE
 106 
 107 .sp
 108 .ne 2
 109 .na
 110 \fB\fB/kernel/drv/mpt_sas3.conf\fR\fR
 111 .ad
 112 .sp .6
 113 .RS 4n
 114 Optional configuration file
 115 .RE
 116 
 117 .SH ATTRIBUTES
 118 .sp
 119 .LP
 120 See \fBattributes\fR(5) for a description of the following attributes:
 121 .sp
 122 
 123 .sp
 124 .TS
 125 box;
 126 l | l
 127 l | l .
 128 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 129 _
 130 Architecture    SPARC, x86
 131 .TE
 132 
 133 .SH SEE ALSO
 134 .sp
 135 .LP
 136 \fBprtconf\fR(1M), \fBdriver.conf\fR(4), \fBpci\fR(4), \fBattributes\fR(5),
 137 \fBscsi_abort\fR(9F), \fBscsi_device\fR(9S), \fBscsi_extended_sense\fR(9S),
 138 \fBscsi_inquiry\fR(9S), \fBscsi_hba_attach_setup\fR(9F), \fBupdate_drv\fR(1M),
 139 \fBscsi_ifgetcap\fR(9F), \fBscsi_ifsetcap\fR(9F), \fBscsi_pkt\fR(9S),
 140 \fBscsi_reset\fR(9F), \fBscsi_sync_pkt\fR(9F), \fBscsi_transport\fR(9F),