NAME

ocs_fc — Emulex Fibre Channel Host Adapter driver

SYNOPSIS

device ocs_fc

In device.hints(5):
hint.ocs_fc.N.initiator
hint.ocs_fc.N.target
hint.ocs_fc.N.topology
hint.ocs_fc.N.speed

In loader.conf(5):
ocs_fc_load="YES"

In loader.conf(5) or sysctl.conf(5):
dev.ocs_fc.N.port_state
dev.ocs_fc.N.wwpn
dev.ocs_fc.N.wwnn
dev.ocs_fc.N.configured_speed
dev.ocs_fc.N.configured_topology
dev.ocs_fc.N.current_speed
dev.ocs_fc.N.current_topology

DESCRIPTION

The ocs_fc driver provides access to Fibre Channel SCSI devices.

The ocs_fc driver supports initiator and target modes. Support is available for Arbitrated loops, Point-to-Point, and Fabric connections. FC-Tape is highly recommended for connections to tape drives that support it. FC-Tape includes four elements from the T-10 FCP-4 specification:

Precise Delivery of Commands
Confirmed Completion of FCP I/O Operations
Retransmission of Unsuccessfully Transmitted IUs
Task Retry Identification

Together these features allow for link level error recovery with tape devices. Without link level error recovery, an initiator cannot, for instance, tell whether a tape write command that has timed out resulted in all, part, or none of the data going to the tape drive. FC-Tape is automatically enabled when both the controller and target support it.

HARDWARE

The ocs_fc driver supports the following PCIe Fibre Channel adapters:

LPe3500X FC Host Bus Adapter (Emulex 64/32G FC Gen 7 HBA)
LPe3200X FC Host Bus Adapter (Emulex 32/16G FC Gen 6 HBA)
LPe3100X FC Host Bus Adapter (Emulex 32/16G FC Gen 6 HBA)
LPe160XX FC Host Bus Adapter (Emulex 16/8G FC Gen 5 HBA)
LPe15004 FC Host Bus Adapter (Emulex 16/8G FC Gen 5 HBA)

UPDATING FIRMWARE

Adapter firmware updates are persistent.

Firmware can be updated by following these steps:

Copy this code to a Makefile:

KMOD=ocsflash
FIRMWS=imagename.grp:ocsflash
.include <bsd.kmod.mk>

Replace imagename with the name of the GRP file.
Copy the Makefile and GRP file to a local directory
Execute make and copy the generated ocsflash.ko file to /lib/modules
sysctl dev.ocs_fc.<N>.fw_upgrade=ocsflash
Check kernel messages regarding status of the operation
Reboot the machine

BOOT OPTIONS

The following boot options are controlled by setting values in /boot/device.hints:

hint.ocs_fc.N.initiator: Enable initiator functionality. Default 1 (enabled), 0 to disable.
hint.ocs_fc.N.target: Enable target functionality. Default 1 (enabled), 0 to disable.
hint.ocs_fc.N.topology: Topology: 0 for Auto, 1 for NPort only, 2 for Loop only.
hint.ocs_fc.N.speed: Link speed in megabits per second. Possible values include: 0 Auto-speed negotiation (default), 4000 (4GFC), 8000 (8GFC), 16000 (16GFC).

SYSCTL OPTIONS

dev.ocs_fc.N.port_state: Port state (read/write). Valid values are online and offline.
dev.ocs_fc.N.wwpn: World Wide Port Name (read/write).
dev.ocs_fc.N.wwnn: World Wide Node Name (read/write).
dev.ocs_fc.N.fwrev: Firmware revision (read-only).
dev.ocs_fc.N.sn: Adapter serial number (read-only).
dev.ocs_fc.N.configured_speed: Configured Port Speed (read/write). Valid values are: 0 Auto-speed negotiation (default), 4000 (4GFC), 8000 (8GFC), 16000 (16GFC).
dev.ocs_fc.N.configured_topology: Configured Port Topology (read/write). Valid values are: 0-Auto; 1-NPort; 2-Loop.
dev.ocs_fc.N.current_speed: Current Port Speed (read-only).
dev.ocs_fc.N.current_topology: Current Port Topology (read-only).

SUPPORT

For general information and support, go to the Broadcom website at: http://www.broadcom.com/ or E-Mail at ocs-driver-team.pdl@broadcom.com.

AUTHORS

The ocs_fc driver was written by Broadcom.