summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn McNamara <john.mcnamara@intel.com>2017-08-03 18:19:45 +0100
committerThomas Monjalon <thomas@monjalon.net>2017-08-04 01:21:54 +0200
commitccf5fd6045862d0abd02e42842b41c8550a9f114 (patch)
treef981b68c63b7631c6a16b50e7d4a1f617d80f24c
parent629122b8b842b6bd2278c2caf705ef33d41b1a72 (diff)
downloaddpdk-ccf5fd6045862d0abd02e42842b41c8550a9f114.zip
dpdk-ccf5fd6045862d0abd02e42842b41c8550a9f114.tar.gz
dpdk-ccf5fd6045862d0abd02e42842b41c8550a9f114.tar.xz
doc: warn about UIO not working with UEFI secure boot
Added notes to the documentation warning that if UEFI secure boot is enabled the Linux kernel may disallow the use of UIO on the system, and a suggested workaround of using the vfio-pci kernel module instead of igb_uio or uio_pci_generic. Signed-off-by: John McNamara <john.mcnamara@intel.com>
-rw-r--r--doc/guides/faq/faq.rst7
-rw-r--r--doc/guides/linux_gsg/linux_drivers.rst7
-rw-r--r--doc/guides/linux_gsg/sys_reqs.rst7
3 files changed, 21 insertions, 0 deletions
diff --git a/doc/guides/faq/faq.rst b/doc/guides/faq/faq.rst
index 308a287..aa1d47d 100644
--- a/doc/guides/faq/faq.rst
+++ b/doc/guides/faq/faq.rst
@@ -222,3 +222,10 @@ How can hugepage-backed memory be shared among multiple processes?
------------------------------------------------------------------
See the Primary and Secondary examples in the :ref:`multi-process sample application <multi_process_app>`.
+
+
+Why can't my application receive packets on my system with UEFI Secure Boot enabled?
+------------------------------------------------------------------------------------
+
+If UEFI secure boot is enabled, the Linux kernel may disallow the use of UIO on the system.
+Therefore, devices for use by DPDK should be bound to the ``vfio-pci`` kernel module rather than ``igb_uio`` or ``uio_pci_generic``.
diff --git a/doc/guides/linux_gsg/linux_drivers.rst b/doc/guides/linux_gsg/linux_drivers.rst
index b3525c0..08f7c9b 100644
--- a/doc/guides/linux_gsg/linux_drivers.rst
+++ b/doc/guides/linux_gsg/linux_drivers.rst
@@ -67,6 +67,13 @@ be loaded as shown below:
For some devices which lack support for legacy interrupts, e.g. virtual function
(VF) devices, the ``igb_uio`` module may be needed in place of ``uio_pci_generic``.
+.. note::
+
+ If UEFI secure boot is enabled, the Linux kernel may disallow the use of
+ UIO on the system. Therefore, devices for use by DPDK should be bound to the
+ ``vfio-pci`` kernel module rather than ``igb_uio`` or ``uio_pci_generic``.
+ For more details see :ref:`linux_gsg_binding_kernel` below.
+
Since DPDK release 1.7 onward provides VFIO support, use of UIO is optional
for platforms that support using VFIO.
diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst
index 0f98876..eb8442c 100644
--- a/doc/guides/linux_gsg/sys_reqs.rst
+++ b/doc/guides/linux_gsg/sys_reqs.rst
@@ -47,6 +47,13 @@ and high performance of small packets, BIOS setting changes may be needed.
Consult the section on :ref:`Enabling Additional Functionality <Enabling_Additional_Functionality>`
for more information on the required changes.
+.. note::
+
+ If UEFI secure boot is enabled, the Linux kernel may disallow the use of
+ UIO on the system. Therefore, devices for use by DPDK should be bound to the
+ ``vfio-pci`` kernel module rather than ``igb_uio`` or ``uio_pci_generic``.
+ For more details see :ref:`linux_gsg_binding_kernel`.
+
Compilation of the DPDK
-----------------------