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.