tail head cat sleep
QR code linking to this page
Main index Section 4
Go to:
Options

Manual Pages  — OCS_FC

NAME

ocs_fc – Device driver for Emulex Fibre Channel Host Adapters

CONTENTS

SYNOPSIS

To compile this driver into the kernel, add this line to the kernel configuration file: device ocs_fc

To load the driver as a module at boot, add this line to loader.conf(5): 

ocs_fc_load="YES"

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:

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 these Fibre Channel adapters:
Emulex 16/8G FC GEN 5 HBAS
  
LPe15004 FC Host Bus Adapters
LPe160XX FC Host Bus Adapters
Emulex 32/16G FC GEN 6 HBAS
  
LPe3100X FC Host Bus Adapters
LPe3200X FC Host Bus Adapters
Emulex 64/32G FC GEN 7 HBAS
  
LPe3500X FC Host Bus Adapters

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

Options are controlled by setting values in /boot/device.hints.

They are:
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

The ocs_fc driver was written by Broadcom.
OCS_FC (4) December 29, 2021
tail head cat sleep
QR code linking to this page
Main index Section 4
Go to:
Options

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“ As soon as we started programming, we found to our surprise that it wasn't as easy to get programs right as we had thought. Debugging had to be discovered. I can remember the exact instant when I realized that a large part of my life from then on was going to be spent in finding mistakes in my own programs. ”
— Maurice Wilkes