oce(4)

oce4

Device driver for emulex oneconnect 10gb network adapters

Usage

To compile this driver into the kernel, place the following lines in your kernel configuration file:

device pci device oce

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

if_oce_load="YES"

Overview

Emulex OneConnect adapters come in various skews and with different combinations of NIC, FCoE and iSCSI functions. The oce driver claims the NIC functions in all these adapters.

The oce driver supports VLAN Hardware offload, TCP checksum offload, TCP segmentation offload (TSO), Large receive offload (LRO), Bonding, Jumbo frames (from 1500 - 9000), Multiple TX queues, Receive-Side Scaling (RSS) and MSI-X interrupts.

Hardware

The oce driver supports the following network adapters:

  • Emulex BladeEngine 2

  • Emulex BladeEngine 3

  • Emulex Lancer

Updating firmware

Adapter firmware updates are persistent.

Firmware can be updated by following the steps below:

  1. Copy the below code to a Makefile:

    KMOD=elxflash
    FIRMWS=imagename.ufi:elxflash
    .include <bsd.kmod.mk>
  2. Replace imagename in above with UFI file name

  3. Copy Makefile and UFI file to a directory

  4. Execute make & copy generated elxflash.ko to /lib/modules

  5. sysctl dev.oce.<if_id>.fw_upgrade=elxflash

  6. Reboot the machine

In case of issues with supplied UFI, flashing fails with one of the following errors.

  1. "Invalid BE3 firmware image"

  2. "Invalid Cookie. Firmware image corrupted ?"

  3. "cmd to write to flash rom failed."

Support

For general information and support, go to the Emulex website at: http://www.Emulex.com/ or E-Mail at [email protected].

Releases

35 releases since FreeBSD 8.3-RELEASE; the text changed 22 times.

  1. 8.3
  2. 8.4
  3. 9.1
  4. 9.2
  5. 9.3
  6. 10.0
  7. 10.1
  8. 10.2
  9. 10.3
  10. 10.4
  11. 11.0
  12. 11.1
  13. 11.2
  14. 11.3
  15. 11.4
  16. 12.0
  17. 12.1
  18. 12.2
  19. 12.3
  20. 12.4
  21. 13.0–13.2
  22. 13.3–14.2
  23. 14.3–16.0

Authors

The oce driver was written by [email protected].

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.