1 '\" te
   2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
   3 .\" Copyright (c) 2017, Joyent, Inc.
   4 .\" Copyright 2014, Nexenta Systems, Inc. All Rights Reserved
   5 .\" 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
   6 .\" 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
   7 .\" 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]
   8 .TH MPT_SAS 7D "Dec 15, 2017"
   9 .SH NAME
  10 mpt_sas \- SAS-2/3 host bus adapter driver
  11 .SH SYNOPSIS
  12 .in +2
  13 .nf
  14 scsi@unit-address
  15 .fi
  16 .in -2
  17 
  18 .SH DESCRIPTION
  19 .LP
  20 The \fBmpt_sas\fR host bus adapter driver is a nexus driver that supports
  21 Broadcom (formerly LSI and Avago) SAS chipsets including the SAS200x/2x08/2x16
  22 and SAS300x/3x08/3x16/3x24 series of chips. These chips support SAS/SATA
  23 interfaces, including tagged and untagged queuing, SATA 3G/SAS 3G/SAS 6G/SAS
  24 12G.
  25 .SS "Configuration"
  26 .LP
  27 The \fBmpt_sas\fR driver is configured by defining properties in
  28 \fBmpt_sas.conf\fR. These properties override the global SCSI settings. The
  29 \fBmpt_sas\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,72@0\fR:
  46 .sp
  47 .in +2
  48 .nf
  49 name="mpt_sas"    parent="/pci@0,0/pci8086,2940@1c/pci1000,72@0"
  50 mpxio-disable="yes";
  51 .fi
  52 .in -2
  53 
  54 .RE
  55 
  56 .SH EXAMPLES
  57 .LP
  58 \fBExample 1 \fRUsing the \fBmpt_sas\fR Configuration File to Disable MPXIO
  59 .sp
  60 .LP
  61 Create a file called \fB/kernel/drv/mpt_sas.conf\fR and add the following line:
  62 
  63 .sp
  64 .in +2
  65 .nf
  66 name="mpt_sas"    parent="/pci@0,0/pci8086,2940@1c/pci1000,72@0"
  67 mpxio-disable="yes";
  68 .fi
  69 .in -2
  70 
  71 .SH FILES
  72 .ne 2
  73 .na
  74 \fB\fB/kernel/drv/mpt_sas\fR\fR
  75 .ad
  76 .sp .6
  77 .RS 4n
  78 32-bit ELF kernel module
  79 .RE
  80 
  81 .sp
  82 .ne 2
  83 .na
  84 \fB\fB/kernel/drv/sparcv9/mpt_sas\fR\fR
  85 .ad
  86 .sp .6
  87 .RS 4n
  88 64-bit SPARC ELF kernel module
  89 .RE
  90 
  91 .sp
  92 .ne 2
  93 .na
  94 \fB\fB/kernel/drv/amd64/mpt_sas\fR\fR
  95 .ad
  96 .sp .6
  97 .RS 4n
  98 64-bit x86 ELF kernel module
  99 .RE
 100 
 101 .sp
 102 .ne 2
 103 .na
 104 \fB\fB/kernel/drv/mpt_sas.conf\fR\fR
 105 .ad
 106 .sp .6
 107 .RS 4n
 108 Optional configuration file
 109 .RE
 110 
 111 .SH ATTRIBUTES
 112 .LP
 113 See \fBattributes\fR(5) for a description of the following attributes:
 114 .sp
 115 
 116 .sp
 117 .TS
 118 box;
 119 l | l
 120 l | l .
 121 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 122 _
 123 Architecture    SPARC, x86
 124 .TE
 125 
 126 .SH SEE ALSO
 127 .LP
 128 \fBprtconf\fR(1M), \fBdriver.conf\fR(4), \fBpci\fR(4), \fBattributes\fR(5),
 129 \fBscsi_abort\fR(9F), \fBscsi_device\fR(9S), \fBscsi_extended_sense\fR(9S),
 130 \fBscsi_inquiry\fR(9S), \fBscsi_hba_attach_setup\fR(9F),
 131 \fBscsi_ifgetcap\fR(9F), \fBscsi_ifsetcap\fR(9F), \fBscsi_pkt\fR(9S),
 132 \fBscsi_reset\fR(9F), \fBscsi_sync_pkt\fR(9F), \fBscsi_transport\fR(9F),