]> git.droids-corp.org - dpdk.git/commitdiff
doc: remove IOMMU pass-through from Linux guide
authorBruce Richardson <bruce.richardson@intel.com>
Thu, 10 Mar 2022 12:38:43 +0000 (12:38 +0000)
committerThomas Monjalon <thomas@monjalon.net>
Tue, 15 Mar 2022 18:42:37 +0000 (19:42 +0100)
The "Linux Drivers" section of the GSG already notes that, for use of
UIO, the IOMMU must be disabled or put into pass-through mode.
Therefore, there is no need to duplicate this information in the
"additional functionality" section.  Also the kernel configuration
options documented in the section are enabled as standard on all common
distro kernels, so the information should not be needed in a GSG doc.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
doc/guides/linux_gsg/enable_func.rst
doc/guides/linux_gsg/linux_drivers.rst

index 7f6225e8474accabb59dd606c5a0c988b78446ea..44c3b05130ec4373f402809bea1ffaee5902fb96 100644 (file)
@@ -128,22 +128,3 @@ API calls be used instead of the HPET-specific APIs.
 These generic APIs can work with either TSC or HPET time sources,
 depending on what is requested by an application call to ``rte_eal_hpet_init()``,
 if any, and on what is available on the system at runtime.
-
-Using Linux IOMMU Pass-Through to Run DPDK with Intel® VT-d
------------------------------------------------------------
-
-To enable Intel® VT-d in a Linux kernel, a number of kernel configuration options must be set. These include:
-
-*   ``IOMMU_SUPPORT``
-
-*   ``IOMMU_API``
-
-*   ``INTEL_IOMMU``
-
-In addition, to run the DPDK with Intel® VT-d, the ``iommu=pt`` kernel parameter must be used when using ``igb_uio`` driver.
-This results in pass-through of the DMAR (DMA Remapping) lookup in the host.
-Also, if ``INTEL_IOMMU_DEFAULT_ON`` is not set in the kernel, the ``intel_iommu=on`` kernel parameter must be used too.
-This ensures that the Intel IOMMU is being initialized as expected.
-
-Please note that while using ``iommu=pt`` is compulsory for ``igb_uio`` driver,
-the ``vfio-pci`` driver can actually work with both ``iommu=pt`` and ``iommu=on``.
index 2dd711bb37c2568abbefcbf40e63a3b5489cca2d..006a9df83ec70b13b817340293bc2bd45cf4c6f9 100644 (file)
@@ -182,7 +182,7 @@ It can be loaded as shown below:
 
 .. note::
 
-   If the devices used for DPDK are bound to the ``uio_pci_generic`` kernel module,
+   If the devices used for DPDK are bound to a UIO-based kernel module,
    please make sure that the IOMMU is disabled or is in passthrough mode.
    One can add ``intel_iommu=off`` or ``amd_iommu=off`` or ``intel_iommu=on iommu=pt``
    in GRUB command line on x86_64 systems,