summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorQiming Yang <qiming.yang@intel.com>2017-05-03 14:21:28 +0800
committerThomas Monjalon <thomas@monjalon.net>2017-05-07 14:32:17 +0200
commitaf06edfa48c0abd38290a5c898af2578e2df6b7f (patch)
tree3e69f0b19c270635e2362abe0fce0bfe4c1b84cd
parent156c42ead15a40edbb2eec1ca560f506d099852e (diff)
downloaddpdk-af06edfa48c0abd38290a5c898af2578e2df6b7f.zip
dpdk-af06edfa48c0abd38290a5c898af2578e2df6b7f.tar.gz
dpdk-af06edfa48c0abd38290a5c898af2578e2df6b7f.tar.xz
doc: add kernel module restriction for VF
This patch adds two note in doc build_dpdk, suggests DPDK user don't use ``vfio-pci`` and ``uio_pci_generic`` module to create virtual functions(VFs). Signed-off-by: Qiming Yang <qiming.yang@intel.com>
-rw-r--r--doc/guides/linux_gsg/build_dpdk.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst
index 9d24573..cf6c06d 100644
--- a/doc/guides/linux_gsg/build_dpdk.rst
+++ b/doc/guides/linux_gsg/build_dpdk.rst
@@ -155,6 +155,10 @@ can provide the uio capability. This module can be loaded using the command
sudo modprobe uio_pci_generic
+.. note::
+
+ ``uio_pci_generic`` module doesn't support the creation of virtual functions.
+
As an alternative to the ``uio_pci_generic``, the DPDK also includes the igb_uio
module which can be found in the kmod subdirectory referred to above. It can
be loaded as shown below:
@@ -187,6 +191,10 @@ however please consult your distributions documentation to make sure that is the
Also, to use VFIO, both kernel and BIOS must support and be configured to use IO virtualization (such as IntelĀ® VT-d).
+.. note::
+
+ ``vfio-pci`` module doesn't support the creation of virtual functions.
+
For proper operation of VFIO when running DPDK applications as a non-privileged user, correct permissions should also be set up.
This can be done by using the DPDK setup script (called dpdk-setup.sh and located in the usertools directory).