NAME¶

iavf — Intel Adaptive Virtual Function driver

SYNOPSIS¶

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

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

if_iavf_load="YES"

DESCRIPTION¶

The iavf driver provides support for the PCI Virtual Functions from the 700 Series of ethernet devices and newer product families. The driver supports Jumbo Frames, TX/RX checksum offload, TCP segmentation offload (TSO), Large Receive Offload (LRO), VLAN tag insertion/extraction, VLAN checksum offload, VLAN TSO, and Receive Side Steering (RSS), all for both IPv4 and IPv6. For further hardware information and questions related to hardware requirements, see http://support.intel.com/.

Support for Jumbo Frames is provided via the interface MTU setting. Selecting an MTU larger than 1500 bytes with the ifconfig(8) utility configures the adapter to receive and transmit Jumbo Frames. The maximum MTU size for Jumbo Frames is 9706.

Offloads are also controlled via the interface, for instance, checksumming for both IPv4 and IPv6 can be set and unset, TSO4 and/or TSO6, and finally LRO can be set and unset.

For more information on configuring this device, see ifconfig(8).

NOTE: This iavf driver is only for Virtual Functions. For 700 series Physical Functions, use the ixl(4) driver.

LOADER TUNABLES¶

Tunables can be set at the loader(8) prompt before booting the kernel or stored in loader.conf(5).

hw.iavf.rx_itr

The RX interrupt rate value, set to 62 (124 usec) by default.

hw.iavf.tx_itr

The TX interrupt rate value, set to 122 (244 usec) by default.

hw.iavf.enable_head_writeback

When the driver is finding the last TX descriptor processed by the hardware, use a value written to memory by the hardware instead of scanning the descriptor ring for completed descriptors. Disabled by default; this mimics the "legacy" TX behavior found in ixgbe(4). to ensure compatibility with future, non-700 series VF devices.

SUPPORT¶

For general information and support, go to the Intel support website at: http://support.intel.com/.

If an issue is identified with this driver with a supported adapter, email all the specific information related to the issue to freebsd@intel.com.

SEE ALSO¶

arp(4), ixl(4), netintro(4), vlan(4), ifconfig(8), iflib(9)

HISTORY¶

The iavf device driver first appeared in FreeBSD 10.1. under the name "ixlv" It was converted to use iflib(9) and changed to its current name in FreeBSD 12.

AUTHORS¶

The iavf driver was written by Jack Vogel <jfv@freebsd.org> and Eric Joyner <erj@freebsd.org>.

CAVEATS¶

This driver is supposed to function on VFs spawned from future network devices by Intel, but at the time of this writing, has only been tested on the 700 series VFs.