---
name: "ocs_fc"
section: "4"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/ocs_fc"
---

# ocs\_fc(4)

Emulex Fibre Channel Host Adapter driver

## NAME

**ocs\_fc** – Emulex Fibre Channel Host Adapter driver

## SYNOPSIS

**device** **ocs\_fc**

In [device.hints(5)](/device.hints/5.md): **hint.ocs\_fc.N.initiator** **hint.ocs\_fc.N.target** **hint.ocs\_fc.N.topology** **hint.ocs\_fc.N.speed**

In [loader.conf(5)](/loader.conf/5.md): **ocs\_fc\_load="YES"**

In [loader.conf(5)](/loader.conf/5.md) or [sysctl.conf(5)](/sysctl.conf/5.md): **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)](/ifconfig/8.md)

## AUTHORS

The **ocs\_fc** driver was written by Broadcom.