doc: clarify usage of netvsc PMD

Since netvsc PMD does not support SR-IOV accelerated networking,
it is not recommended for use on Azure. Make this clear in the
guide.

Signed-off-by: Stephen Hemminger <sthemmin@microsoft.com>
This commit is contained in:
Stephen Hemminger 2018-08-06 09:31:07 -07:00 committed by Thomas Monjalon
parent a31f76d8fe
commit 4b048f352c

View File

@ -6,7 +6,7 @@ Netvsc poll mode driver
The Netvsc Poll Mode driver (PMD) provides support for the paravirtualized The Netvsc Poll Mode driver (PMD) provides support for the paravirtualized
network device for Microsoft Hyper-V. It can be used with network device for Microsoft Hyper-V. It can be used with
Window Server 2008/2012/2016, Windows 10 and Azure cloud. Window Server 2008/2012/2016, Windows 10.
The device offers multi-queue support (if kernel and host support it), The device offers multi-queue support (if kernel and host support it),
checksum and segmentation offloads. checksum and segmentation offloads.
@ -21,7 +21,7 @@ In this release, the hyper PMD driver provides the basic functionality of packet
* The PMD supports multicast packets and promiscuous mode subject to restrictions on the host. * The PMD supports multicast packets and promiscuous mode subject to restrictions on the host.
In order to this to work, the guest network configuration on Hyper-V must be configured to allow MAC address In order to this to work, the guest network configuration on Hyper-V must be configured to allow MAC address
spoofing. This option is not available on Azure. spoofing.
* The device has only a single MAC address. * The device has only a single MAC address.
Hyper-V driver does not support MAC or VLAN filtering because the Hyper-V host does not support it. Hyper-V driver does not support MAC or VLAN filtering because the Hyper-V host does not support it.
@ -33,9 +33,13 @@ In this release, the hyper PMD driver provides the basic functionality of packet
* The maximum number of queues is limited by the host (currently 64). * The maximum number of queues is limited by the host (currently 64).
When used with 4.16 kernel only a single queue is available. When used with 4.16 kernel only a single queue is available.
* This driver is intended for use with synthetic path only. .. note::
Accelerated Networking (SR-IOV) acceleration is not supported yet. This driver is intended for use with **Hyper-V only** and is
Use the VDEV_NETVSC device for accelerated networking instead. not recommended for use on Azure because accelerated Networking
(SR-IOV) is not supported.
On Azure, use the :doc:`vdev_netvsc` which
automatically configures the necessary TAP and failsave drivers.
Installation Installation
@ -88,7 +92,7 @@ operations:
.. Note:: .. Note::
The dpkd-devbind.py script should not be used. It only handles PCI devices. The dpkd-devbind.py script can not be used since it only handles PCI devices.
Prerequisites Prerequisites