src/plugins/vmxnet3/README.md

   1 # VMWARE vmxnet3 device driver plugin
   2
   3 ##Overview
   4 This plugin provides native PCI driver support for VMWare vmxnet3.
   5
   6 ##Prerequisites
   7  * This code is tested with vfio-pci driver installed with Ubuntu 18.04 which
   8 has kernel version 4.15.0-33-generic.
   9
  10  * This code is tested with ESXi vSwitch version 6.0, release build 3620759.
  11
  12  * Driver requires MSI-X interrupt support, which is not supported by
  13 uio_pci_generic driver, so vfio-pci needs to be used. On systems without IOMMU
  14 vfio driver can still be used with recent kernels which support no-iommu mode.
  15
  16 ##Known issues
  17
  18 * NUMA support
  19 * TSO/LRO
  20 * RSS/multiple queues
  21 * VLAN filter
  22
  23 ## Usage
  24 ### System setup
  25
  26 1. load VFIO driver
  27 ```
  28 sudo modprobe vfio-pci
  29 ```
  30
  31 2. (systems without IOMMU only) enable unsafe NOIOMMU mode
  32 ```
  33 echo Y | sudo tee /sys/module/vfio/parameters/enable_unsafe_noiommu_mode
  34 ```
  35
  36 3. Bind interface to vfio-pci
  37 ```
  38 sudo dpdk-devbind.py --bind vfio-pci 0b:00.0
  39 ```
  40
  41 ### Interface Creation
  42 Interface can be dynamically created with following CLI:
  43 ```
  44 create interface vmxnet3 0000:0b:00.0
  45 set int state vmxnet3-0/b/0/0 up
  46 ```
  47
  48 ### Interface Deletion
  49 Interface can be deleted with following CLI:
  50 ```
  51 delete interface vmxnet3 <if-name>
  52 ```
  53
  54 ### Interface Statistics
  55 Interface statistics can be displayed with `show hardware-interface <if-name>`
  56 command.
  57
  58 ### Show Interface CLI
  59 Interface and ring information can be obtained with
  60 `show vmxnet3 [if-name] [desc]`