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