path: root/doc
diff options
authorEric Zhang <>2018-10-03 16:53:13 -0400
committerThomas Monjalon <>2018-10-29 00:01:05 +0100
commit075b182b54ce90e0a22810e67cf3204e22673bac (patch)
tree09d5ed1de0bbeff8aae236a1e64c53fd4586344b /doc
parent783667c9f90ba3f242fb946c4aefcdaba26ca96a (diff)
eal: force IOVA to a particular mode
This patch uses EAL option "--iova-mode" to force the IOVA mode to a particular value. There exists virtual devices that are not directly attached to the PCI bus, and therefore the auto detection of the IOVA mode based on probing the PCI bus and IOMMU configuration may not report the required addressing mode. Using the EAL option permits the mode to be explicitly configured in this scenario. Signed-off-by: Eric Zhang <> Acked-by: Hemant Agrawal <> Acked-by: Anatoly Burakov <> Reviewed-by: Marko Kovacevic <>
Diffstat (limited to 'doc')
2 files changed, 12 insertions, 0 deletions
diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/prog_guide/env_abstraction_layer.rst
index 00ce64c..4f8612a 100644
--- a/doc/guides/prog_guide/env_abstraction_layer.rst
+++ b/doc/guides/prog_guide/env_abstraction_layer.rst
@@ -358,6 +358,14 @@ Misc Functions
Locks and atomic operations are per-architecture (i686 and x86_64).
+IOVA Mode Configuration
+Auto detection of the IOVA mode, based on probing the bus and IOMMU configuration, may not report
+the desired addressing mode when virtual devices that are not directly attached to the bus are present.
+To facilitate forcing the IOVA mode to a specific value the EAL command line option ``--iova-mode`` can
+be used to select either physical addressing('pa') or virtual addressing('va').
Memory Segments and Memory Zones (memzone)
diff --git a/doc/guides/testpmd_app_ug/run_app.rst b/doc/guides/testpmd_app_ug/run_app.rst
index 851df65..c79fd0d 100644
--- a/doc/guides/testpmd_app_ug/run_app.rst
+++ b/doc/guides/testpmd_app_ug/run_app.rst
@@ -133,6 +133,10 @@ See the DPDK Getting Started Guides for more information on these options.
Use malloc instead of hugetlbfs.
+* ``--iova-mode <pa|va>``
+ Force IOVA mode to a specific value.
Testpmd Command-line Options