|WARNING| pw108645-108652 [PATCH] [v2, 8/8] doc/linux_gsg: remove section on IOMMU pass-through

|WARNING| pw108645-108652 [PATCH] [v2, 8/8] doc/linux_gsg: remove section on IOMMU pass-through

[dpdklab]

[-- Attachment #1: Type: text/plain, Size: 6298 bytes --]

Test-Label: iol-testing
Test-Status: WARNING
http://dpdk.org/patch/108645

_apply patch failure_

Submitter: Bruce Richardson <bruce.richardson@intel.com>
Date: Thursday, March 10 2022 12:38:43 
Applied on: CommitID:312b94ef884f0cf4ee42dde36acf23a41172794d
Apply patch set 108645-108652 failed:

Checking patch doc/guides/linux_gsg/sys_reqs.rst...
error: while searching for:

This chapter describes the packages required to compile the DPDK.

.. note::

    If the DPDK is being used on an Intel\ |reg| Communications Chipset 89xx Series platform,
    please consult the *Intel\ |reg| Communications Chipset 89xx Series Software for Linux Getting Started Guide*.

BIOS Setting Prerequisite on x86
--------------------------------


error: patch failed: doc/guides/linux_gsg/sys_reqs.rst:8
Applying patch doc/guides/linux_gsg/sys_reqs.rst with 1 reject...
Rejected hunk #1.
diff a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst	(rejected hunks)
@@ -8,11 +8,6 @@ System Requirements
 
 This chapter describes the packages required to compile the DPDK.
 
-.. note::
-
-    If the DPDK is being used on an Intel\ |reg| Communications Chipset 89xx Series platform,
-    please consult the *Intel\ |reg| Communications Chipset 89xx Series Software for Linux Getting Started Guide*.
-
 BIOS Setting Prerequisite on x86
 --------------------------------
 
Checking patch doc/guides/linux_gsg/enable_func.rst...
error: while searching for:
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.

Loading the DPDK KNI Kernel Module
----------------------------------

To run the DPDK Kernel NIC Interface (KNI) sample application, an extra kernel module (the kni module) must be loaded into the running kernel.
The module is found in the kernel/linux sub-directory of the DPDK build directory.
It should be loaded using the insmod command::

   insmod <build_dir>/kernel/linux/kni/rte_kni.ko

.. note::

   See the "Kernel NIC Interface Sample Application" chapter in the *DPDK Sample Applications User Guide* for more details.

Using Linux IOMMU Pass-Through to Run DPDK with Intel\ |reg| VT-d
------------------------------------------------------------------


error: patch failed: doc/guides/linux_gsg/enable_func.rst:128
Applying patch doc/guides/linux_gsg/enable_func.rst with 1 reject...
Rejected hunk #1.
diff a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst	(rejected hunks)
@@ -128,19 +128,6 @@ 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.
 
-Loading the DPDK KNI Kernel Module
-----------------------------------
-
-To run the DPDK Kernel NIC Interface (KNI) sample application, an extra kernel module (the kni module) must be loaded into the running kernel.
-The module is found in the kernel/linux sub-directory of the DPDK build directory.
-It should be loaded using the insmod command::
-
-   insmod <build_dir>/kernel/linux/kni/rte_kni.ko
-
-.. note::
-
-   See the "Kernel NIC Interface Sample Application" chapter in the *DPDK Sample Applications User Guide* for more details.
-
 Using Linux IOMMU Pass-Through to Run DPDK with Intel\ |reg| VT-d
 ------------------------------------------------------------------
 
Checking patch doc/guides/linux_gsg/enable_func.rst...
error: while searching for:
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\ |reg| VT-d
------------------------------------------------------------------

To enable Intel\ |reg| 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\ |reg| 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``.

error: patch failed: doc/guides/linux_gsg/enable_func.rst:127
Checking patch doc/guides/linux_gsg/linux_drivers.rst...
Hunk #1 succeeded at 182 (offset -185 lines).
Applying patch doc/guides/linux_gsg/enable_func.rst with 1 reject...
Rejected hunk #1.
Applied patch doc/guides/linux_gsg/linux_drivers.rst cleanly.
diff a/doc/guides/linux_gsg/enable_func.rst b/doc/guides/linux_gsg/enable_func.rst	(rejected hunks)
@@ -127,22 +127,3 @@ it is recommended that the ``rte_get_timer_cycles()`` and ``rte_get_timer_hz()``
 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\ |reg| VT-d
-------------------------------------------------------------------
-
-To enable Intel\ |reg| 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\ |reg| 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``.

https://lab.dpdk.org/results/dashboard/patchsets/21461/

UNH-IOL DPDK Community Lab