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]
sf@port,0
The sf 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 SOC+ card (see socal(7D)) connects the Fibre Channel loop to the host system.
The sf driver interfaces with the SOC+ device driver, socal(7D), the SCSI disk target driver, ssd(7D), and the SCSI-3 Enclosure Services driver, ses(7D). It only supports SCSI devices of type disk and ses.
The sf driver supports the standard functions provided by the SCSA interface. The driver supports auto request sense and tagged queueing by default.
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.
ELF kernel module
sf driver configuration file
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Architecture SPARC |
luxadm(1M), prtconf(1M), driver.conf(4), socal(7D), ssd(7D)
Writing Device Drivers
ANSI X3.272-1996, Fibre Channel Arbitrated Loop (FC-AL)
ANSI X3.269-1996, Fibre Channel Protocol for SCSI (FCP)
ANSI X3.270-1996, SCSI-3 Architecture Model (SAM)
Fibre Channel Private Loop SCSI Direct Attach (FC-PLDA)
In addition to being logged, the messages below may display on the system console.
The first set of messages indicate that the attachment was unsuccessful, and will only display while the sf driver is initially attempting to attach. Each message is preceded by sf%d , where %d is the instance number of the sf device. Failed to alloc soft state
Driver was unable to allocate space for the internal state structure. Driver did not attach to device, SCSI devices will be inaccessible.
Driver requested an invalid internal state structure. Driver did not attach to device, SCSI devices will be inaccessible.
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
Driver was unable to allocate space for commands and responses. Driver did not attach to device, SCSI devices will be inaccessible.
Driver was unable to allocate space for the packet cache. Driver did not attach to device, SCSI devices will be inaccessible.
Driver was unable to allocate a dma handle for the loop map. Driver did not attach to device, SCSI devices will be inaccessible.
Driver was unable to allocate space for the loop map. Driver did not attach to device, SCSI devices will be inaccessible.
Driver was unable to bind a dma handle for the loop map. Driver did not attach to device, SCSI devices will be inaccessible.
Driver was unable to attach for some reason that may be printed. Driver did not attach to device, SCSI devices will be inaccessible.
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. Invalid lilp map
The driver did not obtain a valid lilp map from the socal driver. SCSI device will be inaccessible.
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.
The driver detected devices with the same switch setting. All such devices will be inaccessible.
The World Wide Name (WWN) has changed on the device with switch setting t.
The driver does not know the device type reported by the device with switch setting t.