X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=src%2Fplugins%2Fvmxnet3%2FREADME.md;h=722954d51a30064278a78abc09ea5871cc50e0d6;hb=ee8ba6877;hp=a49671325c970ddd9e4b8297179d35928f57ee77;hpb=df7f8e8cffcc43531f7daeda44d436b60e538141;p=vpp.git diff --git a/src/plugins/vmxnet3/README.md b/src/plugins/vmxnet3/README.md index a49671325c9..722954d51a3 100644 --- a/src/plugins/vmxnet3/README.md +++ b/src/plugins/vmxnet3/README.md @@ -7,16 +7,14 @@ This plugin provides native PCI driver support for VMWare vmxnet3. * This code is tested with vfio-pci driver installed with Ubuntu 18.04 which has kernel version 4.15.0-33-generic. - * This code is tested with ESXi vSwitch version 6.0, release build 3620759. + * 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 needs to be used. On systems without IOMMU -vfio driver can still be used with recent kernels which support no-iommu mode. +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 -* NUMA support -* TSO * VLAN filter ## Usage @@ -27,20 +25,27 @@ vfio driver can still be used with recent kernels which support no-iommu mode. sudo modprobe vfio-pci ``` -2. (systems without IOMMU only) enable unsafe NOIOMMU mode +2. Make sure the interface is down +``` +sudo ifconfig 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 ``` -3. Bind interface to vfio-pci +4. Bind interface to vfio-pci ``` -dpdk-devbind.py --bind vfio-pci 0b:00.0 +sudo dpdk-devbind.py --bind vfio-pci 0b:00.0 ``` ### Interface Creation -Interface can be dynamically created with following CLI: +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 +create interface vmxnet3 0000:0b:00.0 bind set int state vmxnet3-0/b/0/0 up ```