aboutsummaryrefslogtreecommitdiffstats
path: root/src/plugins/vmxnet3/README.rst
blob: 14430433c17145d38ea6f23a8c368c6fd20777a9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
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]``