From: Qiming Yang Date: Wed, 3 May 2017 06:21:28 +0000 (+0800) Subject: doc: add kernel module restriction for VF X-Git-Tag: spdx-start~3248 X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=af06edfa48c0abd38290a5c898af2578e2df6b7f;p=dpdk.git 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 --- diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst index 9d245737d2..cf6c06d646 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).