oce (4)

Leading comments

Copyright (C) 2013 Emulex
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice,
   this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
  documentation and/or other mate...

(The comments found at the beginning of the groff file "man4/oce.4freebsd".)

NAME

oce - Device driver for Emulex OneConnect 10Gb network adapters

SYNOPSIS

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

if_oce_load="YES"

DESCRIPTION

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

The ifconfig 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 ifconfig 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. Qq Invalid BE3 firmware image
2. Qq Invalid Cookie. Firmware image corrupted ?
3. Qq cmd to write to flash rom failed.

SUPPORT

For general information and support, go to the Emulex website at: www.Emulex.com or E-Mail at freebsd-drivers@emulex.com

SEE ALSO

ifconfig(8)

AUTHORS

An -nosplit The ifconfig driver was written by An freebsd-drivers@emulex.com .