OCS_FC(4)

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:

1.  Copy this code to a Makefile:

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

2.  Replace imagename with the name of the GRP file.

3.  Copy the Makefile and GRP file to a local directory

4.  Execute make and copy the generated ocsflash.ko file to /lib/modules

5.  sysctl dev.ocs_fc.<N>.fw_upgrade=ocsflash

6.  Check kernel messages regarding status of the operation

7.  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.

SEE ALSO
ifconfig(8)

AUTHORS
-nosplit The ocs_fc driver was written by Broadcom.