Nathan Skrzypczak
f47122e07e
Type: improvement Change-Id: I7e821cce1feae229e1be4baeed249b9cca658135 Signed-off-by: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
87 lines
1.9 KiB
ReStructuredText
87 lines
1.9 KiB
ReStructuredText
VMWARE vmxnet3 device driver
|
|
============================
|
|
|
|
##Overview This plugin provides native PCI driver support for VMWare
|
|
vmxnet3.
|
|
|
|
##Prerequisites \* This code is tested with vfio-pci driver installed
|
|
with Ubuntu 18.04 which has kernel version 4.15.0-33-generic.
|
|
|
|
- This driver is tested with ESXi vSwitch version 6.5/6.7 for LRO/TSO
|
|
support, VMware Workstation 15 Pro (no LRO/TSO), and VMware Fusion 11
|
|
Pro (no LRO/TSO)
|
|
|
|
- Driver requires MSI-X interrupt support, which is not supported by
|
|
uio_pci_generic driver. So vfio-pci must be used. On systems without
|
|
IOMMU, vfio driver can still be used with 4.15.0-33-generic kernel
|
|
(Ubuntu 18.04) which supports no-iommu mode.
|
|
|
|
##Known issues
|
|
|
|
- VLAN filter
|
|
|
|
Usage
|
|
-----
|
|
|
|
System setup
|
|
~~~~~~~~~~~~
|
|
|
|
1. load VFIO driver
|
|
|
|
::
|
|
|
|
sudo modprobe vfio-pci
|
|
|
|
2. Make sure the interface is down
|
|
|
|
::
|
|
|
|
sudo ifconfig <if-name> down
|
|
|
|
Steps 3 and 4 are optional. They can be accomplished by specifying the
|
|
optional keyword “bind” when creating the vmxnet3 interface.
|
|
|
|
3. (systems without IOMMU only) enable unsafe NOIOMMU mode
|
|
|
|
::
|
|
|
|
echo Y | sudo tee /sys/module/vfio/parameters/enable_unsafe_noiommu_mode
|
|
|
|
4. Bind interface to vfio-pci
|
|
|
|
::
|
|
|
|
sudo dpdk-devbind.py --bind vfio-pci 0b:00.0
|
|
|
|
Interface Creation
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
Interface can be dynamically created with following CLI, with or without
|
|
the bind option. If step 3 and 4 were executed, bind can be omitted.
|
|
|
|
::
|
|
|
|
create interface vmxnet3 0000:0b:00.0 bind
|
|
set int state vmxnet3-0/b/0/0 up
|
|
|
|
Interface Deletion
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
Interface can be deleted with following CLI:
|
|
|
|
::
|
|
|
|
delete interface vmxnet3 <if-name>
|
|
|
|
Interface Statistics
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Interface statistics can be displayed with
|
|
``show hardware-interface <if-name>`` command.
|
|
|
|
Show Interface CLI
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
Interface and ring information can be obtained with
|
|
``show vmxnet3 [if-name] [desc]``
|