From df7f8e8cffcc43531f7daeda44d436b60e538141 Mon Sep 17 00:00:00 2001 From: Steven Luong Date: Sun, 18 Mar 2018 08:01:27 -0700 Subject: vmxnet3 device driver Implemented vmxnet3 deivice driver for VMWare ESXi. Tested with Ubuntu 18.04 connected to ESXi 6.0 Ubuntu-18.04 (VPP) --- ESXi-6.0 Change-Id: I85fbc86f2d8532b017bc4271612d17e24e498e4d Signed-off-by: Steven Luong --- src/plugins/vmxnet3/README.md | 59 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 src/plugins/vmxnet3/README.md (limited to 'src/plugins/vmxnet3/README.md') diff --git a/src/plugins/vmxnet3/README.md b/src/plugins/vmxnet3/README.md new file mode 100644 index 00000000000..a49671325c9 --- /dev/null +++ b/src/plugins/vmxnet3/README.md @@ -0,0 +1,59 @@ +# VMWARE vmxnet3 device driver plugin + +##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 code is tested with ESXi vSwitch version 6.0, release build 3620759. + + * 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. + +##Known issues + +* NUMA support +* TSO +* VLAN filter + +## Usage +### System setup + +1. load VFIO driver +``` +sudo modprobe vfio-pci +``` + +2. (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 +``` +dpdk-devbind.py --bind vfio-pci 0b:00.0 +``` + +### Interface Creation +Interface can be dynamically created with following CLI: +``` +create interface vmxnet3 0000:0b:00.0 +set int state vmxnet3-0/b/0/0 up +``` + +### Interface Deletion +Interface can be deleted with following CLI: +``` +delete interface vmxnet3 +``` + +### Interface Statistics +Interface statistics can be displayed with `show hardware-interface ` +command. + +### Show Interface CLI +Interface and ring information can be obtained with +`show vmxnet3 [if-name] [desc]` -- cgit 1.2.3-korg