blob: 6e9fb194c94eb0180522faf3f790df4bb8465eb7 (
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
|
# VMWARE vmxnet3 device driver plugin {#vmxnet3_doc}
##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]`
|
