share/man/man7d/socal.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 SOCAL 7D "May 9, 1997"
   7 .SH NAME
   8 socal \- Serial Optical Controller for Fibre Channel Arbitrated Loop (SOC+)
   9 device driver
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBsocal@\fIsbus-slot\fR,0\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The Fibre Channel Host Bus Adapter is an SBus card which implements two full
  20 duplex Fibre Channel interfaces.  Each Fibre Channel interface can connect to a
  21 Fibre Channel Arbitrated Loop (FC-AL).
  22 .sp
  23 .LP
  24 The  \fBsocal\fR device driver is a nexus driver and implements portions of the
  25 FC-2 and FC-4 layers of FC-AL.
  26 .SH FILES
  27 .sp
  28 .ne 2
  29 .na
  30 \fB\fB/kernel/drv/socal\fR\fR
  31 .ad
  32 .RS 21n
  33 ELF Kernel Module
  34 .RE
  35
  36 .SH ATTRIBUTES
  37 .sp
  38 .LP
  39 See \fBattributes\fR(5) for descriptions of the following attributes:
  40 .sp
  41
  42 .sp
  43 .TS
  44 box;
  45 c | c
  46 l | l .
  47 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  48 _
  49 Architecture    SPARC
  50 .TE
  51
  52 .SH SEE ALSO
  53 .sp
  54 .LP
  55 \fBsbus\fR(4), \fBsf\fR(7D), \fBssd\fR(7D)
  56 .sp
  57 .LP
  58 \fIWriting Device Drivers\fR
  59 .sp
  60 .LP
  61 \fIANSI X3.230-1994, Fibre Channel Physical and Signalling Interface (FC-PH)\fR
  62 .sp
  63 .LP
  64 \fIANSI X3.272-1996, Fibre Channel Arbitrated Loop (FC-AL)\fR
  65 .sp
  66 .LP
  67 \fIFibre Channel Private Loop SCSI Direct Attach (FC-PLDA)\fR
  68 .SH DIAGNOSTICS
  69 .sp
  70 .LP
  71 The messages described below  may appear on system console in addition to being
  72 logged.
  73 .sp
  74 .LP
  75 On the console, these messages are preceded by:
  76 .sp
  77 .in +2
  78 .nf
  79 \fBsocal\fR\fI%d\fR\fB: port \fR\fI%a\fR
  80 .fi
  81 .in -2
  82 .sp
  83
  84 .sp
  85 .LP
  86 where  \fI%d\fR is the instance number of the  \fBsocal\fR controller and
  87 \fI%a\fR is the port on the host adapter.
  88 .sp
  89 .ne 2
  90 .na
  91 \fBFibre Channel Loop is ONLINE\fR
  92 .ad
  93 .sp .6
  94 .RS 4n
  95 The Fibre Channel loop is now online.
  96 .RE
  97
  98 .sp
  99 .ne 2
 100 .na
 101 \fBFibre Channel Loop is OFFLINE\fR
 102 .ad
 103 .sp .6
 104 .RS 4n
 105 The Fibre Channel loop is now offline.
 106 .RE
 107
 108 .sp
 109 .ne 2
 110 .na
 111 \fBattach failed: device in slave-only slot.\fR
 112 .ad
 113 .sp .6
 114 .RS 4n
 115 Move soc+ card to another slot.
 116 .RE
 117
 118 .sp
 119 .ne 2
 120 .na
 121 \fBattach failed: bad soft state.\fR
 122 .ad
 123 .sp .6
 124 .RS 4n
 125 Driver did not attach, devices will be inaccessible.
 126 .RE
 127
 128 .sp
 129 .ne 2
 130 .na
 131 \fBattach failed: unable to alloc xport struct.\fR
 132 .ad
 133 .sp .6
 134 .RS 4n
 135 Driver did not attach, devices will be inaccessible.
 136 .RE
 137
 138 .sp
 139 .ne 2
 140 .na
 141 \fBattach failed: unable to map eeprom\fR
 142 .ad
 143 .sp .6
 144 .RS 4n
 145 Driver was unable to map device memory; check for bad hardware.  Driver did not
 146 attach to device, devices will be inaccessible.
 147 .RE
 148
 149 .sp
 150 .ne 2
 151 .na
 152 \fBattach failed: unable to map XRAM\fR
 153 .ad
 154 .sp .6
 155 .RS 4n
 156 Driver was unable to map device memory; check for bad hardware.  Driver did
 157 not attach to device, devices will be inaccessible.
 158 .RE
 159
 160 .sp
 161 .ne 2
 162 .na
 163 \fBattach failed: unable to map registers\fR
 164 .ad
 165 .sp .6
 166 .RS 4n
 167 Driver was unable to map device registers; check for bad hardware.  Driver  did
 168 not attach to device, devices will be inaccessible.
 169 .RE
 170
 171 .sp
 172 .ne 2
 173 .na
 174 \fBattach failed: unable to access status register\fR
 175 .ad
 176 .sp .6
 177 .RS 4n
 178 Driver was unable to map device registers; check for bad hardware.  Driver  did
 179 not attach to device, devices will be inaccessible.
 180 .RE
 181
 182 .sp
 183 .ne 2
 184 .na
 185 \fBattach failed: unable to install interrupt handler\fR
 186 .ad
 187 .sp .6
 188 .RS 4n
 189 Driver was not able to add the interrupt routine to the kernel.  Driver  did
 190 not attach to device, devices will be inaccessible.
 191 .RE
 192
 193 .sp
 194 .ne 2
 195 .na
 196 \fBattach failed: unable to access host adapter XRAM\fR
 197 .ad
 198 .sp .6
 199 .RS 4n
 200 Driver was unable to access device RAM; check for bad hardware.  Driver  did
 201 not attach to device, devices will be inaccessible.
 202 .RE
 203
 204 .sp
 205 .ne 2
 206 .na
 207 \fBattach failed: unable to write host adapter XRAM\fR
 208 .ad
 209 .sp .6
 210 .RS 4n
 211 Driver was unable to write device RAM; check for bad hardware.  Driver  did not
 212 attach to device, devices will be inaccessible.
 213 .RE
 214
 215 .sp
 216 .ne 2
 217 .na
 218 \fBattach failed: read/write mismatch in XRAM\fR
 219 .ad
 220 .sp .6
 221 .RS 4n
 222 Driver was unable to verify device RAM; check for bad hardware.  Driver  did
 223 not attach to device, devices will be inaccessible.
 224 .RE
 225