share/man/man7d/sf.7d

   1 '\" te
   2 .\"  Copyright (c) 1997, 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 SF 7D "Mar 27, 1997"
   7 .SH NAME
   8 sf \- SOC+ FC-AL FCP Driver
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 sf@\fIport\fR,0
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The  \fBsf\fR driver is a SCSA compliant nexus driver which supports the Fibre
  19 Channel Protocol for SCSI on Private Fibre Channel Arbitrated loops. An SBus
  20 card called the  \fBSOC+\fR card (see  \fBsocal\fR(7D)) connects the Fibre
  21 Channel loop to the host system.
  22 .sp
  23 .LP
  24 The  \fBsf\fR driver interfaces with the  \fBSOC+\fR device driver,
  25 \fBsocal\fR(7D), the SCSI disk target driver,  \fBssd\fR(7D), and the SCSI-3
  26 Enclosure Services driver,  \fBses\fR(7D). It only supports SCSI devices of
  27 type disk and ses.
  28 .sp
  29 .LP
  30 The  \fBsf\fR driver supports the standard functions provided by the SCSA
  31 interface.  The driver supports auto request sense and tagged queueing by
  32 default.
  33 .sp
  34 .LP
  35 The driver requires that all devices have unique hard addresses defined by
  36 switch settings in hardware.  Devices with conflicting hard addresses will not
  37 be accessible.
  38 .SH FILES
  39 .sp
  40 .ne 2
  41 .na
  42 \fB/platform/\fIarchitecture\fR/kernel/drv/sf\fR
  43 .ad
  44 .sp .6
  45 .RS 4n
  46 ELF kernel module
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB/platform/\fIarchitecture\fR/kernel/drv/sf.conf\fR
  53 .ad
  54 .sp .6
  55 .RS 4n
  56 \fBsf\fR driver configuration file
  57 .RE
  58
  59 .SH ATTRIBUTES
  60 .sp
  61 .LP
  62 See \fBattributes\fR(5) for descriptions of the following attributes:
  63 .sp
  64
  65 .sp
  66 .TS
  67 box;
  68 c | c
  69 l | l .
  70 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  71 _
  72 Architecture    SPARC
  73 .TE
  74
  75 .SH SEE ALSO
  76 .sp
  77 .LP
  78 \fBluxadm\fR(8), \fBprtconf\fR(8), \fBdriver.conf\fR(4), \fBsocal\fR(7D),
  79 \fBssd\fR(7D)
  80 .sp
  81 .LP
  82 \fIWriting Device Drivers\fR
  83 .sp
  84 .LP
  85 \fIANSI X3.272-1996, Fibre Channel Arbitrated Loop (FC-AL)\fR
  86 .sp
  87 .LP
  88 \fIANSI X3.269-1996, Fibre Channel Protocol for SCSI (FCP)\fR
  89 .sp
  90 .LP
  91 \fIANSI X3.270-1996, SCSI-3 Architecture Model (SAM)\fR
  92 .sp
  93 .LP
  94 \fIFibre Channel Private Loop SCSI Direct Attach (FC-PLDA)\fR
  95 .SH DIAGNOSTICS
  96 .sp
  97 .LP
  98 In addition to being logged, the messages below may display on the system
  99 console.
 100 .sp
 101 .LP
 102 The first set of messages indicate that the attachment was unsuccessful, and
 103 will only display while the  \fBsf\fR driver is initially attempting to attach.
 104 Each message is preceded by  \fBsf\fR\fI%d\fR , where  \fI%d\fR is the instance
 105 number of the  \fBsf\fR device.
 106 .sp
 107 .ne 2
 108 .na
 109 \fBFailed to alloc soft state\fR
 110 .ad
 111 .sp .6
 112 .RS 4n
 113 Driver was unable to allocate space for the internal state structure.  Driver
 114 did not attach to device, SCSI devices will be inaccessible.
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fBBad soft state\fR
 121 .ad
 122 .sp .6
 123 .RS 4n
 124 Driver requested an invalid internal state structure. Driver did not attach to
 125 device, SCSI devices will be inaccessible.
 126 .RE
 127
 128 .sp
 129 .ne 2
 130 .na
 131 \fBFailed to obtain transport handle\fR
 132 .ad
 133 .sp .6
 134 .RS 4n
 135 Driver was unable to obtain a transport handle to communicate with the socal
 136 driver. Driver did not attach to device, SCSI devices will be inaccessible
 137 .RE
 138
 139 .sp
 140 .ne 2
 141 .na
 142 \fBFailed to allocate command/response pool\fR
 143 .ad
 144 .sp .6
 145 .RS 4n
 146 Driver was unable to allocate space for commands and responses. Driver did not
 147 attach to device, SCSI devices will be inaccessible.
 148 .RE
 149
 150 .sp
 151 .ne 2
 152 .na
 153 \fBFailed to allocate kmem cache\fR
 154 .ad
 155 .sp .6
 156 .RS 4n
 157 Driver was unable to allocate space for the packet cache. Driver did not attach
 158 to device, SCSI devices will be inaccessible.
 159 .RE
 160
 161 .sp
 162 .ne 2
 163 .na
 164 \fBFailed to allocate dma handle for\fR
 165 .ad
 166 .sp .6
 167 .RS 4n
 168 Driver was unable to allocate a dma handle for the loop map. Driver did not
 169 attach to device, SCSI devices will be inaccessible.
 170 .RE
 171
 172 .sp
 173 .ne 2
 174 .na
 175 \fBFailed to allocate lilp map\fR
 176 .ad
 177 .sp .6
 178 .RS 4n
 179 Driver was unable to allocate space for the loop map. Driver did not attach to
 180 device, SCSI devices will be inaccessible.
 181 .RE
 182
 183 .sp
 184 .ne 2
 185 .na
 186 \fBFailed to bind dma handle for\fR
 187 .ad
 188 .sp .6
 189 .RS 4n
 190 Driver was unable to bind a dma handle for the loop map. Driver did not attach
 191 to device, SCSI devices will be inaccessible.
 192 .RE
 193
 194 .sp
 195 .ne 2
 196 .na
 197 \fBFailed to attach\fR
 198 .ad
 199 .sp .6
 200 .RS 4n
 201 Driver was unable to attach for some reason that may be printed.  Driver did
 202 not attach to device, SCSI devices will be inaccessible.
 203 .RE
 204
 205 .sp
 206 .LP
 207 The next set of messages may display at any time.  The full device pathname,
 208 followed by the shorter form described above, will precede the message.
 209 .sp
 210 .ne 2
 211 .na
 212 \fBInvalid lilp map\fR
 213 .ad
 214 .sp .6
 215 .RS 4n
 216 The driver did not obtain a valid lilp map from the socal driver. SCSI device
 217 will be inaccessible.
 218 .RE
 219
 220 .sp
 221 .ne 2
 222 .na
 223 \fBTarget t, AL-PA x and hard\fR
 224 .ad
 225 .sp .6
 226 .RS 4n
 227 The device with a switch setting t has an AL-PA x which does not match its hard
 228 address y. The device will not be accessible.
 229 .RE
 230
 231 .sp
 232 .ne 2
 233 .na
 234 \fBDuplicate switch settings\fR
 235 .ad
 236 .sp .6
 237 .RS 4n
 238 The driver detected devices with the same switch setting. All such devices will
 239 be inaccessible.
 240 .RE
 241
 242 .sp
 243 .ne 2
 244 .na
 245 \fBWWN changed on target t\fR
 246 .ad
 247 .sp .6
 248 .RS 4n
 249 The World Wide Name (WWN) has changed on the device with switch setting t.
 250 .RE
 251
 252 .sp
 253 .ne 2
 254 .na
 255 \fBTarget t, unknown device type\fR
 256 .ad
 257 .sp .6
 258 .RS 4n
 259 The driver does not know the device type reported by the device with switch
 260 setting t.
 261 .RE
 262