summaryrefslogtreecommitdiffstats
path: root/src/plugins/vmxnet3/README.md
diff options
context:
space:
mode:
authorSteven Luong <sluong@cisco.com>2019-03-14 09:57:09 -0700
committerDamjan Marion <dmarion@me.com>2019-03-18 11:11:50 +0000
commitee8ba6877efb916b88255821f94ef33437724f75 (patch)
treeaeb507c38ba53a60791c7084f6f47d540608971f /src/plugins/vmxnet3/README.md
parenta990a2e4930014f025338d8ce186abfa12ec09ff (diff)
vmxnet3: auto bind support
For creating the vmxnet3 interface, add the bind option to automatically bind the pci to vfio-pci module which removes the need for manual bind. Manual bind still works, should people prefer to go that route. Change-Id: Ife75926f8755d754a08dd0ecff0f1de326ad5ba1 Signed-off-by: Steven Luong <sluong@cisco.com>
Diffstat (limited to 'src/plugins/vmxnet3/README.md')
-rw-r--r--src/plugins/vmxnet3/README.md21
1 files changed, 14 insertions, 7 deletions
diff --git a/src/plugins/vmxnet3/README.md b/src/plugins/vmxnet3/README.md
index b5829939506..722954d51a3 100644
--- a/src/plugins/vmxnet3/README.md
+++ b/src/plugins/vmxnet3/README.md
@@ -7,11 +7,11 @@ 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
@@ -25,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 <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
```
-3. Bind interface to vfio-pci
+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:
+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
```