usr/src/man/man7d/fp.7d

   1 '\" te
   2 .\" Copyright (c) 2008 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.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add 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 FP 7D "Jan 10, 2008"
   7 .SH NAME
   8 fp \- Sun Fibre Channel port driver
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 The \fBfp\fR driver is a Sun fibre channel nexus driver that enables fibre
  13 channel topology discovery, device discovery, fibre channel adapter port
  14 management and other capabilities through well-defined fibre channel adapter
  15 driver interfaces.
  16 .sp
  17 .LP
  18 The \fBfp\fR driver requires the presence of a fabric name server in fabric and
  19 public loop topologies to discover fibre channel devices. In private loop
  20 topologies, the driver discovers devices by performing \fBPLOGI\fR to all valid
  21 \fBAL_PA\fRs, provided that devices do not participate in \fBLIRP\fR and
  22 \fBLILP\fR stages of loop initialization. The \fBfp\fR driver also discovers
  23 devices in N_Port point-to-point topologies.
  24 .SH CONFIGURATION
  25 .sp
  26 .LP
  27 The \fBfp\fR driver is configured by defining  properties in the \fBfp.conf\fR
  28 file. Note that you must reboot the system to have any changes you make to
  29 \fBfp.conf\fR take effect. The \fBfp\fR driver supports the following
  30 properties:
  31 .sp
  32 .ne 2
  33 .na
  34 \fBmpxio-disable\fR
  35 .ad
  36 .sp .6
  37 .RS 4n
  38 Solaris I/O multipathing is enabled or disabled on fibre channel devices with
  39 the mpxio-disable property. Specifying mpxio-disable="no" activates I/O
  40 multipathing, while mpxio-disable="yes" disables the feature. Solaris I/O
  41 multipathing may be enabled or disabled on a per port basis. Per port settings
  42 override the global setting for the specified ports. The following example
  43 shows how to disable multipathing on port 0 whose parent is
  44 /pci@8,600000/SUNW,qlc@4:
  45 .sp
  46 .in +2
  47 .nf
  48 name="fp"    parent="/pci@8,600000/SUNW,qlc@4"    port=0
  49 mpxio-disable="yes";
  50 .fi
  51 .in -2
  52
  53 .RE
  54
  55 .sp
  56 .ne 2
  57 .na
  58 \fBmanual_configuration_only\fR
  59 .ad
  60 .sp .6
  61 .RS 4n
  62 Automatic configuration of SCSI devices in the fabric is enabled by default and
  63 thus allows all devices discovered in the SAN zone to  be enumerated  in the
  64 kernel's device tree automatically. The \fBmanual_configuration_only\fR
  65 property may be configured  to disable the default behavior and force the
  66 manual configuration of the devices in the SAN. Specifying
  67 manual_configuration_only=1 disables the automatic configuration of devices.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fBpwwn-lun-blacklist\fR
  74 .ad
  75 .sp .6
  76 .RS 4n
  77 Allows you to specify target port WWNs and LUN numbers you do not want
  78 configured. LUN numbers are interpreted as decimals. White spaces and commas
  79 (',') can be used in the list of LUN numbers.
  80 .sp
  81 .in +2
  82 .nf
  83      #
  84      # pwwn-lun-blacklist=
  85      # "target-port-wwn,lun-list"
  86      #
  87      # To prevent LUNs 1 and 2 from being configured for target
  88      # port 510000f010fd92a1 and target port 510000e012079df1, set:
  89      #
  90      # pwwn-lun-blacklist=
  91      # "510000f010fd92a1,1,2",
  92      # "510000e012079df1,1,2";
  93      #
  94 .fi
  95 .in -2
  96
  97 .RE
  98
  99 .SH FILES
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fB/kernel/drv/fp\fR\fR
 104 .ad
 105 .RS 26n
 106 32-bit ELF kernel driver (x86)
 107 .RE
 108
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB/kernel/drv/amd64/fp\fR\fR
 113 .ad
 114 .RS 26n
 115 64-bit ELF kernel driver (x86)
 116 .RE
 117
 118 .sp
 119 .ne 2
 120 .na
 121 \fB\fB/kernel/drv/sparcv9/fp\fR\fR
 122 .ad
 123 .RS 26n
 124 64-bit ELF kernel driver (SPARC)
 125 .RE
 126
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB/kernel/drv/fp.conf\fR\fR
 131 .ad
 132 .RS 26n
 133 \fBfp\fR driver configuration file.
 134 .RE
 135
 136 .SH ATTRIBUTES
 137 .sp
 138 .LP
 139 See \fBattributes\fR(5) for descriptions of the following attributes:
 140 .sp
 141
 142 .sp
 143 .TS
 144 box;
 145 c | c
 146 l | l .
 147 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 148 _
 149 mpxio-disable   Uncommitted
 150 _
 151 manual_configuration_only       Obsolete
 152 .TE
 153
 154 .SH SEE ALSO
 155 .sp
 156 .LP
 157 \fBcfgadm_fp\fR(1M), \fBprtconf\fR(1M), \fBstmsboot\fR(1M),
 158 \fBdriver.conf\fR(4), \fBattributes\fR(5), \fBfcp\fR(7D), \fBfctl\fR(7D),
 159 \fBscsi_vhci\fR(7D)
 160 .sp
 161 .LP
 162 \fIWriting Device Drivers\fR
 163 .sp
 164 .LP
 165 \fIFibre Channel Physical and Signaling Interface (FC-PH) ANSI X3.230: 1994\fR
 166 .sp
 167 .LP
 168 \fIFibre Channel Generic Services (FC-GS-2) Project 1134-D\fR
 169 .sp
 170 .LP
 171 \fIFibre Channel Arbitrated Loop (FC-AL) ANSI X3.272-1996\fR
 172 .sp
 173 .LP
 174 \fIFibre Channel Protocol for SCSI (FCP) ANSI X3.269-1996\fR
 175 .sp
 176 .LP
 177 \fISCSI-3 Architecture Model (SAM) Fibre Channel Private Loop SCSI Direct
 178 Attach (FC-PLDA) ANSI X3.270-1996\fR
 179 .sp
 180 .LP
 181 \fISCSI Direct Attach (FC-PLDA) ANSI X3.270-1996\fR
 182 .sp
 183 .LP
 184 \fISCSI Direct Attach (FC-PLDA) NCITS TR-19:1998\fR
 185 .sp
 186 .LP
 187 \fIFabric Loop Attachment (FC-FLA), NCITS TR-20:1998\fR
 188 .SH NOTES
 189 .sp
 190 .LP
 191 In N_Port point-to-point topologies, FCP error recovery does not work across
 192 events such as link bounce/cable pull. I/O to devices with FCP-2/FCP-3 support
 193 (for example, FC tape drives) will be disrupted by such events.