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
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
|
'\" te
.\" Copyright (c) 1997, 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 SF 7D "Mar 27, 1997"
.SH NAME
sf \- SOC+ FC-AL FCP Driver
.SH SYNOPSIS
.LP
.nf
sf@\fIport\fR,0
.fi
.SH DESCRIPTION
.sp
.LP
The \fBsf\fR driver is a SCSA compliant nexus driver which supports the Fibre
Channel Protocol for SCSI on Private Fibre Channel Arbitrated loops. An SBus
card called the \fBSOC+\fR card (see \fBsocal\fR(7D)) connects the Fibre
Channel loop to the host system.
.sp
.LP
The \fBsf\fR driver interfaces with the \fBSOC+\fR device driver,
\fBsocal\fR(7D), the SCSI disk target driver, \fBssd\fR(7D), and the SCSI-3
Enclosure Services driver, \fBses\fR(7D). It only supports SCSI devices of
type disk and ses.
.sp
.LP
The \fBsf\fR driver supports the standard functions provided by the SCSA
interface. The driver supports auto request sense and tagged queueing by
default.
.sp
.LP
The driver requires that all devices have unique hard addresses defined by
switch settings in hardware. Devices with conflicting hard addresses will not
be accessible.
.SH FILES
.sp
.ne 2
.na
\fB/platform/\fIarchitecture\fR/kernel/drv/sf\fR
.ad
.sp .6
.RS 4n
ELF kernel module
.RE
.sp
.ne 2
.na
\fB/platform/\fIarchitecture\fR/kernel/drv/sf.conf\fR
.ad
.sp .6
.RS 4n
\fBsf\fR driver configuration file
.RE
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
_
Architecture SPARC
.TE
.SH SEE ALSO
.sp
.LP
\fBluxadm\fR(1M), \fBprtconf\fR(1M), \fBdriver.conf\fR(4), \fBsocal\fR(7D),
\fBssd\fR(7D)
.sp
.LP
\fIWriting Device Drivers\fR
.sp
.LP
\fIANSI X3.272-1996, Fibre Channel Arbitrated Loop (FC-AL)\fR
.sp
.LP
\fIANSI X3.269-1996, Fibre Channel Protocol for SCSI (FCP)\fR
.sp
.LP
\fIANSI X3.270-1996, SCSI-3 Architecture Model (SAM)\fR
.sp
.LP
\fIFibre Channel Private Loop SCSI Direct Attach (FC-PLDA)\fR
.SH DIAGNOSTICS
.sp
.LP
In addition to being logged, the messages below may display on the system
console.
.sp
.LP
The first set of messages indicate that the attachment was unsuccessful, and
will only display while the \fBsf\fR driver is initially attempting to attach.
Each message is preceded by \fBsf\fR\fI%d\fR , where \fI%d\fR is the instance
number of the \fBsf\fR device.
.sp
.ne 2
.na
\fBFailed to alloc soft state\fR
.ad
.sp .6
.RS 4n
Driver was unable to allocate space for the internal state structure. Driver
did not attach to device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBBad soft state\fR
.ad
.sp .6
.RS 4n
Driver requested an invalid internal state structure. Driver did not attach to
device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBFailed to obtain transport handle\fR
.ad
.sp .6
.RS 4n
Driver was unable to obtain a transport handle to communicate with the socal
driver. Driver did not attach to device, SCSI devices will be inaccessible
.RE
.sp
.ne 2
.na
\fBFailed to allocate command/response pool\fR
.ad
.sp .6
.RS 4n
Driver was unable to allocate space for commands and responses. Driver did not
attach to device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBFailed to allocate kmem cache\fR
.ad
.sp .6
.RS 4n
Driver was unable to allocate space for the packet cache. Driver did not attach
to device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBFailed to allocate dma handle for\fR
.ad
.sp .6
.RS 4n
Driver was unable to allocate a dma handle for the loop map. Driver did not
attach to device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBFailed to allocate lilp map\fR
.ad
.sp .6
.RS 4n
Driver was unable to allocate space for the loop map. Driver did not attach to
device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBFailed to bind dma handle for\fR
.ad
.sp .6
.RS 4n
Driver was unable to bind a dma handle for the loop map. Driver did not attach
to device, SCSI devices will be inaccessible.
.RE
.sp
.ne 2
.na
\fBFailed to attach\fR
.ad
.sp .6
.RS 4n
Driver was unable to attach for some reason that may be printed. Driver did
not attach to device, SCSI devices will be inaccessible.
.RE
.sp
.LP
The next set of messages may display at any time. The full device pathname,
followed by the shorter form described above, will precede the message.
.sp
.ne 2
.na
\fBInvalid lilp map\fR
.ad
.sp .6
.RS 4n
The driver did not obtain a valid lilp map from the socal driver. SCSI device
will be inaccessible.
.RE
.sp
.ne 2
.na
\fBTarget t, AL-PA x and hard\fR
.ad
.sp .6
.RS 4n
The device with a switch setting t has an AL-PA x which does not match its hard
address y. The device will not be accessible.
.RE
.sp
.ne 2
.na
\fBDuplicate switch settings\fR
.ad
.sp .6
.RS 4n
The driver detected devices with the same switch setting. All such devices will
be inaccessible.
.RE
.sp
.ne 2
.na
\fBWWN changed on target t\fR
.ad
.sp .6
.RS 4n
The World Wide Name (WWN) has changed on the device with switch setting t.
.RE
.sp
.ne 2
.na
\fBTarget t, unknown device type\fR
.ad
.sp .6
.RS 4n
The driver does not know the device type reported by the device with switch
setting t.
.RE
|
